> ## 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.

# Akamai

> Deliver Akamai access logs to Profound through Amazon S3.

## Overview

Send Akamai access logs to your assigned Profound S3 destination to see agent traffic in Agent Analytics. This guide covers CDN request logs delivered through DataStream 2.

<Info>
  Contact [Profound support](mailto:support@tryprofound.com) to confirm availability and arrange your destination settings and credentials before configuring delivery.
</Info>

For delivery over HTTP, use the [Akamai HTTPS integration](/agent-analytics/akamai).

## Prerequisites

* An Akamai account with DataStream 2 enabled.
* Permission to create and activate streams for your properties.
* Access to Property Manager to configure request header logging and any required DataStream behavior.

## Encryption

This guide uses **SSE-S3 (AES256)** to encrypt your logs at rest with keys managed by Amazon S3. Profound configures encryption on your destination.

## Configuration

<Steps>
  <Step title="Arrange your destination">
    Share the domains you want to monitor with Profound support. Support will confirm source readiness and coordinate delivery of your bucket name, folder path, region, and AWS credentials.

    Keep the secret access key in your credential manager and enter it directly into Akamai. Avoid including it in support messages or screenshots.
  </Step>

  <Step title="Create a stream">
    In Akamai Control Center, open **Analytics & monitor > DataStream** and select **Create stream**. Choose CDN delivery logs, enter a descriptive name, and select the properties that serve your domains.
  </Step>

  <Step title="Select log fields">
    Select **JSON** as the log format. Profound processes one JSON object per line with the following fields:

    | Field                  | Used for             |
    | ---------------------- | -------------------- |
    | `reqTimeSec`           | Request time         |
    | `cliIP`                | Client address       |
    | `reqHost`              | Requested domain     |
    | `reqMethod`, `reqPath` | Requested resource   |
    | `statusCode`           | Response status      |
    | `UA`                   | Agent identification |

    Include `queryStr`, `referer`, and `totalBytes` for query strings, referral information, and response size.

    In Property Manager, enable logging for the Host, User-Agent, and Referer headers so the selected fields contain request values. See Akamai's [data set parameters](https://techdocs.akamai.com/datastream2/docs/data-set-parameters) for the corresponding settings.
  </Step>

  <Step title="Configure the S3 destination">
    Select **S3** on the **Destination** tab and enter:

    | Setting           | Value                                        |
    | ----------------- | -------------------------------------------- |
    | Name              | A descriptive name                           |
    | Bucket            | The bucket supplied by Profound              |
    | Folder path       | The folder path supplied by Profound         |
    | Region            | `us-west-2` (Oregon)                         |
    | Access key ID     | The AWS access key ID arranged with Profound |
    | Secret access key | The matching AWS secret access key           |

    Select **Validate & Save** to check access. Akamai writes a verification file to the destination during validation.

    DataStream 2 delivers gzip-compressed files to S3. Keep the default log filenames; Profound expects compressed filenames to end in `.gz`.

    See Akamai's [Amazon S3 destination guide](https://techdocs.akamai.com/datastream2/docs/stream-amazon-s3) for details.
  </Step>

  <Step title="Activate delivery">
    After Profound confirms readiness, review and activate your stream. Set sampling to **100%** to capture all matching requests.

    For Property Manager-dependent streams, enable the **DataStream** behavior, select your DataStream 2 stream, and activate the property version. DataStream-managed streams use the stream configuration directly.

    Follow Akamai's [activation steps](https://techdocs.akamai.com/datastream2/docs/quick-start) for your integration type. Activation can take up to an hour.
  </Step>
</Steps>

## Verify ingestion

Generate traffic to your configured domain. Once delivery and processing have completed, open Agent Analytics and select a date range covering those requests to check for expected agent traffic.

If data is missing, share your domain, stream ID, request time, and any delivery error with Profound support.

## Troubleshooting

| Problem                                | What to check                                                                                                                       |
| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Destination validation fails           | Compare the bucket, folder path, region, and credentials with your assigned settings. Ask support to check destination permissions. |
| No logs arrive                         | Confirm the stream and any required property version are active and receiving traffic.                                              |
| Files arrive but data is missing       | Check the JSON field selection, request header logging, and your selected date range.                                               |
| Access fails after a credential change | Update the destination with the replacement credentials and validate again.                                                         |

## Additional Resources

* [Akamai: Stream logs to Amazon S3](https://techdocs.akamai.com/datastream2/docs/stream-amazon-s3)
* [Akamai: DataStream 2 quick start](https://techdocs.akamai.com/datastream2/docs/quick-start)
* [Akamai: Log format](https://techdocs.akamai.com/datastream2/docs/log-format)
* [Akamai HTTPS integration](/agent-analytics/akamai)
* [Contact Profound support](mailto:support@tryprofound.com)