HAProxy OTelメトリクスのリファレンス

このページでは、haproxyreceiverおよびPrometheusレシーバーパスを含む、OpenTelemetry経由で収集されたすべてのHAProxyメトリクスの完全なリファレンスを提供します。

概要

HAProxyのOpenTelemetryインテグレーションは、haproxyreceiverを介してHAProxy CSV statsエンドポイントからメトリクスを収集します。メトリクスは2つのティアに編成されています：

デフォルトのメトリクス（17）: デフォルトの設定で自動的に収集されます — ほとんどの監視ユースケースに十分です
オプションのメトリクス（16）：デフォルトでは無効ですが、レシーバーのmetricsセクションで個別に有効にできます — 詳細なデバッグやキャパシティプランニングに役立ちます

NRDOTのガイド付きインストールを使用する場合、2つの設定から選択できます：

最適化（取り込み量の削減）: 17のデフォルトメトリクス、60秒の収集間隔、最適化プロセッサの適用
包括的（詳細）: 27のメトリクス（デフォルト17+オプション10）、15秒の収集間隔

ヒント

オプションのメトリクスを有効にするには、enabled: trueを使用してhaproxyレシーバー設定のmetricsセクションにそれらを追加します。設定の詳細については、OpenTelemetryを使用したセルフホスト型HAProxyのモニターを参照してください。

デフォルトのメトリクス

これら17のメトリクスはデフォルトの設定で収集されます（metricsセクションは不要です）。

メトリクス名	説明	タイプ	ユニット
`haproxy.bytes.input`	プロキシが受信した合計バイト数（フロントエンド、バックエンド、およびサーバーごとに収集）	合計（累積）	作成者
`haproxy.bytes.output`	プロキシによって送信された合計バイト数（フロントエンド、バックエンド、およびサーバーごとに収集）	合計（累積）	作成者
`haproxy.connections.errors`	接続エラーの総数（バックエンドとサーバーのみ）	合計（累積）	{errors}
`haproxy.connections.rate`	過去1秒間の1秒あたりの接続数（フロントエンドのみ）	ゲージ	{connections}/s
`haproxy.connections.retries`	接続再試行の合計数（バックエンドとサーバーのみ）	合計（累積）	{retries}
`haproxy.requests.denied`	拒否されたrequestsの合計数（フロントエンドおよびバックエンド）	合計（累積）	{requests}
`haproxy.requests.errors`	リクエストエラーの合計数（フロントエンドのみ）	合計（累積）	{errors}
`haproxy.requests.queued`	キューに入れられた現在のrequests数（バックエンドとサーバーのみ）	ゲージ	{requests}
`haproxy.requests.rate`	過去1秒間の1秒あたりのHTTP requests数（フロントエンドのみ）	ゲージ	{requests}/s
`haproxy.requests.redispatched`	リクエストの再ディスパッチの合計数（バックエンドおよびサーバーのみ）	合計（累積）	{requests}
`haproxy.requests.total`	受信したHTTP requestsの合計数（フロントエンドとバックエンド）	合計（累積）	{requests}
`haproxy.responses.denied`	拒否された応答の合計数（フロントエンド、バックエンド、およびサーバー）	合計（累積）	{responses}
`haproxy.responses.errors`	レスポンスエラーの合計数（バックエンドとサーバーのみ）	合計（累積）	{errors}
`haproxy.server_selected.total`	サーバーがロードバランシングのために選択された合計回数（バックエンドとサーバー）	合計（累積）	{selections}
`haproxy.sessions.average`	過去1024 requestsの平均合計セッション時間（秒単位）（バックエンドとサーバー）	ゲージ	s
`haproxy.sessions.count`	アクティブなセッションの現在の数（フロントエンド、バックエンド、およびサーバー）	ゲージ	{sessions}
`haproxy.sessions.rate`	過去1秒間の1秒あたりのセッション数（フロントエンド、バックエンド、およびサーバー）	ゲージ	{sessions}/s

オプションのメトリクス

これら16のメトリクスは、デフォルトで無効になっています。レシーバーのmetricsセクションでenabled: trueを設定することにより、コレクターの設定で個別に有効にします。

NRDOTの包括的な設定では、これらの最初の10個（［C］でマーク）が有効になります。

メトリクス名	説明	タイプ	ユニット
`haproxy.connections.average_time` [C]	秒単位の平均接続時間（レイテンシ監視）	ゲージ	s
`haproxy.requests.average_time` [C]	秒単位のrequestsの平均キュー時間	ゲージ	s
`haproxy.responses.average_time` [C]	秒単位の平均応答時間	ゲージ	s
`haproxy.active` [C]	バックエンド内のアクティブなサーバーの数	ゲージ	{servers}
`haproxy.backup` [C]	バックエンド内のバックアップサーバーの数	ゲージ	{servers}
`haproxy.downtime` [C]	合計ダウンタイム（秒）	合計（累積）	s
`haproxy.failed_checks` [C]	失敗したヘルスチェックの合計数	合計（累積）	{checks}
`haproxy.weight` [C]	サーバーの重み（ロードバランシングの決定に使用）	ゲージ	{weight}
`haproxy.sessions.total` [C]	セッションの累積合計数	合計（累積）	{sessions}
`haproxy.connections.total` [C]	累積接続の合計数	合計（累積）	{connections}
`haproxy.compression.input`	コンプレッサーに送信されたバイトの合計数	合計（累積）	作成者
`haproxy.compression.output`	コンプレッサーが出力したバイトの合計数	合計（累積）	作成者
`haproxy.compression.bypass`	圧縮をバイパスしたバイトの合計数	合計（累積）	作成者
`haproxy.compression.responses`	圧縮されたHTTPレスポンスの合計数	合計（累積）	{responses}
`haproxy.clients.canceled`	クライアントによって中止されたデータ転送の合計数	合計（累積）	{cancellations}
`haproxy.sessions.limit`	プロキシに設定されたセッション制限	ゲージ	{sessions}

リソース属性

以下のリソース属性はすべてのHAProxyメトリクスに付与され、フィルタリングとグループ化のコンテキストを提供します。

属性	説明	値の例
`haproxy.proxy_name`	HAProxyプロキシの名前（haproxy.cfgのfrontend/backend/listenセクション名から）	`http_front` 、 `flask_backends` 、 `stats`
`haproxy.service_name`	タイプ識別子またはサーバー名：フロントエンド集計の場合は `FRONTEND` 、バックエンド集計の場合は `BACKEND` 、サーバーごとのメトリクスの場合は特定のサーバー名	`FRONTEND` 、 `BACKEND` 、 `backend-app-a` 、 `backend-app-b`
`haproxy.addr`	スクレイピングされたstatsエンドポイントURL（エンティティ識別子の一部として使用）	`http://localhost:8404/stats`
`host.id`	ホストの固有識別子（Linux上の `/etc/machine-id` から）	`ec23da5ead46571f2c3a9771b093658b`
`host.name`	コレクターを実行しているマシンのホスト名	`ip-172-31-7-195.ap-southeast-2.compute.internal`
`os.type`	OSタイプ	`linux`

エンティティ識別子: New RelicのHAProxyエンティティは、host.id+haproxy.addr（たとえばec23da5ead46571f2c3a9771b093658b:http://localhost:8404/stats）から合成されます。

Prometheusメトリクスマッピング

Prometheusレシーバーパスを使用している場合、次の表は、HAProxy Prometheusのメトリクス名がOTel haproxyreceiverの対応するものにどのようにマッピングされるかを示しています。各OTelメトリクスには、複数のPrometheusソースがある場合があります（ティアごとに1つ：フロントエンド、バックエンド、サーバー）。

OTelメトリックス	Prometheusフロントエンド	Prometheusバックエンド	Prometheusサーバー
`haproxy.bytes.input`	`haproxy_frontend_bytes_in_total`	`haproxy_backend_bytes_in_total`	`haproxy_server_bytes_in_total`
`haproxy.bytes.output`	`haproxy_frontend_bytes_out_total`	`haproxy_backend_bytes_out_total`	`haproxy_server_bytes_out_total`
`haproxy.connections.errors`	—	`haproxy_backend_connection_errors_total`	`haproxy_server_connection_errors_total`
`haproxy.connections.rate`	`haproxy_frontend_connections_rate_max`	—	—
`haproxy.connections.retries`	—	`haproxy_backend_retry_warnings_total`	`haproxy_server_retry_warnings_total`
`haproxy.requests.denied`	`haproxy_frontend_requests_denied_total`	`haproxy_backend_requests_denied_total`	—
`haproxy.requests.errors`	`haproxy_frontend_request_errors_total`	—	—
`haproxy.requests.queued`	—	`haproxy_backend_current_queue`	`haproxy_server_current_queue`
`haproxy.requests.rate`	`haproxy_frontend_http_requests_rate_max`	—	—
`haproxy.requests.redispatched`	—	`haproxy_backend_redispatch_warnings_total`	`haproxy_server_redispatch_warnings_total`
`haproxy.requests.total`	`haproxy_frontend_http_requests_total`	`haproxy_backend_http_requests_total`	—
`haproxy.responses.denied`	`haproxy_frontend_responses_denied_total`	`haproxy_backend_responses_denied_total`	`haproxy_server_responses_denied_total`
`haproxy.responses.errors`	—	`haproxy_backend_response_errors_total`	`haproxy_server_response_errors_total`
`haproxy.server_selected.total`	—	`haproxy_backend_loadbalanced_total`	`haproxy_server_loadbalanced_total`
`haproxy.sessions.average`	—	`haproxy_backend_total_time_average_seconds`	`haproxy_server_total_time_average_seconds`
`haproxy.sessions.count`	`haproxy_frontend_current_sessions`	`haproxy_backend_current_sessions`	`haproxy_server_current_sessions`
`haproxy.sessions.rate`	`haproxy_frontend_max_session_rate`	`haproxy_backend_max_session_rate`	`haproxy_server_max_session_rate`

重要

Prometheusパスの既知の制限事項：

ステータスコードごとのFACETなし: haproxyreceiverは、hrsp_*のCSVフィールドをhaproxy.requests.totalのstatus_code属性に解析します。Prometheusパスはこれをサポートしていません — HTTPレスポンスコードの内訳は、変換設定に含まれない個別のメトリクス（haproxy_frontend_http_responses_total{code="2xx"}）としてのみ利用可能です。
レートメトリクスはライフタイムの最大値です: haproxy.connections.rateはhaproxy_frontend_connections_rate_maxにマッピングされ、haproxy.requests.rateはhaproxy_frontend_http_requests_rate_maxにマッピングされます。これらはライフタイム最大値であり、瞬間レートではありません。実際の現在のレートについては、累積カウンターメトリクスに対してrate() NRQL関数を使用してください。
約136のPrometheusメトリクスにはOTelの同等物がありません: HAProxyのPrometheusエンドポイントは約204のメトリクスを公開します。17のOTelデフォルトメトリクスにマッピングされているのは36のみです（フロントエンド/バックエンド/サーバーのティア全体で）。残り（プロセスの内部、ヘルスチェックの詳細、DNSリゾルバーの統計）には、haproxyreceiverの同等物がありません。

NRQLクエリのサンプル

これらのクエリを使用して、New RelicでHAProxyメトリクスを探索します：

-- Current sessions across all frontends
FROM Metric SELECT latest(haproxy.sessions.count)
FACET haproxy.proxy_name
WHERE haproxy.service_name = 'FRONTEND'

-- Request rate per frontend over time
FROM Metric SELECT average(haproxy.requests.rate)
FACET haproxy.proxy_name
WHERE haproxy.service_name = 'FRONTEND'
TIMESERIES

-- Backend error rate (responses.errors as rate)
FROM Metric SELECT rate(sum(haproxy.responses.errors), 1 second)
FACET haproxy.proxy_name
WHERE haproxy.service_name = 'BACKEND'
TIMESERIES

-- Bytes throughput per backend
FROM Metric SELECT rate(sum(haproxy.bytes.input), 1 minute) AS 'Bytes In/min',
  rate(sum(haproxy.bytes.output), 1 minute) AS 'Bytes Out/min'
FACET haproxy.proxy_name
WHERE haproxy.service_name = 'BACKEND'

-- Average session time per backend (latency indicator)
FROM Metric SELECT average(haproxy.sessions.average)
FACET haproxy.proxy_name
WHERE haproxy.service_name = 'BACKEND'

-- Per-server session count (individual backend servers)
FROM Metric SELECT latest(haproxy.sessions.count)
FACET haproxy.proxy_name, haproxy.service_name
WHERE haproxy.service_name NOT IN ('FRONTEND', 'BACKEND')

-- Queued requests (indicates backend saturation)
FROM Metric SELECT max(haproxy.requests.queued)
FACET haproxy.proxy_name
WHERE haproxy.service_name = 'BACKEND'
TIMESERIES

次のステップ

HAProxyデータの検索とクエリ — ダッシュボード、NRQLクエリ、およびデータナビゲーション
セルフホスト型HAProxyをモニターする — Linux VMまたはベアメタルのセットアップ
Kubernetes上のHAProxyをモニターする — コンテナ化された環境の自動ポッド検出
NRQLアラート条件の作成 — HAProxyメトリクスに基づいてアラートを設定する

この機械翻訳は、参考として提供されています。