Akamai DataStream
Security Monitoring is now available Security Monitoring is now available

Akamai DataStream

Crawler Crawler

Overview

Connect Datadog with Akamai DataStream to see your CDN health, latency, offload, and error metrics.

Setup

Installation

Install the integration with the Datadog Akamai integration tile.

Configuration

Metric collection

First, add an Akamai account:

  1. In the Luna Control Center, go to Configure > Organization > Manage APIs and create a new client with at least “READ-ONLY” access to the “DataStream” API.
  2. Select the newly created API in the “Users and API Clients” list. Under “Credentials”, create a new Client token. Copy the given information to the Datadog Akamai integration tile. Press “Update Configuration”.

Add the list of streams to monitor:

  1. On DataStream (available under Configure > Performance Analytics > DataStream), select a stream with ‘Aggregated metrics’ configured, and copy the ID to the stream list section of the Akamai integration tile.

You can set multiple accounts (or hosts), but make sure to link each stream to an account.

Only streams with the 'Aggregated metrics' type are supported.

Log collection

Akamai DataStream 1.0 and 2.0 support sending logs to Datadog over HTTP(s) endpoints in a gzip compressed file. To stream logs to Datadog, fill out these fields within Akamai:

  1. Name: enter a human readable description for the endpoint.

  2. Endpoint: enter the Datadog endpoint for sending and storing logs: https://http-intake.logs.datadoghq.com/v1/input.

  3. Tags (optional): enter a comma-delimited list of tags, which can be used to filter and group your logs in Datadog.

  4. Source: enter the source name as akamai.

  5. Service (optional): enter the name of the application or service generating the log events associated with your Datadog account.

  6. API key: enter your Datadog API key.

  7. Send compressed data (optional): select this checkbox to gzip compress the logs sent to the destination.

  8. Validate & Save: click this to validate the connection to the destination and save the details you provided.

Data Collected

Metrics

akamai.requests_per_second
(rate)
Requests per second
Shown as request
akamai.response_time.edge
(gauge)
Edge response time
Shown as millisecond
akamai.response_time.origin
(gauge)
Origin response time
Shown as millisecond
akamai.bytes_per_second
(rate)
Bandwidth
Shown as byte
akamai.cache.hits
(count)
Cache hits
Shown as request
akamai.cache.miss
(count)
Cache misses
Shown as request
akamai.status.2xx
(count)
Requests with HTTP 2xx code (Success)
Shown as request
akamai.status.3xx
(count)
Requests with HTTP 3xx code (Redirection)
Shown as request
akamai.status.4xx
(count)
Requests with HTTP 4xx code (Client error)
Shown as request
akamai.status.5xx
(count)
Requests with HTTP 5xx code (Server error)
Shown as request
akamai.offload_rate
(gauge)
Offload rate
Shown as fraction

Events

The Akamai integration does not include any events.

Service Checks

The Akamai integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.