macOS에서 Datadog 에이전트 사용
macOS에서 Datadog 에이전트의 기본 기능을 안내해 드려요. 지원되는 macOS 배포판과 버전 전체 목록은 지원 플랫폼 문서를 참고하세요.
출처: 문서
본문
개요
이 페이지에서는 macOS에서의 Datadog 에이전트 기본 기능을 설명해요. 지원되는 macOS 배포판과 버전 전체 목록은 지원 플랫폼 문서를 참고하세요.
에이전트 설치
macOS에 에이전트를 설치하려면 Fleet Automation의 인앱 안내를 따라 생성된 스크립트를 호스트에서 실행하세요.
에이전트는 /opt/datadog-agent에 있는 샌드박스에 설치돼요. 추가 모니터링을 위해서는 에이전트 사용자 _dd-agent에게 해당 파일이나 디렉터리 접근 권한을 부여해야 해요.
명령어
launchctl 서비스 관리자가 에이전트 수명 주기를 제어하며, 다른 명령은 에이전트 바이너리, 시스템 트레이 앱, 웹 GUI를 통해 실행할 수 있어요.
| 설명 | 명령어 |
|---|---|
| 에이전트를 서비스로 시작 | sudo launchctl kickstart system/com.datadoghq.agent |
| 서비스로 실행 중인 에이전트 중지 | sudo launchctl kill SIGTERM system/com.datadoghq.agent |
| 서비스로 실행 중인 에이전트 재시작 | sudo launchctl kickstart -k system/com.datadoghq.agent |
| 에이전트 서비스 상태 | sudo launchctl print system/com.datadoghq.agent |
| 실행 중인 에이전트 상태 페이지 | sudo datadog-agent status 또는 웹 GUI |
| 플레어 보내기 | sudo datadog-agent flare 또는 웹 GUI |
| 명령 사용법 표시 | datadog-agent --help |
| 체크 실행 | sudo datadog-agent check <CHECK_NAME> |
구성
Datadog 에이전트 구성 파일은 /opt/datadog-agent에 있어요. 이 YAML 파일은 Datadog로 데이터를 보내는 데 사용되는 호스트 전역 연결 정보를 담고 있어요.
api_key: 조직의 Datadog API 키site: 대상 Datadog 리전(예:datadoghq.com,datadoghq.eu,ddog-gov.com,us2.ddog-gov.com)proxy: 아웃바운드 트래픽용 HTTP/HTTPS 프록시 엔드포인트(Datadog 에이전트 프록시 구성 참고)- 기본 태그, 로그 레벨, Datadog 구성
/opt/datadog-agent/etc/datadog.yaml.example에 있는 완전 주석 처리된 참조 파일에는 비교하거나 복사해 붙여넣을 수 있는 모든 옵션이 나열되어 있어요. 또는 GitHub의 macOS용 예제 에이전트 구성 파일을 참고하세요.
통합 파일
통합 구성 파일은 /opt/datadog-agent/etc/conf.d/에 있어요. 각 통합에는 <INTEGRATION>.d/ 하위 디렉터리가 있으며 다음을 포함해요.
conf.yaml: 통합이 메트릭과 로그를 수집하는 방식을 제어하는 활성 구성conf.yaml.example: 지원되는 키와 기본값을 보여 주는 샘플
에이전트 제거
에이전트를 제거하려면 다음 스크립트를 실행하세요.
curl -L https://install.datadoghq.com/scripts/uninstall_mac_os.sh | bash
트러블슈팅
트러블슈팅 단계는 에이전트 트러블슈팅 문서를 참고하세요.
임베디드 에이전트 작업
에이전트에는 /opt/datadog-agent/embedded/에 임베디드 Python 환경이 들어 있어요. python과 pip 같은 일반 바이너리는 /opt/datadog-agent/embedded/bin/ 안에 있어요.
임베디드 에이전트에 패키지 추가 방법에 대한 지침을 참고하세요.
더 알아보기 (Learn more)
추가로 도움이 되는 문서, 링크, 아티클: