Log streaming: LogDNA

      Last updated June 01, 2020

    Fastly's Real-Time Log Streaming feature can be configured to send logs in a format that is readable by LogDNA. LogDNA is a cloud-based log management system that aggregates system and application logs into a single location.

    Prerequisites

    Before adding LogDNA as a logging endpoint for Fastly services, you'll need to perform the following steps:

    Adding LogDNA as a logging endpoint

    1. Review the information in our Setting Up Remote Log Streaming guide.
    2. Click the LogDNA (via Syslog ) Create endpoint button. The Create a Syslog endpoint page appears.

      the create a Syslog endpoint page

    3. Fill out the Create a Syslog 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 Syslog address field, type syslog-a.logdna.com in the domain field before the colon, and in the port field after the colon type the LogDNA port number you noted during your LogDNA account setup.
      • From the TLS menu, select Yes to enable encryption for the syslog endpoint. The TLS Hostname and TLS CA Certificate fields will both appear.
      • In the TLS Hostname field, type syslog-a.logdna.com. This is the hostname Fastly will use to verify the syslog server's certificate.
    4. Click the Advanced options link of the Create a Syslog endpoint page and decide which of the optional fields to change, if any.

      the advanced options on the create a new Syslog endpoint page

    5. Fill out the Advanced options of the Create a Syslog endpoint page as follows:
      • In the Select a log line format area, select the log line format for your log messages. Our guide on changing log line formats provides more information.
      • 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.

    Logs should begin appearing in your LogDNA account a few seconds after you've created the endpoint and deployed your service.

    Back to Top