Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt

Use this file to discover all available pages before exploring further.

Overview

The integration uses Akamai Datastream2 to forward your CDN logs to our Agent Analytics API. Akamai Datastream2 is a service that enables reliable delivery of streaming data to various destinations including HTTP endpoints. For more information about Akamai Datastream2, visit the Akamai documentation.

Prerequisites

  • An Akamai account with Datastream2 add-on
  • Access to your Akamai Datastream2 configuration
  • API credentials for the Profound Agent Analytics platform

Configuration

Akamai Detected
1

Step 1

Sign in to Akamai Control Center and navigate to DataStream in the left sidebar. Click Create a streamDataStream create stream Navigation
2

Step 2

Select your property and click NextDataStream property selection
3

Step 3

Select the following options in each section:Log Informationlog informationMessage Exchange Datamessage dataRequest Header Datarequest header dataNetwork Datanetwork dataLog Formatlog formatRead more about these fields in the Akamai documentation
4

Step 4

Add authentication information:
  • From the Destination dropdown, select Custom HTTPS.
  • Select BASIC as the Authentication type.
  • Enter https://artemis.api.tryprofound.com/v1/logs/akamai as the URL.
  • Enter your organization name in the Username field.
  • Enter your API key in the Password field.
  • Check Send compressed data. authentication
5

Step 5

Select JSON as the Log format.output format
6

Step 6

Choose 30 seconds as the push frequency.push frequency
7

Step 7

Review the configuration. It should look like the following:Review configurationWhen ready, click Save stream.
DataStream2 takes approximately 60 minutes to start sending logs.Please wait for 60 minutes before checking for logs.
8

Step 8

After creating the stream, you will now be instructed to activate the stream.activate streamClick Proceed to Property Manager and select the property you created the stream for.
9

Step 9

Click Edit a new version to add the stream to the property.Navigate to the Property Configuration Settings. Select Standard property behavior from the + Behavior dropdown.add behaviorSearch for DataStream and click Insert Behaviordatastream behavior
The behavior will show DataStream 1. Ignore this as you will select version 2 later.
10

Step 10

Scroll down to the DataStream section and select:
  • DataStream2 from the Stream Version dropdown.
  • Toggle Enable to On.
  • Select the stream you created in the Stream Name.
  • Select a sample rate. 100% is recommended. datastream settings
11

Step 11

Select Log Delivery from the left sidebar.Enable:
  • Log Host Header
  • Log Referer Header
  • Log User-Agent Header
Leave the other settings as their default values.log delivery settings
12

Step 12

Save the configuration and activate the new version.
That’s it! Akamai will now send real-time logs to Profound. Data should begin appearing in your dashboard within 60 minutes of activating the stream.

Troubleshooting

  • Ensure your stream is activated, connected to the property, and that the property has been updated
  • Ensure your API credentials are correct

Additional Resources

Security Considerations

  • Regularly rotate your API credentials
  • Monitor your log drain usage for unusual patterns or unexpected traffic spikes