Agent를 호스트에 설치하는 것과 컨테이너화된 환경에 설치하는 것 사이에는 다음과 같은 중요한 차이점이 있습니다.

• 구성 차이점:

  • 호스트: YAML 파일을 사용해 Agent를 구성합니다.
  • 컨테이너: 환경 변수를 사용하여 구성 옵션이 전달됩니다. 예를 들면 다음과 같습니다.

  `DD_API_KEY` # Datadog API key
  `DD_SITE`    # Datadog site
  

• 통합 감지:

  • 호스트: Agent 구성 파일을 통해 통합을 식별합니다.
  • 컨테이너: Datadog의 Autodiscovery 기능을 사용해 통합이 자동으로 식별됩니다. 자세한 내용은 기본 Agent Autodiscovery를 참조하세요.

또한 컨테이너화된 환경에서 Agent를 실행하는 방법에 관한 워크스루는 Docker Agent 또는 Kubernetes를 참조하세요.

태그는 메트릭 및 이벤트에 추가적인 메타데이터 레이어를 추가합니다. 태그를 사용하면 Datadog 시각화에서 데이터의 범위를 지정하고 데이터를 비교할 수 있습니다. 여러 호스트에서 Datadog으로 데이터를 보내는 경우, 이 데이터에 태그를 지정하면 가장 시각화하고 싶은 데이터로 범위를 좁힐 수 있습니다.

예를 들어 여러 팀에서 수집한 데이터가 있고, 알파팀의 메트릭을 보는 데만 관심이 있는 경우 그러한 호스트를 team:alpha 또는 team:bravo 태그로 태그를 지정하면 team:alpha로 태그가 지정된 메트릭으로만 필터링해 범위를 좁힐 수 있습니다. 데이터에 태그를 지정하는 것에 관한 자세한 내용은 태그 시작하기를 참조하세요.

1. Agent의 메인 구성 파일을 찾습니다. Ubuntu의 경우, 파일 위치는 /etc/datadog-agent/datadog.yaml입니다.

2. datadog.yaml 파일에서 tags 파라미터를 찾습니다. 호스트 수준 태그를 datadog.yaml 구성에서 설정하여 이 호스트에서 전달된 모든 메트릭, 트레이스 및 로그에 태그를 적용할 수 있습니다.

   ## @param tags  - list of key:value elements - optional
   ## @env DD_TAGS - space separated list of strings - optional
   ## List of host tags. Attached in-app to every metric, event, log, trace, and service check emitted by this Agent.
   ##
   ## This configuration value merges with `DD_EXTRA_TAGS`, allowing some
   ## tags to be set in a configuration file (`tags`), and additional tags to be added
   ## with an environment variable (`DD_EXTRA_TAGS`).
   ##
   ## Learn more about tagging: https://docs.datadoghq.com/tagging/
   #
   # tags:
   #   - team:infra
   #   - <TAG_KEY>:<TAG_VALUE>
   

3. 태그 파라미터와 제공된 예시 team:infra 태그의 주석을 제거합니다. 사용자 지정 태그를 추가할 수도 있습니다(예: test:agent_walkthrough).

   ## @param tags  - list of key:value elements - optional
   ## @env DD_TAGS - space separated list of strings - optional
   ## List of host tags. Attached in-app to every metric, event, log, trace, and service check emitted by this Agent.
   ##
   ## This configuration value merges with `DD_EXTRA_TAGS`, allowing some
   ## tags to be set in a configuration file (`tags`), and additional tags to be added
   ## with an environment variable (`DD_EXTRA_TAGS`).
   ##
   ## Learn more about tagging: https://docs.datadoghq.com/tagging/
   #
   tags:
      - team:infra
      - test:agent_walkthrough
   

4. Agent의 재시작 명령을 실행하여 Agent를 재시작합니다. Ubuntu 재시작 명령:

   sudo service datadog-agent restart
   

5. 몇 분 뒤 다시 Metrics Summary 페이지로 이동하여 메트릭 datadog.agent.started를 클릭합니다. 기본 host 및 version 태그 외에 team 태그 및 사용자가 추가한 개인 태그도 표시됩니다. 페이지 상단에서 Tag 필드를 기준으로 메트릭을 필터링할 수도 있습니다.

6. Events Explorer 페이지로 이동하여 최신 Agent 이벤트와 함께 표시된 사용자 지정 태그를 찾습니다.

Agent가 올바로 실행 중인지 확인하려면 Datadog UI에서 기본 메트릭을 검사하면 됩니다. Metrics Summary 페이지로 이동하여 메트릭 datadog.agent.started 또는 메트릭 datadog.agent.running을 검색합니다. 이러한 메트릭이 바로 표시되지 않는 경우, Agent가 Datadog에 데이터를 보내는 데 몇 분 걸릴 수 있습니다.

두 메트릭 중 아무 것이나 클릭하면 Metric 패널이 열립니다. 이 패널에는 이러한 메트릭의 수집 위치에 대한 추가 메타데이터와 연결된 태그가 표시됩니다. 호스트에서 구성된 태그가 없는 경우, Datadog이 해당 메트릭에 할당하는 기본 태그만 표시됩니다(예를 들어 version 및 host). 태그를 추가하는 방법을 자세히 알아보려면 Agent 구성 파일을 통해 태그를 설정하는 방법을 다룬 위의 섹션을 참조하세요.

ntp.offset 또는 system.cpu.idle과 같은 다른 기본 메트릭을 둘러보세요.

Agent가 차지하는 공간과 리소스의 양은 구성 및 해당 Agent가 보내는 데이터가 무엇인지에 좌우됩니다. 처음에는 평균 CPU 사용량 약 0.08%, 디스크 공간 약 880MB~1.3GB가 예상됩니다.

이러한 벤치마크 수치에 대해 자세히 알아보려면 Agent 오버헤드를 참조하세요.

Agent 구성 파일을 통해 로그, 트레이스 및 프로세스 데이터 수집을 활성화할 수 있습니다. 이러한 기능은 기본적으로 활성화되지 않습니다. 예를 들어 구성 파일에서 logs_enabled 파라미터는 false로 설정됩니다.

##################################
## Log collection Configuration ##
##################################

## @param logs_enabled - boolean - optional - default: false
## @env DD_LOGS_ENABLED - boolean - optional - default: false
## Enable Datadog Agent log collection by setting logs_enabled to true.
#
# logs_enabled: false

기타 Agent 구성 파일을 통해 구성할 수 있는 Datadog 기능은 다음과 같습니다.

• OTLP 트레이스 수집 활성화
• 로그 수집을 사용자 지정하여 민감한 데이터 필터링 또는 스크러빙
• DogStatsD를 통한 사용자 지정 데이터 구성

설정하는 과정 내내, 설명서에서 datadog.yaml 파일 또는 Agent 구성 파일을 언급하는 경우 이것이 구성해야 하는 파일입니다.