From c37a6aa1ed3fade4b974be442a96845c0cff0b31 Mon Sep 17 00:00:00 2001 From: Brett Blue <84536271+brett0000FF@users.noreply.github.com> Date: Mon, 28 Oct 2024 09:56:41 -0600 Subject: [PATCH] Link between service overrides and inferred services. Remove duplicate content. (#25745) --- .../tracing/guide/inferred-service-opt-in.md | 35 +++++-------------- content/en/tracing/guide/service_overrides.md | 4 +-- 2 files changed, 11 insertions(+), 28 deletions(-) diff --git a/content/en/tracing/guide/inferred-service-opt-in.md b/content/en/tracing/guide/inferred-service-opt-in.md index 9654db2050680..d9fb10f900c60 100644 --- a/content/en/tracing/guide/inferred-service-opt-in.md +++ b/content/en/tracing/guide/inferred-service-opt-in.md @@ -13,10 +13,13 @@ further_reading: - link: "/tracing/trace_collection/dd_libraries/" tag: "Documentation" text: "Add the Datadog Tracing Library" +- link: "/tracing/guide/service_overrides" + tag: "Documentation" + text: "Service Overrides" --- -{{< callout url="https://docs.google.com/forms/d/1imGm-4SfOPjwAr6fwgMgQe88mp4Y-n_zV0K3DcNW4UA/edit" d_target="#signupModal" btn_hidden="true" btn_hidden="false" header="Opt in to the private beta!" >}} -Inferred service dependencies are in private beta. To request access, complete the form. +{{< callout url="https://docs.google.com/forms/d/1imGm-4SfOPjwAr6fwgMgQe88mp4Y-n_zV0K3DcNW4UA/edit" d_target="#signupModal" btn_hidden="true" btn_hidden="false" header="Request access to the Preview!" >}} +Inferred service dependencies are in Preview. To request access, complete the form. {{< /callout >}} ## Overview @@ -262,32 +265,11 @@ To opt in, add the following environment variables to your tracer settings or sy ### Global default service naming migration -When you enable the `DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED` environment variable, it improves how service-to-service connections and inferred services are represented in Datadog visualizations, across all supported tracing library languages and integrations. - -Previously, some tracing libraries included the name of the associated integration in service name tagging. For example, .NET tagged gRPC calls as `service:-grpc-client` while Python tagged them as `service:grpc-client`. With this option enabled, all supported tracing libraries tag spans from the downstream services with the calling service's name, `service:`, thereby providing a _global default service name_. - -_ | Before | After ---|-------|-------- -Service name | `service:my-service-grpc-client` or `service:grpc-client` | `service:myservice` -additional `peer.*` attributes | _No `peer.*` tags set_ | `@peer.service:otherservice` (`otherservice` being the name of the remote service being called with gRPC) - -Similarly, for a span representing a call to a mySQL database: - -_ | Before | After ---|-------|-------- -Service name | `service:my-service-mysql` or `service:mysql` | `service:myservice` -additional `peer.*` attributes | _No `peer.*` tags set_ | `@peer.db.name:user-db`, `@peer.db.system:mysql` - -Consequently, if you have existing: +With inferred services, service names are automatically detected from span attributes. When you enable the `DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED` environment variable, it improves how service-to-service connections and inferred services are represented in Datadog visualizations, across all supported tracing library languages and integrations. -- APM metrics -- APM custom span metrics -- Trace analytics -- Retention filters -- Sensitive data scans -- Monitors, dashboards, or notebooks +
Enabling this option may impact existing APM metrics, custom span metrics, trace analytics, retention filters, sensitive data scans, monitors, dashboards, or notebooks that reference the old service names. Update these assets to use the global default service tag (service:<DD_SERVICE>).
-And these target similar service names, update those items to use the global default service tag (`service:`) instead. +For instructions on how to remove service overrides and migrate to inferred services, see the [Service Overrides guide][10]. ## Further reading @@ -300,3 +282,4 @@ And these target similar service names, update those items to use the global def [7]: https://github.com/open-telemetry/opentelemetry-collector-contrib/releases [8]: https://github.com/DataDog/helm-charts/blob/main/charts/datadog/values.yaml#L517-L538 [9]: https://github.com/DataDog/datadog-agent/releases/tag/7.55.1 +[10]: /tracing/guide/service_overrides diff --git a/content/en/tracing/guide/service_overrides.md b/content/en/tracing/guide/service_overrides.md index 350e688753f99..d248853053d02 100644 --- a/content/en/tracing/guide/service_overrides.md +++ b/content/en/tracing/guide/service_overrides.md @@ -14,7 +14,7 @@ Inferred service dependencies are in Preview. To request access, complete the fo ## Overview -Inferred services improve how Datadog represents service dependencies. This document explains the changes and how to adapt your configuration. +[Inferred services][1] improve how Datadog represents service dependencies. This document explains the changes and how to adapt your configuration. ### Before inferred services @@ -136,7 +136,7 @@ Similarly, for a span representing a call to a mySQL database: ## Glossary ##### Service override -A service name set for a span which differs from the default `DD_SERVICE` name. It can be set [automatically]((#integration-service-overrides)) by some Datadog integrations, or [manually]((#custom-service-overrides)) by users. +A service name set for a span which differs from the default `DD_SERVICE` name. It can be set [automatically](#integration-service-overrides) by some Datadog integrations, or [manually](#custom-service-overrides) by users. ##### Base service The default `DD_SERVICE` name.