개요

이 페이지에서는 Windows용 Datadog Agent의 기본 기능에 대해 설명합니다. 아직 Agent를 설치하지 않은 경우 아래 설치 지침을 확인하거나 앱 안내를 따르세요.

지원되는 Windows 버전의 전체 목록은 지원되는 플랫폼을 참조하세요.

설치

Windows 호스트에 Datadog Agent를 설치하려면 Fleet Automation 내의 인앱 흐름을 따른 다음 설치 명령을 복사하고 실행하세요. Datadog Agent는 ddagentuser로 실행됩니다. 자세한 정보는 Datadog Windows Agent User 문서를 참조하세요.

대체 설치 방법

Agent Manager GUI로 설치

1. 최신 버전의 Agent를 설치하려면 Datadog Agent 설치 프로그램을 다운로드합니다.
2. datadog-agent-7-latest.amd64.msi를 열어 설치 프로그램을 실행합니다. 메시지가 나타나면 Administrator 자격 증명을 입력합니다.
3. 안내에 따라 라이선스 계약에 동의하고 Datadog API 키를 입력합니다.

설치가 완료되면 Datadog Agent Manager를 시작할 수 있는 옵션이 제공됩니다.

설치 구성 옵션

Windows에 Agent를 설치할 때 다음 각 구성 옵션을 명령줄에 속성으로 추가할 수 있습니다. 추가 Agent 구성 옵션은 추가 Agent 구성 옵션을 참조하세요.

참고

• /qn 옵션은 자동 설치를 실행합니다. GUI 프롬프트를 보려면 제거하세요.
• 일부 Agent 버전에서는 강제 재부팅이 발생할 수 있습니다. 이를 방지하려면 파라미터 REBOOT=ReallySuppress를 추가하세요.
• 일부 Agent 구성 요소에는 데이터를 수집하기 위해 커널 드라이버가 필요합니다. 구성 요소에 커널 드라이버가 필요한지 확인하려면 해당 설명서 페이지를 참조하거나 연결된 관련 Agent 구성 파일에서 kernel driver를 검색하세요.
• 유효한 datadog.yaml이 발견되면 해당 파일이 지정된 모든 명령줄 옵션보다 우선합니다.

추가 Agent 구성 옵션

Windows에 Agent를 설치할 때 다음 각 구성 옵션을 명령줄에 속성으로 추가할 수 있습니다.

참고: 유효한 datadog.yaml이 발견되면 해당 파일이 지정된 모든 명령줄 옵션보다 우선합니다.

설치 로그 파일

/log <FILENAME> msiexec 옵션을 설정하여 설치 로그 파일을 구성합니다. 이 옵션을 설정하지 않으면 msiexec은 기본적으로 로그를 %TEMP%\MSI*.LOG에 작성합니다.

구성

주요 Agent 구성 파일은 다음 위치에 있습니다. C:\ProgramData\Datadog\datadog.yaml. 이 파일은 API 키, 선택한 Datadog 사이트, 프록시 파라미터, 호스트 태그 및 로그 레벨과 같은 호스트 전체 설정에 사용됩니다.

같은 디렉터리에 datadog.yaml.example 파일도 있으며, 이는 모든 사용 가능한 구성 옵션에 대한 완전 주석형 참조 파일로, 참조 및 특정 설정 복사에 유용합니다.

통합용 구성 파일은 다음 위치에 있습니다. C:\ProgramData\Datadog\conf.d\ 대체 레거시 위치도 있을 수 있습니다(C:\Documents and Settings\All Users\Application Data\Datadog\conf.d\).

각 통합에는 <INTEGRATION>.d\ 하위 디렉터리가 있으며 여기에는 다음이 포함됩니다.

• conf.yaml: 통합에 대한 활성 설정

• conf.yaml.example:지원되는 구성 키가 표시된 샘플 파일

구성 변경을 할 때는 변경 사항이 적용되도록 Agent를 재시작해야 합니다.

Datadog Agent Manager GUI를 사용하여 검사를 활성화, 비활성화 및 구성할 수 있습니다. 변경 사항이 적용되려면 Agent를 다시 시작해야 합니다.

참고: ProgramData는 숨겨진 폴더입니다.

Agent 명령

Agent 실행은 Windows Service Control Manager에 의해 제어됩니다.

• 메인 실행 파일 이름은 agent.exe입니다.
• 구성 GUI는 브라우저 기반 구성 애플리케이션입니다(Windows 64비트 전용).
• <PATH_TO_AGENT.EXE> <COMMAND> 구문을 사용하여 승격된(Admin으로 실행) 명령줄(PowerShell 또는 Command Prompt)에서 명령을 실행할 수 있습니다.
• 명령줄 옵션은 아래와 같습니다.

예시:

• 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
  

• Command Prompt(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
  

Agent 제거

Windows에서 Agent를 제거하는 방법에는 두 가지가 있습니다. 두 방법 모두 Agent를 제거하지만, 호스트의 C:\ProgramData\Datadog 구성 폴더는 제거하지 않습니다.

프로그램 추가 또는 제거

1. CTRL 및 Esc를 누르거나 Windows 키를 사용하여 Windows Search를 실행합니다.
2. add를 검색하고 Add or remove programs를 클릭합니다.
3. Datadog Agent를 검색하고 Uninstall을 클릭합니다.

PowerShell

참고: 아래 명령을 사용하려면 WinRM을 활성화하세요.

재부팅하지 않고 Agent를 제거하려면 다음 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')

문제 해결

문제 해결 단계를 보려면 Agent 문제 해결 문서를 참조하세요.

Agent 상태 및 정보

Agent가 실행 중인지 확인하려면 Service 패널의 DatadogAgent 서비스가 Started로 나타나는지 확인합니다. Task Manager에 Datadog Metrics Agent(agent.exe)라는 프로세스도 있어야 합니다.

Agent 상태에 대한 자세한 정보를 얻으려면 Datadog Agent Manager를 시작하세요.

• Datadog Agent 시스템 트레이 아이콘을 오른쪽 버튼으로 클릭하고 > Configure를 클릭하거나,
• 승격된(Admin으로 실행) 명령줄에서 launch-gui 명령 실행
  • PowerShell: & "<PATH_TO_AGENT.EXE>" launch-gui
  • cmd: "<PATH_TO_AGENT.EXE>" launch-gui

그런 다음, Status > General로 이동하여 상태 페이지를 엽니다. 실행 검사에 관한 자세한 정보는 Status > Collector 및 Checks > Summary를 참조하세요.

상태 명령은 PowerShell의 경우 다음과 같이 사용 가능:

& "$env:ProgramFiles\Datadog\Datadog Agent\bin\agent.exe" status

또는 cmd.exe의 경우:

"%ProgramFiles%\Datadog\Datadog Agent\bin\agent.exe" status

로그 위치

Agent 로그는 C:\ProgramData\Datadog\logs\agent.log에 있습니다.

참고: ProgramData는 숨겨진 폴더입니다.

사용 사례

Windows 서비스 모니터링

대상 호스트에서 Datadog Agent Manager를 실행하고 목록에서 Windows Service 통합을 선택합니다. 즉시 사용 가능한 예시가 있지만, 이 예에서는 DHCP를 사용합니다.

서비스 이름을 가져오려면 services.msc를 열고 대상 서비스 위치를 찾습니다. DHCP를 대상으로 사용하여 서비스 속성 창 상단에서 서비스 이름을 확인할 수 있음:

자체 서비스를 추가하는 경우, 표시된 형식을 정확하게 따라야 합니다. 형식이 올바르지 않으면 통합이 실패합니다. 참고: 서비스 이름의 특수 문자는 이스케이프해야 합니다. 예를 들어 이름이 MSSQL$BILLING인 경우, MSSQL\$BILLING을 사용하여 추가할 수 있습니다.

또한 통합을 수정할 때마다 Datadog 서비스를 다시 시작해야 합니다. services.msc 또는 UI 사이드바에서 이 작업을 수행할 수 있습니다.

Services의 경우 Datadog은 메트릭을 추적하지 않고 가용성만 추적합니다 (메트릭의 경우, Process 또는 WMI 통합 사용). Monitor를 설정하려면 Integration monitor type을 선택한 다음 Windows Service를 검색합니다. Integration Status > Pick Monitor Scope에서 모니터링하고자 하는 서비스를 선택합니다.

Windows용 시스템 로드 모니터링

Datadog Agent는 기본적으로 많은 수의 시스템 메트릭을 수집합니다. 가장 일반적으로 사용되는 시스템 메트릭은 system.load.*이지만 이러한 메트릭은 Unix에만 적용됩니다.

Windows는 system.load.* 메트릭을 제공하지 않지만, 기본적으로 사용할 수 있는 동등한 옵션은 system.proc.queue.length입니다. 이 메트릭은 실행 대기 중인 프로세서 준비 대기열에서 지연된 것으로 관찰된 스레드 수를 표시합니다.

Windows 프로세스 모니터링

Live Process Monitoring을 통해 Windows 프로세스를 모니터링할 수 있습니다. Windows에서 이 기능을 활성화하려면 다음 파라미터를 true로 설정하여 Agent 기본 구성 파일을 편집하세요.

datadog.yaml:

process_config:
  enabled: "true"

설정을 완료한 후 Agent를 재시작하세요.

추가 자료

추가 유용한 문서, 링크 및 기사:

로그 수집설명서 프로세스 수집설명서 트레이스 수집설명서 Agent 아키텍처 자세히 알아보기설명서 인바운드 포트 구성설명서 Datadog Windows Agent User에 대해 자세히 알아보기설명서