Auth0 Logs to Papertrail

The Auth0 Logs to Papertrail is a scheduled job that takes all of your Auth0 logs and exports them to Papertrail.

Configuring the Extension

To install and configure this extension, click on the Auth0 Logs to Papertrail box in the list of provided extensions on the Extensions page of the Management Portal. The Install Extension window pops open.

At this point you should set the following configuration variables:

  • Schedule: The frequency with which logs should be exported. The schedule can be customized even further after creation.
  • BATCH_SIZE: The number of logs per batch (up to a maximum of 100). Note that logs are batched before sending, with multiple batches sent each time the extension runs.
  • PAPERTRAIL_HOST: The destination hostname for your logs.
  • PAPERTRAIL_PORT: The destination port for your logs.
  • PAPERTRAIL_SYSTEM: The destination system for your logs.
  • LOG_LEVEL: The minimal log level of events that you would like sent to Papertrail;
  • LOG_TYPES: The events for which logs should be exported.

Once you have provided this information, click the Install button to finish installing the extension.

Batch size

When setting your BATCH_SIZE, please keep the following information in mind.

During each time frame/window (defined by your chosen Schedule), outstanding logs will be batched into groups and sent to Papertrail. The size of each group is determined by the BATCH_SIZE value.

In other words, during each window, NUM_BATCHES batches of logs will be sent to Papertrail, based on the following logic:

In the ELSE case, the last batch will have < 100 logs.

Retrieve the required information from Papertrail

To configure a new system for Auth0 logs and acquire the PAPERTRAIL_HOST and PAPERTRAIL_PORT information, follow the next steps:

  1. Login to Papertrail and navigate to your Dashboard.
  2. Click the Add Systems button.

  1. Your log destination is created! Copy the URL and Port information displayed with the message Your systems & apps will log to. These map respectively to the PAPERTRAIL_HOST and PAPERTRAIL_PORT variables.

If you already have a system you want to use, follow the next steps:

  1. Login to Papertrail and navigate to your Settings > Log Destinations.
  2. Locate the system you want to use and copy the URL and Port information. These map respectively to the PAPERTRAIL_HOST and PAPERTRAIL_PORT variables.

Using Your Installed Extension

To view all scheduled jobs, navigate to the Extensions page of the Management Portal, click on the Installed Extensions link, and select the Auth0 Logs to Papertrail line. There you can see the job you just created, modify its state by toggling the State switch, see when the next run is due and what was the result of the last execution.

You can view more details by clicking on the job you created. In this page, you can view details for each execution, reschedule, access realtime logs, and more.

That's it, you are done! You can now navigate to Papertrail and view your Auth0 Logs, by selecting the configured system.

You may have noticed that we didn't set a value for PAPERTRAIL_SYSTEM. This variable, when not set by the user, takes the default value of auth0-logs. As you can see in the previous screenshot, this is how our system will be displayed in the Papertrail dashboard.