Hear from Slack, the ACLU, TED, & more at our customer summit in San Francisco Register
LOG IN SIGN UP
Documentation

Log streaming: Logentries

  Last updated May 18, 2017

Fastly's Real-Time Log Streaming feature can send log files to Logentries. Logentries is a real-time log management and analytics system that you can use to monitor your Fastly logs.

One-click Logentries account setup

Fastly has partnered with Logentries to offer you a method for automatically creating a Logentries account and configuring a logging endpoint. By using the Logentries one-click integration, you can create a 30 day trial Logentries account with unlimited data. After 30 days, if you don't upgrade to one of the Logentries premium plans, your account will be capped at 5GB per month.

Follow these instructions to create a Logentries logging endpoint and configure the logging endpoint:

  1. Log in to the Fastly web interface and click the Configure link.
  2. From the service menu, select the appropriate service.
  3. Click the Configuration button and then select Clone active. The service version page appears.
  4. Click the Logging link. The Logging endpoints page appears. If you have an existing logging endpoint, click the Create endpoint button.

    the Logentries One-click account set up box

  5. In the One-click account setup box, click the Plan details and account setup link. The Create Logentries Account window appears.
  6. Click the Create Logentries Account button.
  7. Click the Activate button to deploy your configuration changes.

Accessing your Logentries account

If you created a Logentries account using the one-click integration, you must access your Logentries account from the Fastly web application. Follow these instructions to log in to Logentries:

  1. Log in to the Fastly web interface and click the Configure link.
  2. From the service menu, select the appropriate service.
  3. Click the Configuration button and then select Clone active. The service version page appears.
  4. Click the Logging link. The Logging endpoints page appears.

    the Logentries dashboard link

  5. Click the Logentries dashboard link to access your Logentries account dashboard.

Manually adding Logentries as a logging endpoint

If you already have a Logentries account, or if you'd prefer to sign up for a Logentries account on the Logentries website, you can manually add Logentries as a logging endpoint in the Fastly web interface.

Prerequisites

  1. Register for a Logentries account.
  2. Create a new log in the Logentries application by following the instructions on the Logentries website
  3. During new log creation, select Manual Configuration and Token TCP.
  4. Make a note of the token provided in the Logentries configuration panel. We recommend you use this token when you create the Logentries logging endpoint for Fastly services.

Creating the logging endpoint in the web interface

After you've created a new log in Logentries and found the token, follow these instructions to add Logentries as a logging endpoint for Fastly services:

  1. Review the information in our Setting Up Remote Log Streaming guide.
  2. Click the Logentries logo. The Create a Logentries endpoint page appears.

    the create a Logentries page

  3. Fill out the Create a Logentries endpoint fields as follows:
    • In the Name field, type a human-readable name for the endpoint.
    • In the Log format field, optionally type 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 also provides more information.
    • In the Token field, type the token provided in the Logentries configuration panel. Though you can use the provided secret port number, there are additional options to consider when deciding on token settings.
  4. Click the Advanced options link.

    the advanced options on the create a Logentries endpoint page

  5. Fill out the Advanced options as follows:
    • In the Port field, type 20000. Though we recommend this specific setting when adding your endpoint, there are additional options to consider when deciding on the port and TLS settings.
    • From the TLS menu, optionally select Yes.
  6. Click the Create button to create the new logging endpoint.
  7. Click the Activate button to deploy your configuration changes.

Additional selections for tokens, ports, and TLS

Using your token. You can add a Logentries endpoint by using your secret account token. To use your token, set your port to 10000. However, we strongly recommend sending your logs via TLS. To do this, set TLS to Yes and the port number to 20000. See the Logentries guide Token TCP for more information.

Using your port number. You can add a Logentries endpoint by using your secret Logentries port number (e.g., 56789). However, we strongly recommend sending your logs via TLS. To do this, set TLS to Yes and add 10000 to your secret port number (e.g., 66789). See the Logentries guide Plain TCP/UDP for more information.

Next steps

Logentries maintains the Fastly Community Pack that leverages custom VCL to provide advanced User-Agent statistics, regional statistics, error tracking, and more.


Additional resources:


Back to Top