PrometheusNGINXイングレス

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

Splunk Distribution of OpenTelemetry Collector は、Prometheus NGINX VTS エクスポータのメトリクスを Splunk Observability Cloud 用に収集するために、prometheus-nginx-ingress モニタータイプの Smart Agent レシーバを使用して Prometheus エクスポータをラップします。

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

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

メリット

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

インストール

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

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

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

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

設定

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

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

  2. レシーバーセクションおよびパイプラインセクションの両方で、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 を使用してサーバーに接続

します。デフォルト値は 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 です。

メトリクス

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

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

備考

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

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

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

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

トラブルシューティング

__ ___ ___ _ ______ _____________ _____ ________ ___ ___ ___ ____ __ ___ ____ ____ __ ______ _____________ ______ ___ ___ ___ ____ __ ___ _________ _____

_________ __ ______ _____________ _____ _________

_________ __ ___________ _________ ___ ____ _____ _____

  • ___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________

  • ____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______