Skip to content

Commit 482ff08

Browse files
authored
Update Metrics Mappings (#29812)
* Small edits. * Add new diagram and edit content on page. * Remove image and request for feedback.
1 parent d65ef46 commit 482ff08

File tree

2 files changed

+8
-9
lines changed

2 files changed

+8
-9
lines changed

content/en/opentelemetry/mapping/metrics_mapping.md

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -15,23 +15,21 @@ disable_sidebar: true
1515

1616
## Overview
1717

18-
Datadog products and visualizations are built on metrics and tags that adhere to specific naming patterns. Metrics from OpenTelemetry components that are sent to Datadog are mapped to corresponding Datadog metrics, as applicable. The creation of these additional metrics does not affect Datadog billing.
19-
20-
The following diagram shows the process of mapping the metrics from OpenTelemetry into metrics that Datadog uses:
21-
22-
{{< img src="opentelemetry/guide/metrics_mapping/otel-mapping-metrics.png" alt="The decision process for mapping OpenTelemetry metric names to Datadog metric names. If an OTel metric is not used by any Datadog product, or if its semantics are the same as Datadog's, it is sent as-is to Datadog. Otherwise, a Datadog-style metric is created from the OTel metric and sent to Datadog." style="width:100%;" >}}
18+
Datadog products and visualizations are built on metrics and tags that follow specific naming patterns. Therefore, Datadog maps incoming OpenTelemetry metrics to the appropriate Datadog metric format. This mapping process may create additional metrics, but these do not affect Datadog billing.
2319

2420
<div class="alert alert-info"><strong>Want to unify OpenTelemetry and Datadog metrics in your queries?</strong> Learn how to <a href="/metrics/open_telemetry/query_metrics">query across Datadog and OpenTelemetry metrics</a> from the Metrics Query Editor.</div>
2521

26-
## Use of the `otel` prefix
22+
## How OpenTelemetry metrics appear in Datadog
2723

28-
To differentiate the metrics captured by the `hostmetrics` receiver from Datadog Agent, we add a prefix, `otel`, for metrics collected by the collector. If a metric name starts with `system.` or `process.`, `otel.` is prepended to the metric name. Monitoring the same infrastructure artifact using both Agent and Collector is not recommended.
24+
To differentiate metrics from the OpenTelemetry Collector's [hostmetrics][12] receiver and the Datadog Agent, Datadog prepends `otel.` to any received metric that starts with `system.` or `process.`. Datadog does not recommend monitoring the same infrastructure with both the Datadog Agent and the OpenTelemetry Collector
2925

30-
<div class="alert alert-info">Datadog is evaluating ways to improve the OTLP metric experience, including potentially deprecating this <code>otel</code> prefix. If you have feedback related to this, reach out your account team to provide your input.</div>
26+
<div class="alert alert-info">Datadog is evaluating ways to improve the OTLP metric experience, including potentially deprecating this <code>otel</code> prefix.</div>
3127

3228
## Metrics mappings
3329

34-
Metrics mappings between Datadog and OpenTelemetry are defined on [OTel integration][11] pages. Select the integration you are using for more information.
30+
The following table shows the metric mappings for various integrations. Use the search and filter controls to find the mappings for a specific integration.
31+
32+
For more information, see [OpenTelemetetry integrations][11].
3533

3634
{{< multifilter-search resource="_data/semantic-core/unified_semantic_core.json">}}
3735

@@ -50,4 +48,5 @@ Metrics mappings between Datadog and OpenTelemetry are defined on [OTel integrat
5048
[9]: /opentelemetry/otel_collector_datadog_exporter/?tab=onahost#containers-overview-dashboard
5149
[10]: /tracing/trace_explorer/trace_view/
5250
[11]: /opentelemetry/integrations/
51+
[12]: /opentelemetry/integrations/host_metrics/
5352

Loading

0 commit comments

Comments
 (0)