> For the complete documentation index, see [llms.txt](https://docs.getlimy.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getlimy.ai/limy-pixel/cdn-integration/akamai.md).

# Akamai

This guide walks through configuring **Akamai DataStream 2** to forward CDN access logs to **Limy Agent Analytics.**

***

### Prerequisites

Before you begin, make sure you have:

* Access to **Akamai Control Center** with permission to create and activate DataStream configurations.
* Access to **Property Manager** for the property (CDN configuration) whose traffic you want to log.

***

### 1. Open DataStream

1. Sign in to **Akamai Control Center**.
2. From the hamburger menu (**☰**), go to **COMMON SERVICES > DataStream** to open the streams dashboard.

### 2. Create a new stream

1. Click **Create stream**.
2. Choose the log type **Delivery (CDN) products** — this captures CDN access logs.

### 3. Choose the source

Select the **property / CDN configuration** whose traffic you want to stream. This is the source of the access logs that will be delivered to Limy.

### 4. Select the data set fields

On the **Data Sets** step, select **all** of the following fields. These are mandatory for the Limy integration. The JSON key column is the field name as it appears in each delivered log record.

\*Is mandatory

<table><thead><tr><th>Field</th><th>JSON key</th><th data-hidden>#</th></tr></thead><tbody><tr><td>Request time *</td><td><code>reqTimeSec</code></td><td>1</td></tr><tr><td>Request ID *</td><td><code>reqId</code></td><td>2</td></tr><tr><td>Client IP *</td><td><code>cliIP</code></td><td>4</td></tr><tr><td>HTTP status code *</td><td><code>statusCode</code></td><td>5</td></tr><tr><td>Request method *</td><td><code>reqMethod</code></td><td>6</td></tr><tr><td>Request path *</td><td><code>reqPath</code></td><td>7</td></tr><tr><td>Request host *</td><td><code>reqHost</code></td><td>9</td></tr><tr><td>User-Agent *</td><td><code>UA</code></td><td>11</td></tr><tr><td>Total bytes *</td><td><code>totalBytes</code></td><td>12</td></tr><tr><td>Response Content-Length *</td><td><code>rspContentLen</code></td><td>13</td></tr><tr><td>Response Content-Type *</td><td><code>rspContentType</code></td><td>14</td></tr><tr><td>Accept-Language</td><td><code>accLang</code></td><td>15</td></tr><tr><td>Cookie</td><td><code>cookie</code></td><td>16</td></tr><tr><td>Range</td><td><code>range</code></td><td>17</td></tr><tr><td>Referer</td><td><code>referer</code></td><td>18</td></tr><tr><td>X-Forwarded-For</td><td><code>xForwardedFor</code></td><td>19</td></tr><tr><td>Max age</td><td><code>maxAgeSec</code></td><td>20</td></tr><tr><td>Request end time</td><td><code>reqEndTimeMSec</code></td><td>21</td></tr><tr><td>Turn around time</td><td><code>turnAroundTimeMSec</code></td><td>22</td></tr><tr><td>Transfer time</td><td><code>transferTimeMSec</code></td><td>23</td></tr><tr><td>Country/Region</td><td><code>country</code></td><td>24</td></tr><tr><td>City</td><td><code>city</code></td><td>25</td></tr><tr><td>State</td><td><code>state</code></td><td>26</td></tr><tr><td>Bytes</td><td><code>bytes</code></td><td></td></tr><tr><td>Request port</td><td><code>reqPort</code></td><td></td></tr><tr><td>Protocol type</td><td><code>proto</code></td><td></td></tr></tbody></table>

### 5. Set the log format

Set **Log format** to **JSON**.

### 6. Configure the destination

On the **Destination** tab:

1. **Destination:** select **Custom HTTPS**.
2. **Name:** enter a human-readable label (e.g. `Limy Agent Analytics`).
3. **Endpoint URL:** `https://stream.getlimy.ai/`
4. **Authentication:** select **Basic**.
   1. In username, enter the org name (for example: YourCompanyName)
   2. In password, enter your Limy Key (lmy\_\*\*\*\*\*\*\*\*\*). The key can be found in Agent Monitor page in your Limy Dashboard.
5. **Do not - Compress data:** **leave button unchecked** — do **not** compress data.
6. Click **Validate & Save**.

### 7. Review and activate the stream

1. Review the configuration on the summary step.
2. Click **Activate** to deploy the stream.

### 8. Enable the DataStream behavior in Property Manager

A stream only collects data once the **DataStream behavior** is enabled on the property:

1. Go to **☰ > CDN > Properties** and open your property.
2. Open the configuration **Version** you want to edit.
3. Click **Edit New Version**
4. In the default rule, under Log Delivery, Scroll to **Behaviors**
5. Turn on Log User-Agent Header. (And Referrer Header)
6. **Save**, then activate the property version on the **production** network.

***

### Verify the integration

* After activation, allow up to **\~120 minutes** for logs to begin arriving in Limy Dashboard.
* Confirm data is appearing in the Limy Agent Analytics dashboard.
* If nothing arrives, check that the stream is **active**, the **DataStream behavior is enabled** on the property, and the property version is **active on production**.

{% hint style="info" %}
**Note:** Akamai may rename fields, relabel buttons, or rearrange this flow over time. If the exact wording or screen layout differs from this guide, the underlying logic is unchanged — create a stream, select the data set fields, set the format to JSON, point it at the Limy custom HTTPS endpoint without compression, and enable the DataStream behavior on your property.
{% endhint %}