Skip to content

[DOCS-10679] Add blog and use cases to Reference Tables #30161

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions content/en/reference_tables/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,9 @@ further_reading:
- link: 'https://www.datadoghq.com/blog/add-context-with-reference-tables/'
tag: 'Blog'
text: 'Add more context to your logs with Reference Tables'
- link: 'https://www.datadoghq.com/blog/reference-tables/'
tag: 'Blog'
text: 'Enrich your existing Datadog telemetry with custom metadata using Reference Tables'
- link: 'https://www.datadoghq.com/blog/add-context-with-reference-tables-in-cloud-siem/'
tag: 'Blog'
text: 'Add more context to Cloud SIEM detections and investigations with Datadog Reference Tables'
Expand All @@ -28,6 +31,12 @@ Reference Tables allow you to combine custom metadata with information already i

{{< img src="reference_tables/reference-table.png" alt="A reference table with data populated in the columns for org id, org name, parent org, account owner, and csm" style="width:100%;">}}

For example, you can:

- **Enrich logs and security data for faster investigations:** Correlate logs, traces, and security events with up-to-date business context—such as customer names, account owners, threat intelligence, or error code descriptions—to accelerate troubleshooting and analysis.
- **Segment users and resources for targeted analytics and cost management:** Group users, customers, or cloud resources into meaningful segments (like user tiers, teams, or business units) for deeper product analytics and precise cost attribution using tools like Tag Pipelines.
- **Enhance data for advanced querying and reporting:** Join external data from Reference Tables in Sheets, DDSQL Editor, or Log Workspaces to perform complex queries, aggregations, and build custom reports without technical expertise.

## Validation rules

Reference Table names and column headers are validated using the following naming conventions and automatically updated or normalized, if necessary.
Expand Down
Loading