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 を追加します：

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

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

YAML 
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 フィールドを設定することで、特定のメトリクスをアクティブまたは非アクティブにできます。例：

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

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

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

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

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

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

トラブルシューティング

If you are a Splunk Observability Cloud customer and are not able to see your data in Splunk Observability Cloud, you can get help in the following ways.

Available to Splunk Observability Cloud customers

Available to prospective customers and free trial users

  • Ask a question and get answers through community support at Splunk Answers.

  • Join the Splunk community #observability Slack channel to communicate with customers, partners, and Splunk employees worldwide.