DataStream
The DataStream reporting service provides real-time logs on application activity, including aggregated metrics on complete request and response cycles, as well as origin response times.
How it works
Apply this behavior to report on this set of traffic. Use the DataStream API to aggregate the data.
Requirements and usage details for this behavior are maintained in the DataStream documentation.
If you want to send data in multiple streams, and you have multiple instances of the DataStream behavior in your configuration's rule tree, make sure you add all these streams in every instance of this behavior for your property. Incoming requests can hit only one instance of the DataStream behavior at once, and if that instance is missing the streams in question, they will not send data. See Property Configuration logic.
Example:
You chose the Stream1
stream as the default stream, and Stream2
and Stream3
as secondary streams with different destinations. Choose Stream1
, Stream2
, and Stream3
for each instance of the DataStream behavior in your property configuration to send logs to all of them. When you choose Stream1
in one behavior, and Stream2
with Stream3
in another behavior in the rule tree, Stream1
may not send data if the request hits the other behavior.
On April 4, 2023, the
logStreamName
parameter in the JSON payload for this behavior changed from a single integer value (e. g.1234
) to an array of string values (e. g.[“1234”, “5678”]
).If you use the Property Manager API, make sure your property accepts single-value payload for your previous rule format, or use the latest rule format and the new payload to prevent errors. Click View JSON payload above the DataStream behavior details in Property Manager to check the latest payload.
Features and options
Field | What it does | Sub-options |
---|---|---|
Stream version | Selects the DataStream version to associate with the property. DataStream 2 is the only version currently available (see Sub-options). | Choose DataStream 2 for scalable, low latency streaming of raw data for push delivery. NOTE: DataStream 1 is now deprecated. You might be able to choose DataStream 1 or DataStream 1 and DataStream 2 from the dropdown list for the time being, but selecting other options than DataStream 2 will result in an error. |
Enable | Enables or disables log collection for this property. | |
Stream names | Limits the scope of reported data to a specified set of one or more streams. By default, all active streams you choose here report data. Available when Stream version is set to DataStream 2. | |
Sampling rate | Specifies the sampling rate to collect logs for this property for all streams configured. This setting overrides the sampling rate configured in the DataStream configuration. Available when Stream version is set to DataStream 2. | |
Collect midgress traffic | If enabled, gathers midgress traffic data from within the Akamai platform, such as between two edge servers, for all streams configured. |
Updated about 1 year ago