Setting up Remote Configuration for Tracing

이 페이지는 아직 영어로 제공되지 않습니다. 번역 작업 중입니다.
현재 번역 프로젝트에 대한 질문이나 피드백이 있으신 경우 언제든지 연락주시기 바랍니다.

This guide covers setting up and using Remote Configuration with your tracing libraries. For more information on how Remote Configuration works, see Remote Configuration.

Prerequisites

  • Datadog Agent 7.47.0 or higher installed on your hosts or containers.
  • Upgrade your tracing libraries to a Remote Configuration-compatible version. For more information, see the Supported configuration options section.
  • Ensure your RBAC permissions include org_management, so you can enable Remote Configuration for your organization.
  • Ensure your RBAC permissions include api_keys_write, so you can create a new API key with the Remote Configuration capability, or add the capability to an existing API key. Contact your organization’s Datadog administrator to update your permissions if you don’t have it. A key with this capability allows you to authenticate and authorize your Agent to use Remote Configuration.
  • Ensure you have the APM Remote Configuration Read and APM Remote Configuration Write permissions. Note: If you don’t have these permissions, ask your Datadog Admin to update your permissions from your Organization Settings.

Set up Remote Configuration

  1. Ensure that Remote Configuration is enabled for your organization. This enables Datadog components across your organization to receive configurations from Datadog.

  2. Select an existing API key or create a new API key, and enable the Remote Configuration capability on the key if it is not already enabled.

    API Key properties with Remote Configuration capability Enable button.

  3. Restart your Agent.

Review Remote Configuration status of tracing libraries

You can gain visibility into the Remote Configuration status of your Tracer libraries through the Remote Configuration UI.

The following table describes the meaning of each Tracing library status:

Tracing library StatusDescription
CONNECTEDThe Tracing library is successfully connected to the Remote Configuration service through the associated Agent. This is the optimal state you want your Tracing library to be in for Remote Configuration.
UNAUTHORIZEDThe Tracing library is associated with an Agent which doesn’t have Remote Config Read permission on its API key. To fix the issue, you need to enable Remote Configuration capability on the API Key used by the Agent associated with the Tracing library.
CONNECTION ERRORThe Tracing library deployed in your environment is associated with an Agent that has remote_config.enabled set to true in its datadog.yaml configuration file, however, the agent cannot be found in the Remote Configuration service. The most likely cause of this is that the associated Agent is unable to reach Remote Configuration endpoints. To fix the issue, you need to allow outbound HTTPS access to Remote Configuration endpoints from your environment.
DISABLEDThe Tracing library deployed in your environment is associated with an Agent that has remote_config.enabled set to false in its datadog.yaml configuration file. This could be set deliberately or mistakenly. To enable Remote Configuration on the associated Agent, set remote_config.enabled to true.
NOT CONNECTEDThe Tracing library cannot be found in the Remote Configuration service and is associated with an Agent that could have remote_config.enabled set to true or false in its datadog.yaml configuration file. Check your local Agent configuration or your proxy settings.
UNSUPPORTED AGENTThe Tracing library is associated with an Agent which is not Remote Configuration capable. To fix this issue, update the associated Agent software to the latest available version.
NOT DETECTEDThe Tracing library does not support Remote Configuration. To fix this issue, update the Tracing library software to the latest available version.
UNKNOWNThe Tracing library status is unknown, and it can’t be determined if an Agent is associated with the Tracing library. For example, this could be because the Agent is deployed on a fully managed serverless container service like AWS Fargate.

Further reading

추가 유용한 문서, 링크 및 기사:

Remote ConfigurationDOCUMENTATION more more
PREVIEWING: heston/DOCS-10466