From b56413d680f2ec35b13c7abe090f2a1b54d0bb70 Mon Sep 17 00:00:00 2001 From: Siddhitha Bhoopathy <51140686+SiddhithaBhoopathy@users.noreply.github.com> Date: Mon, 20 Jan 2025 22:50:31 +0000 Subject: [PATCH] Changing the env var DD_TRACE_SAMPLE_RATE to DD_TRACE_SAMPLING_RULES (#27197) Co-authored-by: <=> --- content/en/serverless/aws_lambda/configuration.md | 10 ++++++---- content/es/serverless/aws_lambda/configuration.md | 12 +++++++----- content/fr/serverless/aws_lambda/configuration.md | 4 ++-- content/ja/serverless/aws_lambda/configuration.md | 4 ++-- content/ko/serverless/aws_lambda/configuration.md | 4 ++-- 5 files changed, 19 insertions(+), 15 deletions(-) diff --git a/content/en/serverless/aws_lambda/configuration.md b/content/en/serverless/aws_lambda/configuration.md index 3a34d8e2c637d..3db3023ce22fe 100644 --- a/content/en/serverless/aws_lambda/configuration.md +++ b/content/en/serverless/aws_lambda/configuration.md @@ -46,7 +46,7 @@ First, [install][1] Datadog Serverless Monitoring to begin collecting metrics, t ## Enable Threat Detection to observe attack attempts -Get alerted on attackers targeting your serverless applications and respond quickly. +Get alerted on attackers targeting your serverless applications and respond quickly. To get started, first ensure that you have [tracing enabled][43] for your functions. @@ -350,7 +350,9 @@ To see what libraries and frameworks are automatically instrumented by the Datad ## Select sampling rates for ingesting APM spans -To manage the [APM traced invocation sampling rate][17] for serverless functions, set the `DD_TRACE_SAMPLE_RATE` environment variable on the function to a value between 0.000 (no tracing of Lambda function invocations) and 1.000 (trace all Lambda function invocations). +To manage the [APM traced invocation sampling rate][17] for serverless functions, set the `DD_TRACE_SAMPLING_RULES` environment variable on the function to a value between 0.000 (no tracing of Lambda function invocations) and 1.000 (trace all Lambda function invocations). + +**Note**: The use of `DD_TRACE_SAMPLE_RATE` is deprecated. Use `DD_TRACE_SAMPLING_RULES` instead. For instance, if you already set `DD_TRACE_SAMPLE_RATE` to `0.1`, set `DD_TRACE_SAMPLING_RULES` to `[{"sample_rate":0.1}]` instead. Metrics are calculated based on 100% of the application's traffic, and remain accurate regardless of any sampling configuration. @@ -370,7 +372,7 @@ To scrub trace attributes for data security, see [Configure the Datadog Agent or ## Enable/disable trace collection -Trace collection through the Datadog Lambda extension is enabled by default. +Trace collection through the Datadog Lambda extension is enabled by default. If you want to start collecting traces from your Lambda functions, apply the configurations below: @@ -501,7 +503,7 @@ If you are using a runtime or custom logger that isn't supported, follow these s ## Link errors to your source code -[Datadog source code integration][26] allows you to link your telemetry (such as stack traces) to the source code of your Lambda functions in your Git repositories. +[Datadog source code integration][26] allows you to link your telemetry (such as stack traces) to the source code of your Lambda functions in your Git repositories. For instructions on setting up the source code integration on your serverless applications, see the [Embed Git information in your build artifacts section][101]. diff --git a/content/es/serverless/aws_lambda/configuration.md b/content/es/serverless/aws_lambda/configuration.md index 01c997468d91b..35ca529247189 100644 --- a/content/es/serverless/aws_lambda/configuration.md +++ b/content/es/serverless/aws_lambda/configuration.md @@ -46,7 +46,7 @@ Primero, [instala][1] Datadog Serverless Monitoring para comenzar a recopilar m ## Habilitar la detección de amenazas para observar los intentos de ataque -Recibe alertas sobre atacantes que tengan como objetivo tus aplicaciones serverless y responde con rapidez. +Recibe alertas sobre atacantes que tengan como objetivo tus aplicaciones serverless y responde con rapidez. Para empezar, asegúrate de tener el [rastreo habilitado][43] para tus funciones. @@ -350,7 +350,9 @@ Para ver qué bibliotecas y marcos instrumenta de forma automática el cliente d ## Seleccionar las frecuencias de muestreo para la ingesta de tramos de APM -Para gestionar la [frecuencia de muestreo de las invocaciones rastreadas de APM][17] para las funciones serverless, define la variable de entorno `DD_TRACE_SAMPLE_RATE` en una función con un valor entre 0,000 (no se rastrea ninguna invocación de la función de Lambda) y 1,000 (se rastrean todas las invocaciones). +Para gestionar la [frecuencia de muestreo de las invocaciones rastreadas de APM][17] para las funciones serverless, define la variable de entorno `DD_TRACE_SAMPLING_RULES` en una función con un valor entre 0,000 (no se rastrea ninguna invocación de la función de Lambda) y 1,000 (se rastrean todas las invocaciones). + +Nota: El uso de DD_TRACE_SAMPLE_RATE está obsoleto. Utiliza DD_TRACE_SAMPLING_RULES en su lugar. Por ejemplo, si ya has establecido DD_TRACE_SAMPLE_RATE en 0.1, estableceDD_TRACE_SAMPLING_RULES en [{"sample_rate":0.1}] en su lugar. Las métricas se calculan en función del 100 % del tráfico de la aplicación, y son precisas independientemente de la configuración del muestreo. @@ -370,7 +372,7 @@ Para borrar atributos de trazas por razones de seguridad de los datos, consulta ## Habilitar y deshabilitar la recopilación de trazas -La recopilación de trazas a través de la Datadog Lambda Extension está habilitada de forma predeterminada. +La recopilación de trazas a través de la Datadog Lambda Extension está habilitada de forma predeterminada. Si quieres empezar a recopilar las trazas de tus funciones de Lambda, aplica las configuraciones que se indican a continuación: @@ -501,7 +503,7 @@ Si usas un tiempo de ejecución o un logger personalizado no compatible, sigue e ## Vincular errores al código fuente -La [integración del código fuente de Datadog][26] te permite vincular tu telemetría (como stack traces) al código fuente de tus funciones de Lambda en los repositorios de Git. +La [integración del código fuente de Datadog][26] te permite vincular tu telemetría (como stack traces) al código fuente de tus funciones de Lambda en los repositorios de Git. Para obtener instrucciones sobre cómo configurar la integración del código fuente en tus aplicaciones serverless, consulta la [sección Integrar información de Git en los artefactos de compilación][101]. @@ -741,4 +743,4 @@ Si tienes problemas para configurar tus instalaciones, define la variable de ent [45]: https://docs.datadoghq.com/es/tracing/trace_collection/library_config/ [46]: https://docs.datadoghq.com/es/tracing/glossary/#services [47]: /es/logs/ -[48]: /es/tracing/trace_collection/otel_instrumentation/ \ No newline at end of file +[48]: /es/tracing/trace_collection/otel_instrumentation/ diff --git a/content/fr/serverless/aws_lambda/configuration.md b/content/fr/serverless/aws_lambda/configuration.md index c684eac8609e8..17c74ab8a64bd 100644 --- a/content/fr/serverless/aws_lambda/configuration.md +++ b/content/fr/serverless/aws_lambda/configuration.md @@ -401,7 +401,7 @@ Pour découvrir quelles bibliothèques et quels frameworks sont automatiquement ## Choisir les taux d'échantillonnage pour l'ingestion des spans APM -Pour gérer le [taux d'échantillonnage des invocations tracées par APM][17] pour des fonctions sans serveur, définissez la variable d'environnement `DD_TRACE_SAMPLE_RATE` de la fonction sur une valeur comprise entre 0.000 (aucun tracing des invocations de fonction Lambda) et 1.000 (tracing de toutes les invocations de fonction Lambda). +Pour gérer le [taux d'échantillonnage des invocations tracées par APM][17] pour des fonctions sans serveur, définissez la variable d'environnement `DD_TRACE_SAMPLING_RULES` de la fonction sur une valeur comprise entre 0.000 (aucun tracing des invocations de fonction Lambda) et 1.000 (tracing de toutes les invocations de fonction Lambda). Les métriques sont calculées en tenant compte de l'intégralité du trafic de l'application. Votre configuration d'échantillonnage ne nuit donc aucunement à leur justesse. @@ -874,4 +874,4 @@ Si vous ne parvenez pas à configurer vos installations, définissez la variable [37]: /fr/serverless/guide/extension_motivation/ [38]: /fr/serverless/guide#install-using-the-datadog-forwarder [39]: /fr/serverless/guide/troubleshoot_serverless_monitoring/ -[40]: /fr/serverless/libraries_integrations/extension/ \ No newline at end of file +[40]: /fr/serverless/libraries_integrations/extension/ diff --git a/content/ja/serverless/aws_lambda/configuration.md b/content/ja/serverless/aws_lambda/configuration.md index 5611f1df133f3..6dcb1ac7d37e0 100644 --- a/content/ja/serverless/aws_lambda/configuration.md +++ b/content/ja/serverless/aws_lambda/configuration.md @@ -350,7 +350,7 @@ Datadog APM クライアントによって自動的にインスツルメント ## APM スパンを取り込む際のサンプリングレートの選択 -サーバーレス関数の [APM トレース呼び出しのサンプリングレート][17]を管理するには、関数上で `DD_TRACE_SAMPLE_RATE` 環境変数を 0.000 (Lambda 関数呼び出しのトレースなし) と 1.000 (Lambda 関数呼び出しのすべてトレース) の間の値に設定します。 +サーバーレス関数の [APM トレース呼び出しのサンプリングレート][17]を管理するには、関数上で `DD_TRACE_SAMPLING_RULES` 環境変数を 0.000 (Lambda 関数呼び出しのトレースなし) と 1.000 (Lambda 関数呼び出しのすべてトレース) の間の値に設定します。 メトリクスは、アプリケーションの 100% のトラフィックに基づいて計算され、どのようなサンプリング構成であっても正確な値を維持します。 @@ -741,4 +741,4 @@ AWS Lambda を OpenTelemetry API でインスツルメントするには、環 [45]: https://docs.datadoghq.com/ja/tracing/trace_collection/library_config/ [46]: https://docs.datadoghq.com/ja/tracing/glossary/#services [47]: /ja/logs/ -[48]: /ja/tracing/trace_collection/otel_instrumentation/ \ No newline at end of file +[48]: /ja/tracing/trace_collection/otel_instrumentation/ diff --git a/content/ko/serverless/aws_lambda/configuration.md b/content/ko/serverless/aws_lambda/configuration.md index 06707fa7ab991..bdb36a5e6c740 100644 --- a/content/ko/serverless/aws_lambda/configuration.md +++ b/content/ko/serverless/aws_lambda/configuration.md @@ -350,7 +350,7 @@ Datadog APM 클라이언트가 자동으로 계측하는 라이브러리 및 프 ## APM 스팬 수집용 샘플링 속도 선택 -서버리스 함수용 [APM 호출 트레이스 샘플링 속도][17]를 관리하려면 함수의 `DD_TRACE_SAMPLE_RATE` 환경 변수를 0.000(Lambda 함수 호출 트레이스 없음)에서 1.000(모든 Lambda 함수 호출 트레이스) 사이의 값으로 설정합니다. +서버리스 함수용 [APM 호출 트레이스 샘플링 속도][17]를 관리하려면 함수의 `DD_TRACE_SAMPLING_RULES` 환경 변수를 0.000(Lambda 함수 호출 트레이스 없음)에서 1.000(모든 Lambda 함수 호출 트레이스) 사이의 값으로 설정합니다. 메트릭은 애플리케이션 트래픽의 100%를 기준으로 산출되며, 샘플링 구성에 관계없이 정확성을 유지합니다. @@ -741,4 +741,4 @@ OpenTelemetry API로 AWS Lambda를 계측하려면 환경 변수 `DD_TRACE_OTEL_ [45]: https://docs.datadoghq.com/ko/tracing/trace_collection/library_config/ [46]: https://docs.datadoghq.com/ko/tracing/glossary/#services [47]: /ko/logs/ -[48]: /ko/tracing/trace_collection/otel_instrumentation/ \ No newline at end of file +[48]: /ko/tracing/trace_collection/otel_instrumentation/