windows_exporter

Windows_exporter

Windows 머신 용 Prometheus 수출국.

수집가

이름	설명	기본적으로 활성화됩니다
광고	Active Directory 도메인 서비스
ADC	Active Directory 인증 서비스
ADF	Active Directory Federation Services
은닉처	캐시 메트릭
CPU	CPU 사용	✓
cpu_info	CPU 정보
CS	"컴퓨터 시스템"메트릭 (시스템 속성, Num CPU/Total Memory)
컨테이너	컨테이너 메트릭
디스크 리브	디스크를 메트릭
DFSR	DFSR 메트릭
DHCP	DHCP 서버
DNS	DNS 서버
교환	교환 메트릭
파일 타임	파일 타임 메트릭
fsrmquota	Microsoft 파일 서버 리소스 관리자 (FSRM) 할당량 수집기
Hyperv	Hyper-V 호스트
iis	IIS 사이트 및 응용 프로그램
특허	Windows 라이센스 상태
logical_disk	논리 디스크, 디스크 I/O	✓
로그온	사용자 로그온 세션
메모리	메모리 사용 메트릭	✓
mscluster	MSCluster 메트릭
MSMQ	MSMQ 대기열
MSSQL	SQL Server Performance Objects 메트릭
NetFramework	.NET 프레임 워크 메트릭
그물	네트워크 인터페이스 I/O	✓
OS	OS 메트릭 (메모리, 프로세스, 사용자)	✓
페이지 파일	페이지 파일 메트릭
퍼포먼스 카운터	맞춤 성능 카운터 메트릭
물리적 _disk	물리적 디스크 메트릭	✓
인쇄기	프린터 메트릭
프로세스	프로세스 당 메트릭
remote_fx	RDP (RemoteFX Protocol) 메트릭
Scheduled_task	예약 된 작업 메트릭
서비스	서비스 상태 메트릭	✓
SMB	SMB 서버
smbclient	SMB 클라이언트
smtp	IIS SMTP 서버
체계	시스템 호출	✓
TCP	TCP 연결
terminal_services	터미널 서비스 (RDS)
텍스트 파일	텍스트 파일에서 Prometheus 메트릭을 읽으십시오
Thermalzone	열 정보
시간	Windows Time Service
UDP	UDP 연결
업데이트	Windows 업데이트 서비스
vmware	VMware 게스트 에이전트가 설치 한 성능 카운터

보고 된 메트릭, 구성 설정 및 사용 예제에 대한 자세한 내용은 각 수집가의 링크 된 문서를 참조하십시오.

필터링 활성화 수집기

windows_exporter 는 기본적으로 활성화 된 수집기의 모든 메트릭을 노출시킵니다. 이것은 다른 가족의 지표를 비교할 때 오류를 피하기 위해 메트릭을 수집하는 권장 방법입니다.

고급 사용의 경우 windows_exporter 메트릭을 필터링하기 위해 수집기의 선택적 목록을 전달할 수 있습니다. collect[] 매개 변수는 여러 번 사용할 수 있습니다. Prometheus 구성에서는 Scrape 구성 에서이 구문을 사용할 수 있습니다.

  params:
    collect[]:
      - foo
      - bar

이는 다른 Prometheus 서버가 노드에서 특정 메트릭을 수집하는 데 유용 할 수 있습니다.

깃발

Windows_Exporter는 특정 동작을 구성하는 플래그를 수락합니다. 수출 업체의 글로벌 동작을 구성하는 것들은 아래에 나열되어 있으며, 수집기 별 행동은 위의 각 수집기 문서에 문서화되어 있습니다.

깃발	설명	기본값
--web.listen-address	호스트 : 수출품을위한 포트.	:9182
--telemetry.path	수집 된 메트릭을 표면화하기위한 URL 경로.	/metrics
--telemetry.max-requests	최대 동시 요청 수. 0 비활성화하려면.	5
--collectors.enabled	사용할 수있는 수집가 목록. [defaults] 기본적으로 활성화 된 모든 수집기를 포함하여 확장되는 자리 표시 자로 사용하십시오. "	[defaults]
--collectors.print	사실이라면 사용 가능한 수집가를 인쇄하고 종료하십시오.
--scrape.timeout-margin	클라이언트가 허용 한 시간 초과에서 차감하는 데 초. 오버 헤드 또는 높은 하중을 허용하도록 조정하십시오.	0.5
--web.config.file	TLS 및 인증을 설정하기위한 웹 구성	없음
--config.file	Path 또는 URL에서 구성 파일을 사용합니다	없음
--config.file.insecure-skip-verify	URL에서 구성 파일을로드 할 때 TLS를 건너 뜁니다	거짓
--log.file	로그 메시지의 출력 파일. [stdout, stderr, eventLog, <log 파일로가는 경로>] 중 하나입니다. 참고 : MSI 설치 프로그램은 설치된 서비스에 기본 인수를 추가합니다.	Stderr

설치

최신 릴리스는 릴리스 페이지에서 다운로드 할 수 있습니다.

각 릴리스는 .MSI 설치 프로그램을 제공합니다. 설치 프로그램은 Windows_Exporter를 Windows 서비스로 설정하고 Windows 방화벽에서 예외를 생성합니다.

설치 프로그램이 매개 변수없이 실행되면 수출 업체는 활성화 된 수집기, 포트 등에 대한 기본 설정으로 실행됩니다.

설치 프로그램은 수출자를 사용자 정의하기위한 구성 파일을 제공합니다.

구성 파일

• 수출 업체 실행 파일과 동일한 디렉토리에 있습니다.
• YAML 형식이 있으며 --config.file 매개 변수가 제공됩니다.
• 수집기를 활성화 또는 비활성화하고 수집가 별 매개 변수를 설정하고 글로벌 매개 변수를 설정하는 데 사용할 수 있습니다.

다음 매개 변수를 사용할 수 있습니다.

이름	설명
ENABLED_COLLECTORS	--collectors.enabled 플래그로서 쉼표로 구분 된 수집가 목록을 제공합니다.
CONFIG_FILE	--config.file 플래그를 사용하여 구성 파일을 지정하십시오. 비어 있으면 구성 파일이 설정되지 않습니다. Special value config.yaml install dir에서 config.yaml로 경로를 설정합니다.
LISTEN_ADDR	바인딩 할 IP 주소. 기본값은 빈 문자열로 나타납니다. (모든 지역 주소)
LISTEN_PORT	바인딩 할 포트. 기본값 9182 .
METRICS_PATH	지표를 제공하는 길. 기본값 /metrics
TEXTFILE_DIRS	--collector.textfile.directories 플래그를 사용하여 쉼표로 분리 된 하나 이상의 디렉토리를 지정하여 수집기는 메트릭이 포함 된 텍스트 파일을 읽어야합니다.
REMOTE_ADDR	Windows 방화벽 예외를 위해 쉼표를 분리 된 원격 IP 주소를 설정할 수 있습니다 (허용 목록). 기본값은 빈 문자열 (원격 주소)으로 변합니다.
EXTRA_FLAGS	전체 CLI 플래그를 통과 할 수 있습니다. 기본값은 빈 문자열로 나타납니다. --collectors.enabled 및 --config.file 의 경우 특수 속성 ENABLED_COLLECTORS 및 CONFIG_FILE 사용하십시오.
ADDLOCAL	Windows_Exporter 설치 프로그램 내에서 기능을 활성화합니다. 지원되는 값 : FirewallException
REMOVE	Windows_Exporter 설치 프로그램 내에서 기능을 비활성화합니다. 지원되는 값 : FirewallException

매개 변수는 msiexec 통해 설치 프로그램으로 전송됩니다. PowerShell에서는 속성을 정의하기 전에 --% 전달해야합니다.

예제 호출 :

msiexec / i < path - to - msi - file > --% ENABLED_COLLECTORS=os,iis LISTEN_PORT=5000

사용자 정의 쿼리가 포함 된 서비스 수집기 예제.

msiexec / i < path - to - msi - file > --% ENABLED_COLLECTORS=os,service EXTRA_FLAGS="--collectors.exchange.enabled=""ADAccessProcesses"""

구성 파일을 정의합니다.

msiexec / i < path - to - msi - file > --% CONFIG_FILE="D:config.yaml"

일부 이전 버전의 Windows에서는 설치 명령을 올바르게 파싱하기 위해 매개 변수 값을 이중 따옴표로 둘러싸 야 할 수도 있습니다.

msiexec / i C:UsersAdministratorDownloadswindows_exporter.msi --% ENABLED_COLLECTORS="ad,iis,logon,memory,process,tcp,textfile,thermalzone" TEXTFILE_DIRS="C:custom_metrics"

방화벽 예외를 생성하여 Exporter를 설치하려면 다음 명령을 사용하십시오.

msiexec / i < path - to - msi - file > --% ADDLOCAL=FirewallException

PowerShell 버전 7.3 이상은 psnativecommandargumentpassing을 사용할 때 --% EXTRA_FLAGS 사용할 때 Legacy 로 설정해야합니다.

 $PSNativeCommandArgumentPassing = ' Legacy '
msiexec / i < path - to - msi - file > ENABLED_COLLECTORS = os , service --% EXTRA_FLAGS="--collectors.exchange.enabled=""ADAccessProcesses""" 

도커 구현

Windows_exporter는 Docker 컨테이너로 실행할 수 있습니다. Docker 이미지를 사용할 수 있습니다

• Docker Hub : docker.io/prometheuscommunity/windows-exporter
• Github 컨테이너 레지스트리 : ghcr.io/prometheus-community/windows-exporter

태그

Docker 이미지에는 Exporter 버전이 태그됩니다. latest 태그도 사용할 수 있으며 최신 릴리스를 가리 킵니다.

또한 -hostprocess 가있는 풍미 hostprocess 는 https://github.com/microsoft/windows-host-process-containers-base-image를 기반으로합니다. 해당 이미지의 크기는 기본 이미지보다 작습니다.

Kubernetes 구현

Windows Kubernetes에 설치하는 자세한 단계를 참조하십시오.

지원되는 버전

windows_exporter 2016 년 이상 Windows Server 버전 및 Desktop Windows 버전 10 및 11 (21H2 이상)을 지원합니다.

Windows Server 2012 및 2012R2는 최상의 효과로만 지원되지만 작동하지는 않습니다.

용법

 go get -u github.com/prometheus/promu
go get -u github.com/prometheus-community/windows_exporter
cd $env:GOPATH/src/github.com/prometheus-community/windows_exporter
promu build -v
.windows_exporter.exe

Prometheus 지표는 LocalHost : 9182에 노출됩니다

HTTP 종료점

Windows_exporter는 다음과 같은 HTTP 엔드 포인트를 제공합니다.

• /metrics : Prometheus 텍스트 형식에 메트릭을 노출시킵니다.
• /health : 수출업자가 달리면 200을 반환합니다.
• /debug/pprof/ : PPROF 엔드 포인트를 노출시킵니다. --debug.enabled 설정된 경우에만.

예

서비스 수집기 만 활성화하고 사용자 정의 쿼리를 지정하십시오

 .windows_exporter.exe --collectors.enabled "service" --collector.service.include="windows_exporter"

프로세스 수집기 만 활성화하고 사용자 정의 쿼리를 지정하십시오

 .windows_exporter.exe --collectors.enabled "process" --collector.process.include="firefox.+"

이름이 같은 여러 프로세스가있는 경우 WMI는 첫 번째 인스턴스 후 process-name#index 나타냅니다. 따라서 첫 번째 것이 아니라 모든 것을 얻으려면 정규 표현식이 사용해야합니다 .+ . 자세한 내용은 프로세스를 참조하십시오.

--collectors.enabled 인수와 함께 [기본값]을 사용합니다

--collectors.enabled 인수와 함께 [defaults] 을 사용하여 모든 기본 수집기와 함께 확장됩니다.

 .windows_exporter.exe --collectors.enabled "[defaults],process,container"

이를 통해 기본값 위에 추가 프로세스 및 컨테이너 수집기가 가능합니다.

구성 파일 사용

yaml 구성 파일은 --config.file 플래그로 지정할 수 있습니다. 예를 들어 .windows_exporter.exe --config.file=config.yml . 절대 경로를 사용하는 경우 경로 .windows_exporter.exe --config.file="C:Program Fileswindows_exporterconfig.yml"

URL에서 구성을로드 할 수도 있습니다. 예를 들어 .windows_exporter.exe --config.file="https://example.com/config.yml"

TLS Verification을 건너 뛰어야하는 경우 --config.file.insecure-skip-verify 플래그를 사용할 수 있습니다. 예를 들어 .windows_exporter.exe --config.file="https://example.com/config.yml" --config.file.insecure-skip-verify

 collectors :
  enabled : cpu,net,service
collector :
  service :
    include : windows_exporter
log :
  level : warn

예제 구성 파일은 여기에서 찾을 수 있습니다.

구성 파일 참고

구성 파일 값은 CLI 플래그와 혼합 될 수 있습니다. 예를 들어

.windows_exporter.exe --collectors.enabled=cpu,logon

 log :
  level : debug

CLI 플래그는 구성 파일에 지정된 값보다 우선 순위가 높습니다.

특허

MIT 아래