Add Custom Metadata to Logs with Enrichment Tables

Add Custom Metadata to Logs with Enrichment Tables

The Enrichment Tables feature is currently in public beta. There are no billing implications for defining and querying enrichment tables. For more information, contact Datadog support. During the beta, there is a limit of 100 enrichment tables per account.


Define new entities in Datadog like customer details, service names and information, or IP addresses by uploading a CSV file containing a table of information. This is represented by a primary key in an Enrichment Table and the associated metadata. This data can be applied as tags to logs at ingest time in the Lookup Processor.

Create an enrichment table

Click New Enrichment Table +, then upload a CSV file, name the appropriate columns, and define the primary key for lookups.

Note: The manual CSV upload method supports files up to 5MB.

Enrichment tables can automatically pull a CSV file from an AWS S3 bucket to keep your data up to date. The integration looks for changes to the CSV file in S3, and when the file is updated it replaces the enrichment table with the new data. This also enables API updating with the S3 API once the initial enrichment table is configured.

To update enrichment tables from S3, Datadog uses the IAM role in your AWS account that you configured for the AWS integration. If you have not yet created that role, follow these steps to do so. To allow that role to update your enrichment tables, add the following permission statement to its IAM policies. Be sure to edit the bucket names to match your environment.

	"Statement": [
			"Sid": "EnrichmentTablesS3",
			"Effect": "Allow",
			"Action": [
			"Resource": [
	"Version": "2012-10-17"

Define the table

Click New Enrichment Table +, then add a name, select AWS S3, fill out all fields, click import, and define the primary key for lookups.

Note: The upload from an S3 bucket method supports files up to 200MB.

This enrichment table can now be used to add additional attributes to logs with the Lookup Processor.

Modify an enrichment table

To modify an existing enrichment table with new data, select a table then click Update Data + in the top right corner. The selected CSV is upserted into the table, meaning that:

  • All existing rows with the same primary key are updated
  • All new rows are added
  • All old rows that are not in the new file are deleted

Once the table is saved, the upserted rows are processed asynchronously and updated in the preview. It may take up to 10 minutes for the update to complete.

Further Reading