NGINX

NGINX モニターには、この Splunk Observability Cloud インテグレーションを使用してください。メリット、インストール、設定、メトリクスを参照してください

Splunk Distribution of OpenTelemetry Collectorは、Smart Agentレシーバー と nginx モニタータイプを使用して、NGINXインスタンスからメトリクスを取得します。

このインテグレーションはLinuxとWindowsで利用できます。

注: ネイティブの OpenTelemetry を使用して OpenTelemetry Collector で NGINX インスタンスを監視するには、「NGINX レシーバー」コンポーネントを参照してください。

メリット

インテグレーションを設定すると、これらの機能にアクセスできるようになります：

インストール

このインテグレーションを導入するには、以下の手順に従ってください：

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

  2. 設定のセクションで説明するように、モニターを設定します。

  3. Splunk Distribution of OpenTelemetry Collector を再起動します。

設定

Smart Agent モニターとCollector のインテグレーションを使用するには、以下の手順に従います：

  1. Smart Agent レシーバーを設定ファイルに含めます。

  2. レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。

例

このインテグレーションを有効にするには、Collector構成に以下を追加します：

YAML 
receivers:
  smartagent/nginx:
    type: collectd/nginx
    host: <host>
    port: <port>
    ...  # Additional config

次に、設定ファイルの service.pipelines.metrics.receivers セクションにモニターを追加します：

YAML 
service:
  pipelines:
    metrics:
      receivers: [smartagent/nginx]

コンフィギュレーション設定

次の表に、このモニターの設定オプションを示します：

オプション

必須

タイプ

説明

host

あり

string

 NGINX インスタンスのホスト名または IP アドレス。次の例を参考にしてください。

127.0.0.1します。

port

あり

integer

NGINX インスタンスのポート。たとえば、8080 のようになります。

name

いいえ

string

NGINXインスタンスの名前。

url

いいえ

string

 ステータスエンドポイントの URL。デフォルト値は、

http://{{.Host}}:{{.Port}}/nginx_status で、これは host と port で定義された値をとります。

username

いいえ

string

HTTPベーシック認証用のユーザー名（必要な場合）。

password

いいえ

string

HTTPベーシック認証のパスワード（必要な場合）。

timeout

いいえ

integer

リクエストのタイムアウト（秒）。デフォルト値は 0 です。

Nginxの設定

NGINX の設定を編集することで、ステータス情報を公開するように NGINX を設定できます。NGINX ドキュメントサイトの ngx_http_stub_status_module を参照してください。

Collector のセットアップが完了したら、以下の手順に従って、ステータスメトリクスを公開するように Nginx Web サーバーを設定します。

  1. Nginx サーバーに以下の設定を追加します。デフォルトの nginx サーバーの設定は /etc/nginx/sites-enabled/default にあります。

    DEFAULT 
    server {
  location /nginx_status {
    stub_status on;
    access_log off;
    allow 127.0.0.1; # The source IP address of OpenTelemetry Collector.
    deny all;
  }
}

  2. Nginxウェブサーバーを再起動します。

メトリクス

このインテグレーションでは、以下のメトリクスを使用できます：

https://raw.githubusercontent.com/signalfx/splunk-otel-collector/main/internal/signalfx-agent/pkg/monitors/collectd/nginx/metadata.yaml

備考

  • Splunk Observability Cloud で利用可能なメトリクスタイプの詳細は、「メトリクスタイプ」を参照してください。

  • ホストベースのサブスクリプションプランでは、デフォルトのメトリクスは、ホスト、コンテナ、バンドルメトリクスなど、Splunk Observability Cloud のホストベースのサブスクリプションに含まれるメトリクスです。カスタムメトリクスはデフォルトでは提供されていないため、料金が発生する場合があります。詳細については、「メトリクスカテゴリ」を参照してください。

  • MTSベースのサブスクリプションプランでは、すべてのメトリクスがカスタムです。

  • メトリクスを追加するには、「その他のメトリクスの追加」で extraMetrics の設定方法を参照してください。

トラブルシューティング

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.