Linux

개요

이 페이지에서는 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, us2.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
flare 전송sudo datadog-agent flare
명령어 사용법 표시sudo datadog-agent --help
검사 실행sudo -u dd-agent -- datadog-agent check <CHECK_NAME>

참고: upstart 기반 시스템의 경우, CentOS/RHEL 6 또는 SUSE 11에서 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 환경을 포함하고 있습니다. /opt/datadog-agent/embedded/bin/ 내에 pythonpip와 같은 일반 바이너리가 포함되어 있습니다.

자세한 정보가 필요하신 분은 임베디드 Agent에 패키지를 추가하는 방법 안내서를 참조하시기 바랍니다.

추가 자료