Exchange
설치 및 배포
설명: 예시 Exchange exporter 버전은 0.24.0 (Windows)입니다.
DataKit 수집기 활성화
- DataKit Prom 플러그인을 활성화하고 sample 파일을 복사합니다.
cd C:\Program Files\datakit\conf.d\samples
# prom.conf.sample을 prom.conf로 복사
설정은 다음과 같습니다
[[inputs.prom]]
## Exporter URL
urls = ["http://127.0.0.1:9182/metrics"]
## url 요청 오류를 무시합니다
ignore_req_err = false
## 수집기 별칭
source = "exchange"
## 수집 데이터 출력 원본
# 이 항목을 설정하면 수집한 데이터를 중앙으로 보내지 않고 로컬 파일에 기록할 수 있습니다.
# 이후 datakit --prom-conf /path/to/this/conf 명령으로 로컬에 저장된 메트릭 세트를 직접 디버깅할 수 있습니다.
# url을 로컬 파일 경로로 설정한 경우, --prom-conf는 output 경로의 데이터를 우선적으로 디버깅합니다.
# output = "/abs/path/to/file"
>
## 수집 데이터 크기 상한, 단위는 바이트입니다
# 데이터를 로컬 파일로 출력할 때 수집 데이터 크기 상한을 설정할 수 있습니다.
# 수집 데이터의 크기가 이 상한을 초과하면 수집된 데이터는 버려집니다.
# 수집 데이터 크기 상한의 기본값은 32MB입니다.
# max_file_size = 0
## 메트릭 유형 필터, 가능한 값: counter, gauge, histogram, summary
# 기본적으로 counter와 gauge 유형의 메트릭만 수집합니다.
# 비어 있으면 필터링하지 않습니다.
metric_types = ["counter", "gauge"]
## 메트릭 이름 필터
# 정규식을 지원하며, 여러 개를 설정할 수 있고 그중 하나만 만족해도 됩니다.
# 비어 있으면 필터링하지 않습니다.
# metric_name_filter = ["cpu"]
## 메트릭 세트 이름 접두사
# 이 항목을 설정하면 메트릭 세트 이름에 접두사를 추가할 수 있습니다.
measurement_prefix = ""
## 메트릭 세트 이름
# 기본적으로 메트릭 이름을 밑줄 "_" 기준으로 분리하며, 분리된 첫 번째 필드를 메트릭 세트 이름으로 사용하고 나머지 필드를 현재 메트릭 이름으로 사용합니다.
# measurement_name을 설정하면 메트릭 이름 분리를 수행하지 않습니다.
# 최종 메트릭 세트 이름에는 measurement_prefix 접두사가 추가됩니다.
# measurement_name = "prom"
## 수집 간격 "ns", "us" (or "µs"), "ms", "s", "m", "h"
interval = "10s"
## 태그 필터, 여러 tag를 설정할 수 있습니다
# 일치하는 tag는 무시됩니다.
# tags_ignore = ["xxxx"]
## TLS 설정
tls_open = false
# tls_ca = "/tmp/ca.crt"
# tls_cert = "/tmp/peer.crt"
# tls_key = "/tmp/peer.key"
## 사용자 지정 인증 방식, 현재는 Bearer Token만 지원합니다
# token과 token_file 중 하나만 설정하면 됩니다.
# [inputs.prom.auth]
# type = "bearer_token"
# token = "xxxxxxxx"
# token_file = "/tmp/token"
## 사용자 지정 메트릭 세트 이름
# prefix를 포함하는 메트릭을 하나의 메트릭 세트로 묶을 수 있습니다.
# 사용자 지정 메트릭 세트 이름 설정은 measurement_name 설정보다 우선합니다.
#[[inputs.prom.measurements]]
# prefix = "cpu_"
# name = "cpu"
# [[inputs.prom.measurements]]
# prefix = "mem_"
# name = "mem"
## 사용자 지정 Tags
[inputs.prom.tags]
service = "exchange"
# more_tag = "some_other_value"
- DataKit을 재시작합니다. (로그를 활성화해야 하는 경우, 로그 수집 설정을 먼저 구성한 뒤 재시작하세요.)
systemctl restart datakit
[root@df-solution-ecs-018 prom]# datakit -Q
Flag -Q deprecated, please use datakit help to use recommend flags.
dqlcmd: &cmds.dqlCmd{json:false, autoJSON:false, verbose:false, csv:"", forceWriteCSV:false, dqlString:"", token:"tkn_9a49a7e9343c432eb0b99a297401c3bb", host:"0.0.0.0:9529", log:"", dqlcli:(*http.Client)(0xc0009a5800)}
dql > M::exchange LIMIT 1
-----------------[ r1.exchange.s1 ]-----------------
windows_ad_atq_average_request_latency 0
windows_ad_atq_current_threads 44
windows_ad_atq_outstanding_requests 0
windows_ad_ldap_client_sessions '1.0'
windows_ad_replication_inbound_properties_updated_total '0.0'
windows_ad_replication_pending_operations '0.0'
.....
windows_cs_hostname 2
windows_cs_physical_memory_bytes 0
time 2023-11-1 16:00:10 +0800 CST
windows_exchange_owa_requests_total 0
windows_exchange_rpc_user_count 0
windows_exporter_build_info 0
uptime 2858680025
windows_exporter_collector_duration_seconds 0
---------
1 rows, 1 series, cost 40.297037ms
지표 상세
General 분류
| 지표집합 |
지표 |
의미 |
지표 의미 |
| exchange |
windows_exchange_owa_current_unique_users |
현재 Outlook Web App에 로그인 중인 고유 사용자 수 |
OWA를 사용하는 활성 사용자 수를 모니터링합니다. |
| exchange |
windows_net_packets_outbound_errors_total |
호스트 네트워크 카드의 송신 방향 오류 수 |
정상적인 경우 네트워크 카드에 오류 패킷이 없어야 하며, 이 값이 0이 아니면 네트워크 계층에 오류가 있음을 의미합니다. |
| exchange |
windows_exchange_workload_active_tasks |
워크로드 관리용 백그라운드에서 현재 실행 중인 활성 작업 수 |
Workload의 활성 작업 수 |
| exchange |
windows_exchange_workload_queued_tasks |
현재 처리 대기 중인 워크로드 관리 작업 수 |
현재 처리 대기 중인 워크로드 관리 작업 수를 보여줍니다. |
| exchange |
usage_total |
CPU 사용률 |
부하를 반영합니다. |
| exchange |
available |
사용 가능한 메모리 양 |
부하를 반영합니다. |
Web 분류
| 지표집합 |
지표 |
의미 |
모니터링 의미 |
| exchange |
windows_exchange_owa_current_unique_users |
현재 Outlook Web App에 로그인 중인 고유 사용자 수 |
OWA를 사용하는 활성 사용자 수를 모니터링하며, 위와 동일합니다. |
| exchange |
windows_exchange_owa_requests_total |
Outlook Web App이 초당 처리한 요청 수 |
OWA의 초당 요청 처리 수로, OWA의 바쁨 정도를 반영합니다. |
| exchange |
windows_exchange_activesync_requests_total |
ASP.NET을 통해 클라이언트로부터 초당 수신한 HTTP 요청 수. 현재 사용자 부하를 보여줍니다. |
ASP.NET을 통해 클라이언트에서 초당 수신한 HTTP 요청 수를 보여줍니다. 현재 Exchange ActiveSync 요청 비율을 파악합니다. |
RPC 분류
| 지표집합 |
지표 |
의미 |
모니터링 의미 |
| exchange |
windows_exchange_rpc_connection_count |
유지 중인 클라이언트 연결의 총수 |
유지되는 클라이언트 연결 총수를 보여줍니다. |
| exchange |
windows_exchange_rpc_user_count |
사용자 수 |
서비스에 연결된 사용자 수를 보여줍니다. |
| exchange |
windows_exchange_rpc_avg_latency_sec |
지난 1024개 패킷의 평균 지연 시간(초) |
지난 1,024개 패킷의 평균 지연 시간(밀리초)을 보여줍니다. 250ms 미만이어야 합니다. RPC 응답 값이 높으면 사용자 경험과 Outlook 처리 시간에 영향을 줍니다. |
| exchange |
windows_exchange_rpc_operations_total |
RPC 작업이 발생하는 속도 |
RPC 작업 속도입니다. |