본문 바로가기
WIKI 기술 지식 베이스

Linux에서 Datadog 에이전트 사용

원문 보기 위키 갱신

Linux 환경에서 Datadog 에이전트의 기본 기능을 안내해 드려요. 지원되는 Linux 배포판과 버전 전체 목록은 지원 플랫폼 문서를 참고하세요.

출처: 문서

본문

개요

이 페이지에서는 Linux 환경에서의 Datadog 에이전트 기본 기능을 설명해요. 지원되는 Linux 배포판과 버전 전체 목록은 지원 플랫폼 문서를 참고하세요.

에이전트 설치

Linux에 에이전트를 설치하려면 Fleet Automation의 인앱 안내를 따라 생성된 스크립트를 호스트에서 실행하세요.

에이전트 구성

Datadog 에이전트 구성 파일은 /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 에이전트 프록시 구성 참고)
  • 기본 태그, 로그 레벨, Datadog 구성

/etc/datadog-agent/datadog.yaml.example에 있는 완전 주석 처리된 참조 파일에는 비교하거나 복사해 붙여넣을 수 있는 모든 옵션이 나열되어 있어요. 또는 GitHub의 Linux용 예제 에이전트 구성 파일을 참고하세요.

통합 파일

통합 구성 파일은 /etc/datadog-agent/conf.d/에 있어요. 각 통합에는 <INTEGRATION>.d/ 하위 디렉터리가 있으며 다음을 포함해요.

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

명령어

설명 명령어
에이전트를 서비스로 시작 sudo systemctl start datadog-agent
서비스로 실행 중인 에이전트 중지 sudo systemctl stop datadog-agent
서비스로 실행 중인 에이전트 재시작 sudo systemctl restart datadog-agent
에이전트 서비스 상태 sudo systemctl status datadog-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 시스템에서 에이전트를 서비스로 시작할 때는 sudo start datadog-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

위 명령은 에이전트를 제거하지만 다음은 제거하지 않아요.

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

이 요소들을 제거하려면 에이전트를 제거한 후 다음 명령을 실행하세요.

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

Debian과 Ubuntu의 남은 에이전트 아티팩트를 제거하려면 다음을 실행하세요.

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

싱글 스텝 APM 계측 제거

싱글 스텝 APM 계측과 함께 에이전트를 설치했고 이를 제거하려면 APM 계측을 제거하기 위한 추가 명령을 실행해야 해요. 특정 환경의 단계를 따라 하세요.

트러블슈팅

자세한 단계는 에이전트 트러블슈팅을 참고하세요.

임베디드 에이전트 작업

에이전트에는 /opt/datadog-agent/embedded/에 임베디드 Python 환경이 들어 있어요. python과 pip 같은 일반 바이너리는 /opt/datadog-agent/embedded/bin/ 안에 있어요.

임베디드 에이전트에 패키지 추가 방법에 대한 지침을 참고하세요.

더 알아보기 (Learn more)

추가로 도움이 되는 문서, 링크, 아티클: