diff --git a/content/en/logs/guide/send-aws-services-logs-with-the-datadog-kinesis-firehose-destination.md b/content/en/logs/guide/send-aws-services-logs-with-the-datadog-kinesis-firehose-destination.md index f61f37aeb11..388978124f2 100644 --- a/content/en/logs/guide/send-aws-services-logs-with-the-datadog-kinesis-firehose-destination.md +++ b/content/en/logs/guide/send-aws-services-logs-with-the-datadog-kinesis-firehose-destination.md @@ -155,6 +155,46 @@ To populate all logs by ARN: **Note**: A single Kinesis payload must not be more than 65,000 log messages. Log messages after that limit are dropped. +## Set the source, service, and tags + +When logs arrive through Amazon Data Firehose, Datadog automatically determines the `source`, `service`, and tags for each log based on AWS metadata: + +1. **Source**: Detected from the CloudWatch log group name. For example, `/aws/lambda/my-function` sets `source:lambda`, and `/aws/rds/...` sets `source:rds`. If the log group does not match a known AWS service pattern, the log group name itself is used as the source. +2. **Service**: Defaults to the same value as the detected source. For Lambda logs, the service is set to the function name. +3. **Tags**: AWS metadata such as `region`, `aws_account`, and `sourcecategory:aws` are added automatically. + +### Overriding source, service, and tags + +There are two ways to override these auto-detected values: + +#### Firehose common attributes + +You can set `source`, `service`, and arbitrary tags through the **Parameters** section (Common Attributes) of your Amazon Data Firehose delivery stream configuration. These values apply to all logs flowing through that delivery stream and take priority over the auto-detected values. + +For example, setting `source: nodejs` and `env: production` in the Common Attributes adds those as the log source and as a tag, respectively. + +#### Reserved attributes in the log body + +
ddsource, service, ddtags) from the log body is not enabled by default. To enable it for your organization, contact Datadog Support.