Prometheus Go

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

Splunk Distribution of OpenTelemetry Collector は、Prometheus Go コレクタと Prometheus プロセスコレクタのメトリクスを Splunk Observability Cloud 用にスクレイピングするために、prometheus-goモニタータイプの Smart Agent レシーバを使用して Prometheus Exporter をラップします。

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

メリット

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

インストール

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

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

  2. [設定] セクションの説明に従ってインテグレーションを設定します。

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

設定

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

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

  2. レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。

例

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

receivers:
  smartagent/prometheus-go:
    type: prometheus-go
    host: localhost
    port: 2112
    ... # Additional config

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

service:
  pipelines:
    metrics:
      receivers: [smartagent/prometheus-go]

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

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

オプション

必須

タイプ

説明

httpTimeout

いいえ

int64

読み込みと書き込みの両方の HTTP タイムアウト時間。これは、

「https://golang.org/pkg/time/#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/go/metadata.yaml

備考

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

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

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

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

デフォルト以外のメトリクス（バージョン 4.7.0 以降）

デフォルトではないメトリクスを出力するには、汎用レシーバレベルの extraMetrics 設定オプションでそれらのメトリクスを追加します。メトリクスのリストに表示されていない設定オプションから派生したメトリクスを extraMetrics に追加する必要はありません。

実行中のエージェントインスタンスでレシーバを設定した後、agent-status monitors を実行すると、発行されるメトリクスのリストを見ることができます。

トラブルシューティング

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

_________ __ ______ _____________ _____ _________

_________ __ ___________ _________ ___ ____ _____ _____

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

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