Guide
TrainingSupportCommunity

Stream logs to New Relic

Suggest Edits

DataStream 2 supports sending log files to New Relic for improved log analytics. It uploads logs as compressed JSON files by default.

You can use the New Relic quickstart wizard to comfortably integrate DataStream 2 with the New Relic storage. The integration comes in with a handy dashboard, where you can arrange the data that you want to monitor into interactive visualizations, and configure alerts for key performance metrics. See Akamai DataStream 2 in New Relic.

See this video to get to know how to integrate DataStream 2 with New Relic and use the dashboard:

The custom header feature allows you to enter the name and value for the header that you want to use in New Relic for improved tagging. See the Introduction to cross application traces in the New Relic documentation for details.

Before you begin

Before configuring your stream to send logs to this destination, make sure you create and store a Log API token in New Relic. See New Relic API keys in the New Relic documentation.

How to

  1. In Display name, enter a human-readable name description for the destination.

  2. In Endpoint, enter a New Relic endpoint URL you want to send your logs to. The endpoint URL should follow the https://<newrelic.com>/log/v1/ format. See Introduction to the Log API if you want to retrieve your New Relic endpoint URL.

  3. In Auth token, enter your Log API token you created earlier for your account in New Relic.

  4. Click Validate & Save to validate the connection to the destination and save the details you provided.

Additional options

  1. Optionally, go to Custom header and provide the details of the custom header for the log file:

    • In Content type, set the content type to pass in the log file header. application/json is the only supported content type at this time.
    • If your destination accepts only requests with certain headers, enter the Custom header name and Custom header value. The custom header name can contain the alphanumeric, dash, and underscore characters.

  2. Optionally, change the Push frequency to receive bundled logs to your destination every 30 or 60 seconds.

  3. Click Validate & Save to validate the connection to the destination and save the details you provided.

Akamaized hostname as endpoint

This destination supports using Akamaized hostnames as endpoints to send DataStream 2 logs for improved security. When you create a property with a New Relic endpoint URL as hostname, this property acts as a proxy between the destination and DataStream. As a result, you can filter incoming traffic to your destination endpoint by IP addresses using the Origin IP Access List behavior. That means only IP addresses that belong to your Akamaized property hostname can send logs to your custom destination. Using Akamaized hostnames as endpoints also requires enabling the Allow POST behavior in your property.

Once the property hostname works as a destination endpoint, you cannot monitor it as a property in this or another stream. If you already monitor a property in DataStream, you cannot use it as a destination endpoint.

To enable this feature:

  1. Go to Property Manager and create a new property. We recommend choosing API Acceleration as the product. See Create a brand new property.

  2. Set your New Relic endpoint URL as the property hostname. See Redirect users to edge servers.

  3. Go to ☰ > CDN > Properties or just enter Properties in the search box.

    The Property Groups page opens.

  4. Click the Property Name link to go to the property you created.

  5. Activate the property on the production network. Only properties active on the production network can serve as DataStream destinations. See Activate property on production.

  6. On the Property Details page, click the Version of your configuration that you want to access in Manage Versions and Activations.

    The Property Manager Editor appears.

  7. In the default rule, click Add Behavior, and select Origin IP Access List. Click Insert Behavior.

    The Origin IP Access List behavior appears in the default rule.

  8. Set the Enable slider in the Origin IP Access Control List behavior to On. Click Save.

  9. Click Add behavior, and select Allow POST.

  10. Click Insert Behavior.

    The Allow POST behavior appears in the default rule.

  11. Set the Behavior option in the Allow POST behavior to Allow.

  12. Click Save.

📘

Tip

You may need to additionally configure your property to ensure uninterrupted data flow. See Configuration best practices in the Property Manager guide for other behaviors you can configure in your property.

  1. Configure the firewall settings at your destination endpoint to allow access for IP addresses that belong to CIDR blocks for your Akamaized hostname. See the Origin IP Access List behavior for the list of IP addresses to put on the allow list.

After successfully configuring an Akamaized hostname as the destination endpoint, avoid editing an active property’s setup in Property Manager to ensure uninterrupted data flow. Adding, deleting, and editing hostnames and behaviors may cause unexpected behavior in the DataStream application.

We recommend setting up alerts that send e-mail notifications every time DataStream logs cannot be uploaded to your destination, so you can immediately troubleshoot issues with your property or destination configuration. See Set up alerts.

Updated about 1 year ago