Prometheus・エクスポーター 🔗
The Splunk Distribution of the OpenTelemetry Collector uses the Smart Agent receiver with the prometheus-exporter
monitor type to read all metric types from a Prometheus Exporter endpoint.
Prometheus Exporterは、Prometheus以外のシステムから統計情報を取得し、Prometheusメトリクスに変換するソフトウェアです。Prometheus メトリクスス・タイプの説明については、メトリクス・タイプを参照してください。
このモニターはKubernetes、Linux、Windowsで利用できます。
メリット 🔗
インテグレーションを設定すると、これらの機能にアクセスできるようになります:
メトリクスを表示します。独自のカスタム・ダッシュボードを作成することができ、ほとんどのモニターは組み込みのダッシュボードも提供しています。ダッシュボードについては、Splunk Observability Cloudでダッシュボードを表示する を参照してください。
Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他のリソースのデータ駆動型の視覚化を表示します。ナビゲーターについては、Splunk Infrastructure Monitoring でナビゲーターを使用する を参照してください。
Metric Finder にアクセスして、モニターから送信されたメトリクスを検索します。詳細については、メトリクス・ファインダーとメタデータ・カタログを検索する を参照してください。
インストール 🔗
このインテグレーションを導入するには、以下の手順に従ってください:
Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします:
[設定] セクションの説明に従ってインテグレーションを設定します。
Splunk Distribution of OpenTelemetry Collector を再起動します。
設定 🔗
Smart Agent モニターとCollector のインテグレーションを使用するには、以下の手順に従います:
Smart Agent レシーバーを設定ファイルに含めます。
レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。
Collector でSmart Agent モニターを使用する の方法を参照してください。
Smart Agent レシーバー の設定方法を参照してください。
一般的な設定オプションのリストについては、モニターの共通設定 を参照してください。
Collectorの詳細は、はじめに:Collectorを理解して使用する を参照してください。
例 🔗
このインテグレーションを有効にするには、Collector構成に以下を追加します:
receivers:
smartagent/prometheus-exporter:
type: prometheus-exporter
discoveryRule: port >= 9100 && port <= 9500 && container_image =~ "exporter"
extraDimensions:
metric_source: prometheus
... # Additional config
次に、設定ファイルの service.pipelines.metrics.receivers
セクションにモニターを追加します:
service:
pipelines:
metrics:
receivers: [smartagent/prometheus-exporter]
Splunk Distribution of OpenTelemetry Collector が既存の環境をどのように統合し、補完できるかを示す具体的な使用例については、構成例を参照してください。
OTel Collector が Splunk Enterprise と既存の Prometheus デプロイメントでどのように動作するかの例については、GitHub の Prometheus フェデレーションエンドポイントの例を参照してください。
設定オプション 🔗
次の表は、prometheus-exporter
モニターの設定オプションを示します:
オプション |
必須 |
タイプ |
説明 |
---|---|---|---|
|
いいえ |
|
|
|
いいえ |
|
各リクエストで使用される Basic Auth ユーザー名 (ある場合)。 |
|
いいえ |
|
各リクエストで使用するBasic Authパスワード (ある場合)。 |
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
TLSが必要な接続に使用するクライアントTLS証明書へのパス |
|
いいえ |
|
TLSが必要な接続に使用するクライアントTLSキーへのパス |
|
はい |
|
エクスポーターのホスト |
|
はい |
|
エクスポーターのポート |
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
|
認証 🔗
基本的なHTTP認証には、username
と password
オプションを使用します。
Kubernetes上で、監視対象サービスに認証が必要な場合は、useServiceAccount
オプションを使用して、接続時にエージェントのサービスアカウントを使用します。Smart Agent のサービスアカウントに、監視対象サービスに対する十分な権限があることを確認してください。
メトリクス 🔗
このインテグレーションで利用可能なメトリクスはありません。
Prometheusのメトリクス法換算の詳細 🔗
これがPrometheusのメトリクスの変換方法です:
ゲージは Splunk Infrastructure Monitoring ゲージに直接変換されます。
カウンターは、Infrastructure Monitoring の累積カウンターに直接変換されます。
タイプされていないメトリクスは、Infrastructure Monitoring ゲージに直接変換されます。
サマリー・メトリクスは、3つの異なるメトリクスに変換されます。
<basename>
はメトリクスのルート名です:合計カウントは、
<basename>_count
と呼ばれる累積カウンターに変換されます。合計値は、
<basename>
と呼ばれる累積カウンターに変換されます。各分位値は、
<basename>_quantile
と呼ばれるゲージに変換され、分位値を指定するquantile
と呼ばれるディメンションを含みます。
ヒストグラム・メトリクスは、3つの異なるメトリクスに変換されます。
<basename>
は、メトリクスのルート名です:合計カウントは、
<basename>_count
と呼ばれる累積カウンターに変換されます。合計値は、
<basename>
と呼ばれる累積カウンターに変換されます。各ヒストグラムのバケットは、
<basename>_bucket
と呼ばれる累積カウンターに変換され、そのバケット内の最大値を指定するupper_bound
と呼ばれるディメンションを含みます。このメトリクスは、上限値以下の値を持つイベントの数を指定します。
すべてのPrometheusラベルは、Infrastructure Monitoringのディメンションに直接変換されます。
これはサービスディスカバリーをサポートしているため、port >= 9100 && port <= 9500 && containerImage =~ "exporter"
のようなディスカバリールールを設定することができます。これは、標準的なエクスポーター・ポートの範囲内にある「エクスポーター」という単語が含まれるコンテナ・イメージでエクスポーターを実行していることを想定しています。
Kubernetesでは、Pod specで定義されているコンテナポート名でマッチングを試みることもできます。これは、k8s-api
オブザーバーのディスカバリールールの name
変数です。
エクスポーターは冗長になりがちなので、ここでフィルターーをかけると非常に便利です。
トラブルシューティング 🔗
ログにはエラー net/http: HTTP/1.x transport connection broken: malformed HTTP response
が含まれています 🔗
解決策: useHTTPS
で HTTPS を有効にします。
ログにはエラー forbidden: User \"system:anonymous\" cannot get path \"/metrics\"
が含まれています 🔗
解決方法: useServiceAccount
をアクティブにして、Splunk Distribution of OpenTelemetry Collector が実行されているサービスアカウントに必要なアクセス許可があることを確認します。
サポートを受ける 🔗
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 マニュアルの チャットグループ を参照してください。