Articles in this section

See more

Log streaming: Heroku's Logplex

  • Updated

As part of our Real-Time Log Streaming feature, if you use our Heroku add-on, you can send log files directly to Heroku's Logplex system. Logplex is Heroku's distributed syslog router that collates and distributes log entries from a variety of sources into a single channel.

Prerequisites

Before continuing, you will need the token from your Heroku Logplex account. If you don't have a Heroku Logplex account, now is the time to set one up by signing up for Heroku.

Once enabled, your Fastly logs will be available in exactly the same way as your regular app and hosted service logs. You can view them using the Heroku command line log viewer or send them to a logging add-on.

Adding Heroku Logplex as a logging endpoint

Follow these instructions to add Heroku Logplex as a logging endpoint for Fastly services:

  1. Review the information in our Setting Up Remote Log Streaming guide.

  2. Click the Heroku Logplex Create endpoint button. The Create a Heroku Logplex endpoint page appears.

    the create a Heroku Logplex page

  3. Fill out the Create a Heroku Logplex endpoint fields as follows:
    • In the Name field, enter a human-readable name for the endpoint.
    • In the Log format field, optionally enter an Apache-style string or VCL variables to use for log formatting. The Apache Common Log format string appears in this field by default. Our discussion of format strings provides more information.
    • In the Token field, type your Heroku Logplex token.
    • In the URL field, type https://1.us.logplex.io/logs unless otherwise instructed by our support staff.

  4. Click the Advanced options link of the Create a Heroku Logplex endpoint page. The Advanced options appear.

    the advanced options on the create a new Heroku Logplex endpoint page

  5. In the Placement area, select where the logging call should be placed in the generated VCL. Valid values are Format Version Default, None, and waf_debug (waf_debug_log). Selecting None creates a logging object that can only be used in custom VCL. See our guide on WAF logging for more information about waf_debug_log.
  6. Click the Create button to create the new logging endpoint.
  7. Click the Activate button to deploy your configuration changes.

Related articles