Docs » Splunk Observability Cloud でサポートされているインテグレーション » ホストとサーバーのアプリケーション・レシーバーの設定 » NGINX

NGINX 🔗

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構成に以下を追加します:

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

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

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 で、これは hostport で定義された値をとります。

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/デフォルトにあります。

    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ウェブサーバーを再起動します。

メトリクス 🔗

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

NameDescriptionCategoryType
connections.accepted

Connections accepted by NGINX Web Server

Defaultcumulative
connections.handled

Connections handled by NGINX Web Server

Defaultcumulative
connections.failed

Connections failed by the NGINX Web Server

Customcumulative
nginx_connections.active

Connections active in NGINX Web Server

Defaultgauge
nginx_connections.reading

Connections being read by NGINX Web Server

Defaultgauge
nginx_connections.waiting

Connections waited on by NGINX Web Server

Defaultgauge
nginx_connections.writing

Connections being written by NGINX Web Server

Defaultgauge
nginx_requests

Requests handled by NGINX Web Server

Defaultcumulative

備考 🔗

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

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

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

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

トラブルシューティング 🔗

Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudをご利用のお客様

見込み客および無料トライアルユーザー様

  • Splunk Answers のコミュニティサポートで質問し、回答を得る

  • Join the Splunk #observability user group Slack channel to communicate with customers, partners, and Splunk employees worldwide. To join, see Chat groups in the Get Started with Splunk Community manual.

このページは 2025年02月11日 に最終更新されました。