How to Mirror the WordPress Activity Log to Papertrail

You are here:
Back

Papertrail is a cloud-based logs management system to which you can export any type of logs and activity logs. The idea is to have all the logs and information centralized in one place. This document explains how to integrate the WP Security Audit Log plugin with Papertrail to mirror (export) the activity logs of WordPress sites to it.

The process consists of two steps:

  1. Setting up a Papertrail connection in the plugin
  2. Configuring the mirroring of the activity logs to Papertrail

Setting Up a Papertrail Connection for the Activity Log

To setup a Papertrail connection in the plugin:

  1. Click on DB/Archive/Mirror node in the plugin menu.
  2. Click the Create a Connection button to launch the connection setup wizard.
  3. Select Papertrail from the Type of Connection drop down menu in the first step of the wizard.

Configuring the Papertrail connection settings

  1. In the second step of the wizard specify:
    1. Specify the log destination in the Destination placeholder. You can find your Papertrail Destination in the Log Destinations section of your Papertrail account. It should have the following format: logs4.papertrailapp.com:54321
    2. Enable or disable colorization. When enabled different colours are used for different sections of the logs for better readability.
  2. In the last step of the wizard, specify a name for the connection. Connection names are just reference for you and can be up to 25 characters long and can only consist of letters, numbers and underscores.

Configuring the Mirroring of the WordPress Audit Log to Papertrail

Once the Papertrail connection is setup you have to configure it as a mirroring connection as per the below procedure:

  1. Click on DB/Archive/Mirror in the plugin menu.
  2. Navigate to the Mirroring tab and click the Setup an Activity Log Mirror button.
  3. In the first step of the wizard specify a name for the mirror. Names are just for your reference and can be 25 characters long, and only consist of letters, numbers and underscores.
  4. Select the Papertrail connection you’ve just setup from the Connection drop down menu.
  5. In the second step of the wizard specify how often the activity log mirroring process should run.
  6. In the last step of the wizard you can configure activity log filtering rules for the mirroring connection. By default the connection is set to  Send all events option, though if you’d like to setup any filtering rules refer to configuring filtering rules for activity log mirroring connections.
  7. Click Save mirror to save the new mirroring process.
  8. Other Integrations

    Refer to the getting started guide for external databases & third party services for more information on other integrations and activity log management.