개요

이 페이지에서는 Linux 환경용 Datadog Agent의 기본적인 기능을 간략하게 설명합니다. 지원되는 Linux 배포판 및 버전의 전체 목록은 지원되는 플랫폼 설명서를 참조하세요.

Agent 설치

Linux에 Agent를 설치하려면 Fleet Automation의 인앱 지침을 따르고, 생성된 스크립트를 호스트에서 실행하세요.

Linux 호스트에서 실행하는 Datadog Agent에 대한 인앱 설치 단계입니다.

Agent 구성

Datadog Agent 구성 파일은 /etc/datadog-agent/datadog.yaml에 있습니다. 이 YAML 파일에는 다음과 같은 데이터를 Datadog에 전송하는 데 사용되는 호스트 전체 연결의 세부 정보가 포함되어 있습니다.

  • api_key: 조직의 Datadog API 키
  • site: 대상 Datadog 지역(예: datadoghq.com, datadoghq.eu, ddog-gov.com)
  • proxy: 아웃바운드 트래픽에 대한 HTTP/HTTPS 프록시 엔드포인트(Datadog Agent 프록시 구성 참조)
  • 기본 태그, 로그 레벨 및 Datadog 구성

/etc/datadog-agent/datadog.yaml.example에 있는 완전 주석형 참조 파일에는 사용 가능한 모든 옵션이 나열되어 있어 비교하거나 복사하여 붙여넣을 수 있습니다. 또는 사용 가능한 모든 구성 옵션은 샘플 config_template.yaml 파일을 참조하세요.

통합 파일

통합을 위한 구성 파일은 /etc/datadog-agent/conf.d/에 있습니다. 각 통합에는 <INTEGRATION>.d/라는 자체 하위 디렉터리가 있으며, 여기에는 다음이 포함됩니다.

  • conf.yaml: 통합이 메트릭과 로그를 수집하는 방식을 제어하는 활성 구성
  • conf.yaml.example: 지원되는 키와 기본값을 설명하는 샘플

명령

설명명령
서비스형 Agent 시작sudo systemctl start datadog-agent
서비스형 Agent 중지sudo systemctl stop datadog-agent
서비스형 Agent 다시 시작sudo systemctl restart datadog-agent
Agent 서비스의 상태sudo systemctl status datadog-agent
실행 중인 Agent의 상태 페이지sudo datadog-agent status
플레어 전송sudo datadog-agent flare
명령 사용법 표시sudo datadog-agent --help
검사 실행sudo -u dd-agent -- datadog-agent check <CHECK_NAME>

참고: CentOS/RHEL 6 또는 SUSE 11과 같은 upstart 기반 시스템의 경우, systemctl <action><action>으로 교체하세요. 예를 들어, SUSE 11 시스템에서 서비스형 Agent를 시작할 때는 sudo start datadog-agent를 사용하세요.

Agent 제거

Agent를 제거하려면 적절한 Linux 환경에 따라 다음 명령을 실행하세요.

CentOS, Rocky, AlmaLinux, Amazon Linux, Oracle Linux 및 Red Hat의 경우

sudo yum remove datadog-agent

Debian, Ubuntu의 경우

sudo apt-get remove datadog-agent -y

SUSE의 경우

sudo zypper remove datadog-agent

위 명령은 Agent를 제거하지만 다음 항목은 제거하지 않습니다.

  • datadog.yaml 구성 파일
  • /etc/datadog-agent 구성 폴더에 있는 사용자 생성 파일
  • /opt/datadog-agent 폴더에 있는 사용자 생성 파일
  • dd-agent 사용자
  • Datadog 로그 파일

이들 요소를 제거하려면 Agent를 제거한 후 이 명령을 실행하세요.

sudo userdel dd-agent \
&& sudo rm -rf /opt/datadog-agent/ \
&& sudo rm -rf /etc/datadog-agent/ \
&& sudo rm -rf /var/log/datadog/

DebianUbuntu의 경우 남은 Agent 아티팩트를 제거하려면 다음을 실행하세요.

sudo apt-get remove --purge datadog-agent -y

Single Step APM Instrumentation 제거

Single Step APM Instrumentation으로 Agent를 설치한 경우, Agent를 제거하려면 추가 명령을 실행하여 APM Instrumentation을 제거해야 합니다. 특정 환경에 대한 단계를 따르세요.

문제 해결

자세한 단계는 Agent 문제 해결을 참조하세요.

임베디드 Agent 사용

Agent는 /opt/datadog-agent/embedded/에 임베디드 Python 환경을 포함합니다. pythonpip처럼 일반적으로 사용하는 바이너리는 /opt/datadog-agent/embedded/bin/에 있습니다.

자세한 내용은 임베디드 Agent에 패키지를 추가하는 방법에 대한 지침을 참조하세요.

참고 자료