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 URLs
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"
## tags のフィルタ、複数の 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 |
ホスト NIC の送信方向エラー数 |
通常、NIC にエラーの packet 数は存在すべきではない。この数が 0 でない場合、ネットワーク層でエラーが発生していることを意味する |
| exchange |
windows_exchange_workload_active_tasks |
バックグラウンドで workload management のために現在実行中のアクティブタスク数 |
Workload のアクティブタスク数 |
| exchange |
windows_exchange_workload_queued_tasks |
現在処理待ちでキューに入っている workload management task 数 |
現在処理待ちでキューに入っている workload management task 数を示す |
| 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 が 1 秒あたりに処理するリクエスト数 |
OWA が 1 秒あたりに処理したリクエスト数。OWA の繁忙状況を反映する |
| exchange |
windows_exchange_activesync_requests_total |
ASP.NET 経由でクライアントから 1 秒あたりに受信した HTTP リクエスト数 |
ASP.NET 経由でクライアントから 1 秒あたりに受信した 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 操作のレート |