개요

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

Datadog 에이전트 설치

필수 조건

• Windows 버전: Windows Server 2016 이상이거나 Windows 10 이상. 지원되는 OS 버전을 보려면 에이전트 지원 플랫폼 설명서를 참고하세요.
• Datadog 계정: Datadog 계정에 액세스할 수 있고 Datadog API 키가 있는지 확인하세요.
• 관리자 권한: Windows 컴퓨터 관리자 액세스가 필요합니다.

Start-Process -Wait msiexec -ArgumentList '/qn /i datadog-agent-7-latest.amd64.msi APIKEY="<YOUR_DATADOG_API_KEY>" DDAGENTUSER_NAME="<YOUR_DOMAIN_NAME>\DatadogGMSA$'

설치 구성 옵션

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

참고

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

추가 에이전트 구성 옵션

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

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

참고: 에이전트 7은 Python 3만 지원합니다. 업그레이드하기 전에 사용자 지정 검사가 Python 3과 호환되는지 확인합니다. 자세한 내용은 Python 3 Custom Check Migration 가이드를 참조하세요. 사용자 정의 검사를 사용하지 않거나 이미 호환성을 확인한 경우 일반적인 방법으로 업그레이드합니다.

Datadog 에이전트 버전 5.12.0 미만에서 업그레이드하는 경우, 먼저 EXE 설치 프로그램을 사용하여 최신 버전의 에이전트 5(5.12.0 이상 6.0.0 미만)로 업그레이드한 다음 Datadog 에이전트 버전 6 이상으로 업그레이드합니다.

설치 로그 파일

에이전트 설치 로그 파일은 %TEMP%\MSI*.LOG에서 찾을 수 있습니다.

검증

설치를 확인하려면 에이전트 Status and Information 섹션의 지침을 따르세요.

에이전트 명령어

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

• 주요 실행 파일 이름은 agent.exe입니다. 에이전트 버전에 따라 위치는 다음과 같습니다.
  • 에이전트 버전 6.11 이하: "C:\Program Files\Datadog\Datadog Agent\embedded\agent.exe"
  • 에이전트 버전 6.12 이상: "C:\Program Files\Datadog\Datadog Agent\bin\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
    

설정

Datadog Agent Manager를 사용하여 검사를 활성화, 비활성화 및 구성합니다. 변경 사항을 적용하려면 에이전트를 다시 시작하세요.

주요 에이전트 구성 파일은 다음 위치에 있습니다. C:\ProgramData\Datadog\datadog.yaml

통합을 위한 구성 파일은 다음 위치에 있습니다. C:\ProgramData\Datadog\conf.d\ 또는 C:\Documents and Settings\All Users\Application Data\Datadog\conf.d\

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

에이전트 설치 제거

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

프로그램 추가 또는 제거

1. CTRL 및 Esc를 누르거나 Windows 키를 사용하여 Windows Search를 실행합니다.
2. add를 검색하고 Add or remove programs를 클릭합니다.
3. Datadog 에이전트를 검색하고 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')

트러블슈팅

에이전트 상태 및 정보

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

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

• Datadog 에이전트 시스템 트레이 아이콘 -> 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

로그 위치

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

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

flare 전송

• Datadog 에이전트 Manager를 표시하기 위해 http://127.0.0.1:5002로 이동합니다.

• flare 탭을 선택합니다.

• 티켓 번호를 입력합니다(있는 경우).

• Datadog에 로그인하는 데 사용하는 이메일 주소를 입력하세요.

• Submit을 누릅니다.

PowerShell에서 플레어 명령을 사용할 수 있습니다.

& "$env:ProgramFiles\Datadog\Datadog 에이전트\bin\agent.exe" flare <CASE_ID>

또는 cmd.exe:

"%ProgramFiles%\Datadog\Datadog 에이전트\bin\agent.exe" flare <CASE_ID>

사용 사례

Windows 서비스 모니터링

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

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

자신만의 서비스를 추가할 때 표시된 형식을 정확하게 따라야 합니다. 형식이 올바르지 않으면 통합이 실패합니다. 참고: 서비스 이름의 특수 문자는 이스케이프되어야 합니다. 예를 들어 이름 MSSQL$BILLING은 MSSQL\$BILLING으로 추가할 수 있습니다.

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

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

Windows용 시스템 로드 모니터링

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

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

Windows 프로세스 모니터링

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

datadog.yaml:

process_config:
  enabled: "true"

구성이 완료되면 에이전트를 다시 시작합니다.

참고 자료

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

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