Windows에서 Datadog 에이전트 사용
Windows 플랫폼에서 Datadog 에이전트의 기본 기능을 안내해 드려요.
출처: 문서
본문
개요
이 페이지에서는 Windows용 Datadog 에이전트의 기본 기능을 설명해요. 아직 에이전트를 설치하지 않았다면 아래 설치 지침을 보거나 앱의 안내를 따라 하세요.
지원되는 Windows 버전 전체 목록은 지원 플랫폼을 참고하세요.
설치
Windows 호스트에 Datadog 에이전트를 설치하려면 Fleet Automation 내 가이드 인앱 흐름을 따라 설치 명령을 복사하고 실행하세요. Datadog 에이전트는 ddagentuser 아래에서 실행돼요. 자세한 내용은 Datadog Windows 에이전트 사용자 문서를 참고하세요.
대체 설치 방법
에이전트 매니저 GUI로 설치
에이전트의 기본 설치 위치는 %ProgramFiles%\Datadog\Datadog Agent예요. 커스텀 설치 위치를 선택한다면 Datadog 파일용 Datadog 하위 디렉터리를 지정해야 해요.
- Datadog 에이전트 설치 프로그램을 다운로드해 최신 버전의 에이전트를 설치하세요.
datadog-agent-7-latest.amd64.msi를 열어 설치 프로그램을 실행하세요. 관리자 자격 증명을 묻는 메시지가 표시되면 입력하세요.- 프롬프트를 따라 라이선스 계약에 동의하고 Datadog API 키를 입력하세요.
설치가 끝나면 Datadog 에이전트 매니저를 실행할 수 있는 옵션이 제공돼요.
설치 구성 옵션
Windows에서 에이전트를 설치할 때 다음 각 구성 옵션을 명령줄의 속성으로 추가할 수 있어요. 추가 에이전트 구성 옵션은 아래의 더 많은 에이전트 구성 옵션을 참고하세요.
| 변수 | 유형 | 설명 |
|---|---|---|
APIKEY |
String | Datadog API 키를 구성 파일에 추가해요. |
SITE |
String | Datadog 수집 사이트를 설정해요(예: SITE=datadoghq.com). |
TAGS |
String | 구성 파일에 지정할 태그의 쉼표 구분 목록. 예: TAGS="key_1:val_1,key_2:val_2". |
HOSTNAME |
String | 에이전트가 Datadog에 보고하는 호스트 이름을 구성해요(런타임에 계산된 호스트 이름을 덮어씀). |
DDAGENTUSER_NAME |
String | 에이전트 설치 중 사용되는 기본 ddagentuser 사용자 이름을 덮어써요 (v6.11.0+). Datadog Windows 에이전트 사용자에 대해 더 알아보기. |
DDAGENTUSER_PASSWORD |
String | 에이전트 설치 중 ddagentuser 사용자에 대해 생성되는 암호화 보안 비밀번호를 덮어써요 (v6.11.0+). 도메인 서버 설치에는 반드시 제공해야 해요. Datadog Windows 에이전트 사용자에 대해 더 알아보기. |
APPLICATIONDATADIRECTORY |
Path | 구성 파일 디렉터리 트리에 사용할 디렉터리를 덮어써요. 최초 설치에만 제공 가능하며 업그레이드에는 유효하지 않아요. 기본값: C:\ProgramData\Datadog. (v6.11.0+) |
PROJECTLOCATION |
Path | 바이너리 파일 디렉터리 트리에 사용할 디렉터리를 덮어써요. 최초 설치에만 제공 가능하며 업그레이드에는 유효하지 않아요. 기본값: %ProgramFiles%\Datadog\Datadog Agent. (v6.11.0+) 기본 디렉터리를 덮어쓴다면 Datadog 파일용 Datadog 하위 디렉터리를 지정해야 해요. |
참고
/qn옵션은 무음 설치를 실행해요. GUI 프롬프트를 보려면 이를 제거하세요.- 일부 에이전트 버전은 강제 재부팅을 유발할 수 있어요. 이를 방지하려면
REBOOT=ReallySuppress파라미터를 추가하세요. - 일부 에이전트 구성 요소는 데이터를 수집하기 위해 커널 드라이버가 필요해요. 구성 요소에 커널 드라이버가 필요한지 알아보려면 해당 문서 페이지를 보거나 관련 에이전트 구성 파일에서
kernel driver를 검색하세요. - 유효한
datadog.yaml이 발견되면 해당 파일이 지정된 모든 명령줄 옵션보다 우선해요.
추가 에이전트 구성 옵션
Windows에서 에이전트를 설치할 때 다음 각 구성 옵션을 명령줄의 속성으로 추가할 수 있어요.
참고: 유효한 datadog.yaml이 발견되면 해당 파일이 지정된 모든 명령줄 옵션보다 우선해요.
| 변수 | 유형 | 설명 |
|---|---|---|
LOGS_ENABLED |
String | 구성 파일에서 로그 수집 기능을 활성화("true")하거나 비활성화("false")해요. 로그는 기본적으로 비활성화돼요. |
APM_ENABLED |
String | 구성 파일에서 APM 에이전트를 활성화("true")하거나 비활성화("false")해요. APM은 기본적으로 활성화돼요. |
PROCESS_ENABLED |
String | 구성 파일에서 프로세스 에이전트를 활성화("true")하거나 비활성화("false")해요. 프로세스 에이전트는 기본적으로 비활성화돼요. |
HOSTNAME_FQDN_ENABLED |
String | 에이전트 호스트 이름에 FQDN 사용을 활성화("true")하거나 비활성화("false")해요. 에이전트 구성 파일에서 hostname_fqdn을 설정하는 것과 동일해요. 호스트 이름에 FQDN 사용은 기본적으로 비활성화돼요. (v6.20.0+) |
CMD_PORT |
Number | 0과 65534 사이의 유효한 포트 번호. Datadog 에이전트는 포트 5001에 명령 API를 노출해요. 해당 포트가 다른 프로그램에서 이미 사용 중이면 여기서 기본값을 덮어쓸 수 있어요. |
PROXY_HOST |
String | (프록시를 사용하는 경우) 프록시 호스트를 설정해요. Datadog 에이전트와 프록시 사용에 대해 더 알아보기. |
PROXY_PORT |
Number | (프록시를 사용하는 경우) 프록시 포트를 설정해요. Datadog 에이전트와 프록시 사용에 대해 더 알아보기. |
PROXY_USER |
String | (프록시를 사용하는 경우) 프록시 사용자를 설정해요. Datadog 에이전트와 프록시 사용에 대해 더 알아보기. |
PROXY_PASSWORD |
String | (프록시를 사용하는 경우) 프록시 비밀번호를 설정해요. 프로세스/컨테이너 에이전트의 경우 인증 비밀번호 전달에 필요하므로 이름을 바꿀 수 없어요. Datadog 에이전트와 프록시 사용에 대해 더 알아보기. |
EC2_USE_WINDOWS_PREFIX_DETECTION |
Boolean | EC2의 Windows 호스트에 EC2 인스턴스 ID를 사용해요. (v7.28.0+) |
설치 로그 파일
/log <FILENAME> msiexec 옵션을 설정해 설치 로그 파일을 구성하세요. 이 옵션을 설정하지 않으면 msiexec가 기본적으로 %TEMP%\MSI*.LOG에 로그를 기록해요.
구성
메인 에이전트 구성 파일은 C:\ProgramData\Datadog\datadog.yaml에 있어요. 이 파일은 API 키, 선택한 Datadog 사이트, 프록시 파라미터, 호스트 태그, 로그 레벨 같은 호스트 전체 설정에 사용돼요.
같은 디렉터리에 datadog.yaml.example 파일도 있는데, 사용 가능한 모든 구성 옵션이 있는 완전 주석 처리된 참조 파일이에요. 참고용과 특정 설정 복사에 유용해요. 또는 GitHub의 Windows용 예제 에이전트 구성 파일을 참고하세요.
통합 구성 파일은 C:\ProgramData\Datadog\conf.d\에 있어요. 하위 레거시 위치(C:\Documents and Settings\All Users\Application Data\Datadog\conf.d\)가 있을 수도 있어요.
각 통합에는 <INTEGRATION>.d\ 하위 디렉터리가 있으며 다음을 포함해요.
conf.yaml: 통합의 활성 설정conf.yaml.example: 지원되는 구성 키를 보여 주는 샘플 파일
구성 변경 시 에이전트를 재시작해야 변경 사항이 적용돼요.
Datadog 에이전트 매니저 GUI로 체크를 활성화·비활성화·구성할 수 있어요. 변경 사항이 적용되려면 에이전트를 재시작해야 해요.
참고: ProgramData는 숨김 폴더예요.
에이전트 명령어
에이전트 실행은 Windows 서비스 제어 관리자가 제어해요.
- 메인 실행 파일 이름은
agent.exe예요. - 구성 GUI는 브라우저 기반 구성 애플리케이션이에요(Windows 64비트 전용).
- 명령은 상승(관리자로 실행) 명령줄(PowerShell 또는 명령 프롬프트)에서
<PATH_TO_AGENT.EXE> <COMMAND>구문으로 실행할 수 있어요. - 명령줄 옵션은 아래와 같아요.
| 명령어 | 설명 |
|---|---|
| check | 지정된 체크를 실행해요. |
| diagnose | 시스템에서 연결성 진단을 실행해요. |
| flare | 플레어를 모아 Datadog로 보내요. |
| help | 모든 명령어에 대한 도움말을 제공해요. |
| hostname | 에이전트에서 사용하는 호스트 이름을 출력해요. |
| import | 이전 에이전트 버전의 구성 파일을 가져와 변환해요. |
| launch-gui | Datadog 에이전트 매니저를 시작해요. |
| restart-service | 서비스 제어 매니저 내에서 에이전트를 재시작해요. |
| run | 에이전트를 시작해요. |
| start | 에이전트를 시작해요.(더 이상 사용되지 않지만 허용됨. 대신 run을 사용하세요.) |
| start-service | 서비스 제어 매니저 내에서 에이전트를 시작해요. |
| status | 현재 상태를 출력해요. |
| stopservice | 서비스 제어 매니저 내에서 에이전트를 중지해요. |
| version | 버전 정보를 출력해요. |
예시:
-
PowerShell(
powershell.exe)& "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" status & "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" launch-gui & "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" flare -
명령 프롬프트(
cmd.exe)"%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" status "%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" launch-gui "%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" flare
에이전트 제거
Windows에서 에이전트를 제거하는 방법은 두 가지예요. 두 방법 모두 에이전트를 제거하지만 호스트의 C:\ProgramData\Datadog 구성 폴더는 제거하지 않아요.
프로그램 추가/제거
- CTRL과 Esc를 누르거나 Windows 키를 사용해 Windows 검색을 실행하세요.
add를 검색하고 프로그램 추가/제거(Add or remove programs)를 클릭하세요.Datadog Agent를 검색하고 제거(Uninstall)를 클릭하세요.
PowerShell
참고: 아래 명령을 사용하려면 WinRM을 활성화하세요.
재부팅 없이 에이전트를 제거하려면 다음 PowerShell 명령을 사용하세요.
$productCode = (@(Get-ChildItem -Path "HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall" -Recurse) | Where {$_.GetValue("DisplayName") -like "Datadog Agent" }).PSChildName
start-process msiexec -Wait -ArgumentList ('/log', 'C:\uninst.log', '/q', '/x', "$productCode", 'REBOOT=ReallySuppress')
트러블슈팅
트러블슈팅 단계는 에이전트 트러블슈팅 문서를 참고하세요.
에이전트 상태와 정보
에이전트가 실행 중인지 확인하려면 서비스 패널의 DatadogAgent 서비스가 시작됨으로 표시되는지 확인하세요. 작업 관리자에는 Datadog Metrics Agent(agent.exe) 프로세스가 있어야 해요.
에이전트 상태에 대한 더 많은 정보를 얻으려면 Datadog 에이전트 매니저를 시작하세요.
- Datadog 에이전트 시스템 트레이 아이콘을 우클릭 > Configure, 또는
- 상승(관리자로 실행) 명령줄에서
launch-gui명령 실행- PowerShell:
& "<PATH_TO_AGENT.EXE>" launch-gui - cmd:
"<PATH_TO_AGENT.EXE>" launch-gui
- PowerShell:
그런 다음 Status > General로 이동해 상태 페이지를 여세요. Status > Collector와 Checks > Summary에서 실행 중인 체크에 대한 더 많은 정보를 얻으세요.
status 명령은 PowerShell에서 사용할 수 있어요.
& "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" status
또는 cmd.exe에서:
"%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" status
로그 위치
에이전트 로그는 C:\ProgramData\Datadog\logs\agent.log에 있어요.
참고: ProgramData는 숨김 폴더예요.
사용 사례
Windows 서비스 모니터링
대상 호스트에서 Datadog 에이전트 매니저를 실행하고 목록에서 Windows Service 통합을 선택하세요. 기본 제공 예제가 있지만 이 예제는 DHCP를 사용해요.
서비스 이름을 얻으려면 services.msc를 열고 대상 서비스를 찾으세요. DHCP를 대상으로 사용하면 서비스 속성 창 상단에서 서비스 이름을 볼 수 있어요.
자체 서비스를 추가할 때는 표시된 형식을 정확히 따르세요. 형식이 올바르지 않으면 통합이 실패해요. 참고: 서비스 이름의 특수 문자는 이스케이프해야 해요. 예를 들어 MSSQL$BILLING 이름은 MSSQL\$BILLING으로 추가할 수 있어요.
또한 통합을 수정할 때마다 Datadog 서비스를 재시작해야 해요. 이 작업은 services.msc 또는 UI 사이드바에서 할 수 있어요.
서비스의 경우 Datadog는 메트릭이 아니라 가용성만 추적해요. (메트릭은 Process 또는 WMI 통합을 사용하세요.) 모니터를 설정하려면 Integration 모니터 유형을 선택한 다음 Windows Service를 검색하세요. Integration Status > Pick Monitor Scope에서 모니터링할 서비스를 선택하세요.
Windows 시스템 부하 모니터링
Datadog 에이전트는 기본적으로 수많은 시스템 메트릭을 수집해요. 가장 흔히 사용되는 시스템 메트릭은 system.load.*인데, 이 메트릭은 Unix 전용이에요.
Windows는 system.load.* 메트릭을 제공하지 않지만, 기본으로 사용 가능한 대안은 system.proc.queue.length예요. 이 메트릭은 프로세서 준비 큐에서 실행을 기다리며 지연된 것으로 관찰된 스레드 수를 보여 줘요.
Windows 프로세스 모니터링
라이브 프로세스 모니터링으로 Windows 프로세스를 모니터링할 수 있어요. Windows에서 활성화하려면 에이전트 메인 구성 파일을 편집해 다음 파라미터를 true로 설정하세요.
datadog.yaml:
process_config:
enabled: "true"
구성이 끝나면 에이전트를 재시작하세요.
더 알아보기 (Learn more)
추가로 도움이 되는 문서, 링크, 아티클: