Logs

Overview

Don’t see the Logs menu entry, or the option to Enable Logging? It’s new to Page Generator Pro 2.6.1 and higher.  Ensure that your license is valid, not expired and that you’ve updated to the latest version of the Plugin.

Page Generator Pro can log the result of each Page and Term Generation.

Most of the time you won’t need to enable or use these Logs – however, they’re useful as confirmation that Page Generator Pro generated Pages / Terms, or if you require a log of generated Pages / Terms in CSV format, for use in a third party analytics or reporting tool.

Enable Logging

By default, Page Generator Pro’s logging is disabled.  To enable it:

  • In your WordPress Administration interface, navigate to Page Generator Pro > Settings
    Page Generator Pro: Settings Menu
  • Click the Generate tab.
    Page Generator Pro: Settings: Generate
  • Set Enable Logging = Yes
  • Click Save

View Logs

To view the Logs, click on Page Generator Pro > Logs in the WordPress Administration interface:
Page Generator Pro: Logs: Menu

A table will be displayed, showing all generation activity, ordered newest to oldest:
Page Generator Pro: Logs Table

Understanding Log Entries

Each log entry comprises of the following information:

Column Description
Group The Group ID and Name.  Clicking this will filter the Logs to only show results for this Group.
Generated Item The URL of the generated Page or Term.
System
  • browser: Generate via Browser was used for this generated item
  • cli: Generate via CLI was used for this generated item
Test Mode Whether generation took place in Test Mode
Generated
  • Yes: An item was either created or updated/overwritten
  • No: An item was not generated/was skipped

This will depend on the settings defined in the Content Group.

Keywords/Terms A list of the Keywords detected in the Content Group, and the Term(s) used as their replacements for this generated item.
Result
  • success: The generation request completed successfully
  • error: An error occurred when attempting to generate this item or Group
Message Refer to the Understanding the Result Log section below.
Duration (Seconds) How long, in seconds, Page Generator Pro took to generate this item.  Refer to the Performance Documentation to understand this number in more detail.
Memory Usage (MB) The amount of memory the server used to generate this item.

Understanding the Result Log

When using Generate via Browser, Generate via WP-CLI or reviewing the Logs section of Page Generator Pro, each generated item returns a message detailing what action was performed.  This message will depend on the Overwrite setting used on a Content Group:

Result Description Overwrite Setting that may produce this Message
Created [Permalink] A new Page has been created at the given Permalink. (any)
Created, as [Post Type] with Permalink has not yet been generated by this Group [Permalink] A new Page has been created, as no existing Page generated by this Group was found for the given Permalink.
  • Yes, if existing Page generated by this Group
  • Yes, if existing Page generated by this Group, preserving original Publish date
Updated, as [Post Type] with Permalink already generated by this Group [Permalink] An existing Page has been updated, as an existing Page generated by this Group was found for the given Permalink.
  • Yes, if existing Page generated by this Group
  • Yes, if existing Page generated by this Group, preserving original Publish date
Created, as [Post Type] with Permalink does not exist in WordPress [Permalink] A new Page has been created, as no existing Page was found for the given Permalink.
  • Yes, if existing Page exists
  • Yes, if existing Page exists, preserving original Publish date
Updated, as [Post Type] with Permalink already exists in WordPress [Permalink] An existing Page has been updated, as an existing Page was found for the given Permalink.
  • Yes, if existing Page exists
  • Yes, if existing Page exists, preserving original Publish date
Skipped, as [Post Type] with Permalink already generated by this Group [Permalink] Generation of this Page has been skipped, as an existing Page generated by this Group was found for the given Permalink. No, skip if existing Page generated by this Group
Updated, as [Post Type] with Permalink already exists in WordPress [Permalink] Generation of this Page has been skipped, as an existing Page was found for the given Permalink. No, skip if existing Page exists

If a blocking error occurred, its message will be displayed in this field.

Viewing Group-specific Logs

To view logs for a specific Group, either:

  • Select the Group from the Filter by Groups dropdown:
    Page Generator Pro: Logs: Group Filter
  • Enter the Group ID or partial Group Title in the search box, and click the Search button:
    Page Generator Pro: Logs: Search

A table will be displayed, showing Log Entries matching the Group ID or partial Group Title

Filtering Logs

Logs can be filtered by:

  • Group
  • System
  • Result
  • Generated At Date Range

To filter the logs, click on the relevant filter above the table, selecting the applicable value:
Page Generator Pro: Logs: Filters

Click the Apply button to see the filtered logs.

Define Table Columns to Display

By default, all Log Entries’ attributes are displayed on screen:
Page Generator Pro: Logs: Table Columns

You can adjust which columns of data to display by:

  • Clicking the Screen Options tab at the top right of the screen:
    Page Generator Pro: Keywords: Screen Options
  • Check or uncheck the relevant columns to display/hide:
    Page Generator Pro: Logs: Table Column Options
  • Click the Apply button
This setting is stored on a per-User basis, and therefore only affects the current logged in User.   

Define Number of Logs per Page

By default, up to 20 Log Entries are displayed on screen before pagination is then output, allowing you to paginate through your Logs:
Page Generator Pro: Keywords: Pagination

You can adjust the number of Log Entries per Page by:

  • Clicking the Screen Options tab at the top right of the screen:
    Page Generator Pro: Keywords: Screen Options
  • Enter the number of Log Entries to display per Page:
    Page Generator Pro: Logs: Entries per Page
  • Click the Apply button
This setting is stored on a per-User basis, and therefore only affects the current logged in User.   

Exporting Logs

To export all log entries on screen to a CSV file:

  • Define any Filters that you want to apply to the log entries above.
  • Click the Export Log button to export the filtered results to a CSV file.
All log entries matching any Filters are exported.  Table Column, pagination and page offset preferences are ignored.

Page Generator Pro: Logs: Export to CSV

Delete Log Entries

To delete one or more log entries:

  • Click the checkbox beside each log entry in the table:
    Page Generator Pro: Logs: Checkbox
  • Under Bulk Actions, select Delete:
    WordPress to Buffer Pro: Bulk Actions: Delete
  • Click the Apply button
Deleting Log Entries is irreversible.  Only do so if you do not need the Log Entries for further debugging.

Clear Log

To delete all log entries:

  • Click the Clear Log button
    Page Generator Pro: Logs: Clear Log Button
  • Confirm that you want to clear all Log Entries
    Page Generator Pro: Logs: Clear Log Confirmation
Clearing the Log will delete ALL Log Entries, and is irreversible.  Only do so if you do not need the Log Entries for further debugging.