コンテンツにスキップ

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 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
  • 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 ホスト 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 操作のレート

フィードバック

このページは役に立ちましたか?