Getting started with Datadog search #32109

estherk15 · 2025-10-09T19:47:11Z

What does this PR do? What is the motivation?

Add a primer on datadog search with a list of syntax references
DOCS-7837

Merge instructions

Merge readiness:

Ready for merge

github-actions · 2025-10-09T19:50:56Z

Preview links (active after the `build_preview` check completes)

New or renamed files

Modified Files

https://docs-staging.datadoghq.com/esther/docs-7837-getting-started-search/getting_started/

content/en/getting_started/search/_index.md

euzuro

👋 It's great to see this added to the docs! I saw this PR because I was tagged on the related JIRA ticket... I took the liberty to leave a few comments, feel free to ignore me 😄

euzuro · 2025-10-10T09:52:05Z

content/en/getting_started/search/_index.md

+
+### Metric-Based Queries
+
+Metric-based queries are designed to retrieve and analyze numerical time series data. They rely on tags and attributes to filter metrics and often combine functions and arithmetic operations to calculate and visualize trends over time (for example, average latency, error rate, or cost over time).


❓ Do we say "attributes" for metrics filters? I would have written only tags here, but I am not a metrics expert.

Suggested change

Metric-based queries are designed to retrieve and analyze numerical time series data. They rely on tags and attributes to filter metrics and often combine functions and arithmetic operations to calculate and visualize trends over time (for example, average latency, error rate, or cost over time).

Metric-based queries are designed to retrieve and analyze numerical time series data. They rely on tags to filter metrics and often combine functions and arithmetic operations to calculate and visualize trends over time (for example, average latency, error rate, or cost over time).

content/en/getting_started/search/product_specific_reference.md

Co-authored-by: Erik Uzureau <[email protected]>

rtrieu

Found a few minor things to update. Other than that, this seems like essential reading that will be a great addition to our docs. Great work!

rtrieu · 2025-10-10T17:13:43Z

content/en/getting_started/search/_index.md

+
+See the index of [Product-Specific Search][1].
+
+## Further Reading


Suggested change

## Further Reading

## Further reading

rtrieu · 2025-10-10T17:14:10Z

content/en/getting_started/search/_index.md

+## Understanding Datadog search
+
+Datadog provides a unified way to query data across products using text-based search syntax. All data in Datadog can be explored and filtered through queries, but the syntax and behavior differ depending on the type of data you're working with. There are two primary query formats in Datadog:
+- **Metric-based queries**: used in Metrics and Cloud Cost Management (CCM).


Suggested change

- **Metric-based queries**: used in Metrics and Cloud Cost Management (CCM).

- **Metric-based queries**: Used in Metrics and Cloud Cost Management (CCM).

rtrieu · 2025-10-10T17:14:15Z

content/en/getting_started/search/_index.md

+
+Datadog provides a unified way to query data across products using text-based search syntax. All data in Datadog can be explored and filtered through queries, but the syntax and behavior differ depending on the type of data you're working with. There are two primary query formats in Datadog:
+- **Metric-based queries**: used in Metrics and Cloud Cost Management (CCM).
+- **Event-based queries**: used across most other products, including Logs, APM, RUM, Events, and Security.


Suggested change

- **Event-based queries**: used across most other products, including Logs, APM, RUM, Events, and Security.

- **Event-based queries**: Used across most other products, including Logs, APM, RUM, Events, and Security.

rtrieu · 2025-10-10T17:15:29Z

content/en/getting_started/search/product_specific_reference.md

+
+## Additional product-specific resources
+
+{{< whatsnext desc="Product-specific search syntax documentation for additional Datadog products:" >}}


I would recommend adding your new "Getting Started with Search" page as a further reading to each of these pages

rtrieu · 2025-10-10T17:15:36Z

content/en/getting_started/search/product_specific_reference.md

+  {{< nextlink href="/tests/explorer/search_syntax" >}}Test Optimization Explorer Search Syntax: Search and analyze test execution data{{< /nextlink >}}
+{{< /whatsnext >}}
+
+## Further Reading


Suggested change

## Further Reading

## Further reading

rtrieu · 2025-10-10T17:19:21Z

content/en/getting_started/search/product_specific_reference.md

+
+For more information, see [Advanced Filtering][1].
+
+### Key capabilties


Suggested change

### Key capabilties

### Key capabilities

rtrieu · 2025-10-10T17:19:50Z

content/en/getting_started/search/product_specific_reference.md

+
+To learn more about querying spans and traces with service, resource, and tag filters, see [Trace Query Syntax][3].
+
+### Key capabilites


Suggested change

### Key capabilites

### Key capabilities

rtrieu · 2025-10-10T17:20:31Z

content/en/getting_started/search/_index.md

+
+Each Datadog product provides its own search syntax, tailored to the type of data it handles. The Product-Specific Search reference highlights the key capabilities and unique operators available in each product, such as log search facets, APM trace filters, or metric aggregation functions. These references help you understand where syntax differs across Datadog products.
+
+See the index of [Product-Specific Search][1].


Suggested change

See the index of [Product-Specific Search][1].

Learn more in [Product-Specific Search][1].

estherk15 added 4 commits October 9, 2025 14:19

Add new getting started for search docs

66aa054

Edit the landing page

b526762

Add to left nav

334d32b

Final edits, add syntax examples

936a4b3

estherk15 requested a review from a team as a code owner October 9, 2025 19:47

github-actions bot added the Architecture Everything related to the Doc backend label Oct 9, 2025

estherk15 commented Oct 9, 2025

View reviewed changes

content/en/getting_started/search/_index.md Outdated Show resolved Hide resolved

Update content/en/getting_started/search/_index.md

be36086

estherk15 added the editorial review Waiting on a more in-depth review label Oct 9, 2025

Add to getting started index

0b2569f

euzuro reviewed Oct 10, 2025

View reviewed changes

Update log example

6b97aa4

Co-authored-by: Erik Uzureau <[email protected]>

rtrieu approved these changes Oct 10, 2025

View reviewed changes


		### Metric-Based Queries

		Metric-based queries are designed to retrieve and analyze numerical time series data. They rely on tags and attributes to filter metrics and often combine functions and arithmetic operations to calculate and visualize trends over time (for example, average latency, error rate, or cost over time).


		See the index of [Product-Specific Search][1].

		## Further Reading

	- Metric-based queries: used in Metrics and Cloud Cost Management (CCM).
	- Metric-based queries: Used in Metrics and Cloud Cost Management (CCM).

	- Event-based queries: used across most other products, including Logs, APM, RUM, Events, and Security.
	- Event-based queries: Used across most other products, including Logs, APM, RUM, Events, and Security.


		## Additional product-specific resources

		{{< whatsnext desc="Product-specific search syntax documentation for additional Datadog products:" >}}


		For more information, see [Advanced Filtering][1].

		### Key capabilties


		To learn more about querying spans and traces with service, resource, and tag filters, see [Trace Query Syntax][3].

		### Key capabilites


		Each Datadog product provides its own search syntax, tailored to the type of data it handles. The Product-Specific Search reference highlights the key capabilities and unique operators available in each product, such as log search facets, APM trace filters, or metric aggregation functions. These references help you understand where syntax differs across Datadog products.

		See the index of [Product-Specific Search][1].

	See the index of [Product-Specific Search][1].
	Learn more in [Product-Specific Search][1].

Getting started with Datadog search #32109

Are you sure you want to change the base?

Getting started with Datadog search #32109

Uh oh!

Conversation

estherk15 commented Oct 9, 2025 • edited by atlassian bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What does this PR do? What is the motivation?

Merge instructions

Uh oh!

github-actions bot commented Oct 9, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Preview links (active after the build_preview check completes)

New or renamed files

Modified Files

Uh oh!

Uh oh!

euzuro left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

rtrieu left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

estherk15 commented Oct 9, 2025 •

edited by atlassian bot

Loading

github-actions bot commented Oct 9, 2025 •

edited

Loading

Preview links (active after the `build_preview` check completes)