NGINX 🔗
Splunk Distribution of OpenTelemetry Collectorは、Smart Agentレシーバー と nginx
モニタータイプを使用して、NGINXインスタンスからメトリクスを取得します。
このインテグレーションはLinuxとWindowsで利用できます。
注釈
ネイティブのOpenTelemetryを使用してOpenTelemetry CollectorでNGINXインスタンスを監視するには、NGINXレシーバー コンポーネントを参照してください。
メリット 🔗
インテグレーションを設定すると、これらの機能にアクセスできるようになります:
メトリクスを表示します。独自のカスタム・ダッシュボードを作成することができ、ほとんどのモニターは組み込みのダッシュボードも提供しています。ダッシュボードについては、Splunk Observability Cloudでダッシュボードを表示する を参照してください。
Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他のリソースのデータ駆動型の視覚化を表示します。ナビゲーターについては、Splunk Infrastructure Monitoring でナビゲーターを使用する を参照してください。
Metric Finder にアクセスして、モニターから送信されたメトリクスを検索します。詳細については、メトリクス・ファインダーとメタデータ・カタログを検索する を参照してください。
インストール 🔗
このインテグレーションを導入するには、以下の手順に従ってください:
Splunk Distribution of OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします:
設定のセクションで説明するように、モニターを設定します。
Splunk Distribution of OpenTelemetry Collector を再起動します。
設定 🔗
Smart Agent モニターとCollector のインテグレーションを使用するには、以下の手順に従います:
Smart Agent レシーバーを設定ファイルに含めます。
レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。
Collector でSmart Agent モニターを使用する の方法を参照してください。
Smart Agent レシーバー の設定方法を参照してください。
一般的な設定オプションのリストについては、モニターの共通設定 を参照してください。
Collectorの詳細は、はじめに:Collectorを理解して使用する を参照してください。
例 🔗
このインテグレーションを有効にするには、Collector構成に以下を追加します:
receivers:
smartagent/nginx:
type: collectd/nginx
host: <host>
port: <port>
... # Additional config
次に、設定ファイルの service.pipelines.metrics.receivers
セクションにモニターを追加します:
service:
pipelines:
metrics:
receivers: [smartagent/nginx]
コンフィギュレーション設定 🔗
次の表に、このモニターの設定オプションを示します:
オプション |
必須 |
タイプ |
説明 |
---|---|---|---|
|
はい |
|
|
|
はい |
|
NGINXインスタンスのポート。例えば、 |
|
いいえ |
|
NGINXインスタンスの名前。 |
|
いいえ |
|
|
|
いいえ |
|
HTTPベーシック認証用のユーザー名(必要な場合)。 |
|
いいえ |
|
HTTPベーシック認証のパスワード(必要な場合)。 |
|
いいえ |
|
リクエストのタイムアウト (秒)。デフォルト値は |
Nginxの設定 🔗
NGINXの設定を編集することで、ステータス情報を公開するようにNGINXを設定できます。NGINX ドキュメントサイトの ngx_http_stub_status_module
を参照してください。
Collectorのセットアップが完了したら、以下の手順に従ってNginx Webサーバーを構成し、ステータス メトリクスを公開します:
以下の設定を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; } }
Nginxウェブサーバーを再起動します。
メトリクス 🔗
このインテグレーションでは、以下のメトリクスを使用できます:
Name | Description | Category | Type |
---|---|---|---|
connections.accepted | Connections accepted by NGINX Web Server | Default | cumulative |
connections.handled | Connections handled by NGINX Web Server | Default | cumulative |
connections.failed | Connections failed by the NGINX Web Server | Custom | cumulative |
nginx_connections.active | Connections active in NGINX Web Server | Default | gauge |
nginx_connections.reading | Connections being read by NGINX Web Server | Default | gauge |
nginx_connections.waiting | Connections waited on by NGINX Web Server | Default | gauge |
nginx_connections.writing | Connections being written by NGINX Web Server | Default | gauge |
nginx_requests | Requests handled by NGINX Web Server | Default | cumulative |
備考 🔗
Splunk Observability Cloudで利用可能なメトリクスタイプの詳細は、メトリクスタイプ を参照してください。
ホストベースのサブスクリプションプランでは、デフォルトのメトリクスは、ホスト、コンテナ、バンドルメトリクスなど、Splunk Observability Cloudのホストベースのサブスクリプションに含まれるメトリクスです。カスタムメトリクスはデフォルトでは提供されず、料金が発生する場合があります。詳細については、メトリクスカテゴリ を参照してください。
MTSベースのサブスクリプションプランでは、すべてのメトリクスがカスタムです。
メトリクスを追加するには、その他のメトリクスの追加 で
extraMetrics
の設定方法を参照してください。
トラブルシューティング 🔗
Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。
Splunk Observability Cloudをご利用のお客様
Splunk サポートポータル でケースを送信する
Splunkサポート に連絡する
見込み客および無料トライアルユーザー様
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.