NGINXレシーバー

NGINX レシーバーは、ngx_http_stub_status_module モジュールのステータスエンドポイントを使って、NGINX インスタンスから統計情報を取得します。

NGINX レシーバーは、ngx_http_stub_status_module モジュールの status エンドポイントを使って、NGINX インスタンスから統計情報を取得します。サポートされているパイプラインのタイプは metrics です。詳細については「パイプラインでデータを処理する」を参照してください。

ステータス情報を公開するには、NGINX を設定する必要があります。方法については、NGINX ドキュメントサイトの「HTTP status module config guide」を参照してください。

注: すぐに使えるダッシュボードとナビゲーターは NGINX Server レシーバーではサポートされていません。

はじめに

以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください：

  1. Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：

  2. 次のセクションで説明するようにレシーバーを設定します。

  3. Collector を再起動します。

サンプル構成

NGINXレシーバーを有効にするには、次の例のように、設定ファイルの nginx セクションに receivers を追加します：

receivers:
  nginx:
    endpoint: "http://localhost:80/status"
    collection_interval: 10s

設定を完了するには、構成ファイルの service セクションの metrics パイプラインにレシーバーを含めます。例：

service:
  pipelines:
    metrics:
      receivers: [nginx]

設定オプション

以下の設定が利用できます：

  • endpointします。必須。デフォルトでは http://localhost:80/status です。NGINX ステータスエンドポイントの URL。

  • collection_interval。デフォルトでは 10s です。このレシーバーがメトリクスを収集する間隔を設定します。

    • この値は、Golang の time.ParseDuration で読み取り可能な文字列である必要があります。詳細は Go の公式ドキュメント「ParseDuration function」を参照してください。

    • 有効な時間単位は ns、us （ µs ）、ms、s、m、h です。

  • initial_delay。デフォルトでは 1s です。このレシーバーが初めてメトリクスを収集するまでの待機時間を決定します。

設定

次の表に、NGINXレシーバーの設定オプションを示します：

同梱

https://raw.githubusercontent.com/splunk/collector-config-tools/main/cfg-metadata/receiver/nginx.yaml

メトリクス

以下のメトリクス、リソース属性、および属性が使用できます。

同梱

https://raw.githubusercontent.com/splunk/collector-config-tools/main/metric-metadata/nginxreceiver.yaml

注意: デフォルトでは、NGINX レシーバーは nginx_connections.reading、nginx_connections.waiting、nginx_connections.writing のメトリクスを提供しません。

特定のメトリクスをアクティブまたは非アクティブにする

各メトリクスの metrics セクションの enabled フィールドを設定することで、特定のメトリクスをアクティブまたは非アクティブにできます。例：

receivers:
  samplereceiver:
    metrics:
      metric-one:
        enabled: true
      metric-two:
        enabled: false

以下は、アクティブ化されたメトリクスを持つホスト・メトリクス・レシーバーの構成例です：

receivers:
  hostmetrics:
    scrapers:
      process:
        metrics:
          process.cpu.utilization:
            enabled: true
注: 非アクティブ化されたメトリックは Splunk Observability Cloud に送信されません。
請求

  • MTS ベースのサブスクリプションの場合、すべてのメトリックがメトリックの使用にカウントされます。

  • ホストベースのプランを使用している場合、このドキュメントでアクティブ（アクティブ：はい）としてリストされているメトリックはデフォルトと見なされ、無料で含まれています。

詳細については、「Infrastructure Monitoringのサブスクリプション使用状況（ホストとメトリクスのプラン）」を参照してください。

トラブルシューティング

__ ___ ___ _ ______ _____________ _____ ________ ___ ___ ___ ____ __ ___ ____ ____ __ ______ _____________ ______ ___ ___ ___ ____ __ ___ _________ _____

_________ __ ______ _____________ _____ _________

_________ __ ___________ _________ ___ ____ _____ _____

  • ___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________

  • ____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______