콘텐츠로 이동

Exchange

설치 및 배포

설명: 예시 Exchange exporter 버전은 0.24.0 (Windows)입니다.

DataKit 수집기 활성화

  • DataKit Prom 플러그인을 활성화하고 sample 파일을 복사합니다.
cd C:\Program Files\datakit\conf.d\samples
# prom.conf.sample을 prom.conf로 복사
  • 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
  • DQL 검증
[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 작업 속도입니다.

문서 평가

이 페이지가 도움이 되었나요?