このリファレンスは、 OpenTelemetry NGINX レシーバーによって収集されたすべてのメトリクスとプロパティをカバーしており、オンホストとKubernetesデプロイメントの両方に適用されます。
コア NGINX メトリクス
OpenTelemetry Collector Contrib のnginxreceiver は、NGINX スタブ ステータス モジュールから次のメトリクスを収集します。
メトリック | 説明 | タイプ |
|---|---|---|
| 受け入れられたクライアント接続の合計数。これを使用して、時間の経過に伴う接続受け入れ率を追跡します。 | サム |
| 処理された接続の合計数。一般に、問題の値は nginx.connections_accepted と同じです。 一部のリソース制限(たとえば、worker_connections 制限)に達していない限り。承認と処理の間のギャップは、リソースの制約を示唆しています。 | サム |
| 状態別の現在の nginx 接続数。状態には、アクティブ(アクティブな接続の合計)、読み取り中(要求ヘッダーの読み取り)、書き込み中(応答の書き込み)、待機中(次の要求を待機しているキープアライブ接続) が含まれます。 | サム |
| サーバーの起動以降にサーバーに対して行われたrequestsの合計数。 レート計算を使用して、パフォーマンス監視の 1 秒あたりのrequestsを導き出します。 | サム |
キャパシティプランニングのヒント:
waiting接続数が多い場合は、キープアライブの調整が必要になる可能性がありますacceptedとhandled接続間のギャップはリソースの制約を示唆しています- リクエストと接続の比率はワーカー設定の最適化に役立ちます
リソース属性
リソース属性は、NGINX デプロイメントに関するコンテキストを提供し、オンホスト デプロイメントを使用しているか、Kubernetes デプロイメントを使用しているかによって異なります。
共通の属性
属性 | 説明 | 値の例 |
|---|---|---|
| 接続の状態( |
|
| NGINX スタブ ステータスのエンドポイント URL |
|
オンホスト デプロイメント プロパティ
属性 | 説明 | 値の例 |
|---|---|---|
| この NGINX デプロイメントを識別するための一意の名前 |
|
| 「サーバー」プレフィックスとデプロイメント名を組み合わせた表示フレンドリーな名前 |
|
| NGINXが動作しているシステムのホスト名 |
|
| ホストシステムの一意の識別子 |
|
| 収集されるログのタイプ (ログのみに適用されます)。 New Relic の組み込み解析ルールによって使用されます。この属性は、ログ転送が有効になっている場合にのみ使用できます。 |
|
Kubernetes デプロイメント属性
属性 | 説明 | 値の例 |
|---|---|---|
| Kubernetesクラスターの名前 |
|
| NGINX ポッドが実行されているKubernetesネームスペース |
|
| NGINX を実行しているKubernetesの名前 |
|
| Kubernetes デプロイメントのポッド名を設定します |
|
| クラスタ、ネームスペース、ポッド情報を含む包括的な表示名 |
|
メトリクスコレクションの詳細
収集頻度
- デフォルトの間隔: 30秒
- 設定可能: OpenTelemetry Collector の設定で調整可能
情報源
すべてのメトリクスは NGINX stub_status モジュールから収集されます。HTTP エンドポイントを公開するには、このモジュールを有効にして構成する必要があります。
メトリックのタイプ
- 合計メトリクス: 時間の経過に伴う合計を表す累積値
- レート計算: New Relicの
rate()関数を使用して、累積メトリクスを監視用の 1 秒あたりのレートに変換します
関連ドキュメント
セットアップガイド:
- セルフホスト環境での NGINX の監視- オンホスト展開のセットアップを完了する
- Kubernetes上の NGINX をモニターする- Kubernetesデプロイメントのセットアップを完了する
データ使用量:
- NGINX データを検索して書き込みます- Dashboards 、 NRQL書き込み、およびアラート
技術リファレンス:
- NGINX レシーバーのドキュメント- OpenTelemetry の技術詳細