PrometheusNGINXイングレス 🔗

The Splunk Distribution of OpenTelemetry Collector uses the Smart Agent receiver with the prometheus-nginx-ingress monitor type to wrap the Prometheus・エクスポーター to collect Ingress NGINX metrics for Splunk Observability Cloud.

このインテグレーションは、VTS に代わる Prometheus のメトリクス実装に依存しています。NGINX 0.15 以下を使用している場合は、Prometheus NGINX VTS のインテグレーションを使用してください。

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

メリット 🔗

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

メトリクスを表示します。独自のカスタム・ダッシュボードを作成することができ、ほとんどのモニターは組み込みのダッシュボードも提供しています。ダッシュボードについては、Splunk Observability Cloudでダッシュボードを表示するを参照してください。
Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他のリソースのデータ駆動型の視覚化を表示します。ナビゲーターについては、Splunk Infrastructure Monitoring でナビゲーターを使用するを参照してください。
Metric Finder にアクセスして、モニターから送信されたメトリクスを検索します。詳細については、Search the Metric Finder and Metadata Catalog を参照してください。

インストール 🔗

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

Splunk Distribution of OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
- Kubernetesにインストールする
- Linuxにインストールする
設定のセクションで説明するように、モニターを設定します。
Splunk Distribution of OpenTelemetry Collector を再起動します。

設定 🔗

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

Smart Agent レシーバーを設定ファイルに含めます。
レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。

Collector でSmart Agent モニターを使用するの方法を参照してください。
Smart Agent レシーバーの設定方法を参照してください。
一般的な設定オプションのリストについては、モニターの共通設定を参照してください。
Collectorの詳細は、はじめに：Collectorを理解して使用するを参照してください。

例 🔗

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

receivers:
  smartagent/prometheus-nginx-ingress:
    type: prometheus/nginx-ingress
    discoveryRule: container_image =~ "nginx-ingress-controller" && port == 10254
    port: 10254
    ... # Additional config

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

service:
  pipelines:
    metrics:
      receivers: [smartagent/prometheus/nginx-ingress]

イングレスNGINXの設定 🔗

NGINX Ingress Controller チャートの controller.stats.enabled=true と controller.metrics.enabled=true フラグを有効にします。

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

次の表は、prometheus-nginx-ingress モニターの設定オプションを示します：

オプション	必須	タイプ	説明
`httpTimeout`	いいえ	`int64`	読み込みと書き込みの両方のHTTPタイムアウト時間。 `ParseDuration` が受け入れる継続時間文字列である必要があります。デフォルト値は `10s` です。
`username`	いいえ	`string`	各リクエストで使用するユーザー名。
`password`	いいえ	`string`	各リクエストで使用するパスワード。
`useHTTPS`	いいえ	`bool`	trueの場合、エージェントは、プレーン HTTP の代わりに HTTPS を使用してサーバーに接続プレーン HTTP。デフォルト値は `false` です。
`httpHeaders`	いいえ	`map of strings`	HTTP ヘッダー名と値のマップ。カンマ区切りの複数同じメッセージ・ヘッダーの値がサポートされています。
`skipVerify`	いいえ	`bool`	`useHTTPS` 、`skipVerify` の両方が `true` の場合、TLS 証明書は検証されません。デフォルト値は `false` です。
`caCertPath`	いいえ	`string`	TLS証明書に署名したCA証明書へのパス、 `skipVerify` が false に設定されている場合は不要です。
`clientCertPath`	いいえ	`string`	TLSが必要な接続TLSに使用するクライアントTLS証明書へのパスパス。
`clientKeyPath`	いいえ	`string`	TLSが必要な接続に使用するクライアントTLSキーへのパス。
`host`	はい	`string`	エクスポーターのホスト。
`port`	はい	`integer`	エクスポーターのポート。
`useServiceAccount`	いいえ	`bool`	認証にポッドサービスアカウントを使用します。デフォルト値は `false` です。
`metricPath`	いいえ	`string`	エクスポーター・サーバーのメトリクス・エンドポイントへのパス。デフォルト値は `/metrics` です。
`sendAllMetrics`	いいえ	`bool`	Prometheusエクスポーターから出力されるすべてのメトリクスをフィルターリングなし。このオプションは、Prometheusエクスポートモニターを直接使用する場合、組み込みのフィルターリングがないため、何の効果もありません。デフォルト値は `false` です。

メトリクス 🔗

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

備考 🔗

To learn more about the available in Splunk Observability Cloud see メトリクスタイプ
In host-based subscription plans, default metrics are those metrics included in host-based subscriptions in Splunk Observability Cloud, such as host, container, or bundled metrics. Custom metrics are not provided by default and might be subject to charges. See メトリクスカテゴリ for more information.
MTSベースのサブスクリプションプランでは、すべてのメトリクスがカスタムです。
メトリクスを追加するには、その他のメトリクスの追加で extraMetrics の設定方法を参照してください。

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

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

Splunk Observability Cloudをご利用のお客様

Submit a case in the Splunk Support Portal .
Contact Splunk Support .

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

Splunk Answers のコミュニティサポートで質問し、回答を得る
Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルのチャットグループを参照してください。

このページは 2024年12月09日に最終更新されました。

Related Topics