Prometheusレシーバー 🔗

Prometheus レシーバーを使用すると、Splunk Distribution of OpenTelemetry Collector で Prometheus フォーマットのテレメトリを公開する任意のソースからメトリクスを収集できます。サポートされているパイプラインタイプは metrics です。

注釈

シングルエンドポイントをサポートするPrometheusレシーバーの簡易版を使用するには、シンプルなPrometheusレシーバーを参照してください。

メリット 🔗

Prometheus レシーバーは、Prometheus エンドポイントを公開するあらゆるアプリケーションからメトリクス・データをスクレイピングできます。レシーバーは、メトリクス名、値、タイムスタンプ、ラベルを保持したまま、Prometheus メトリクスを OpenTelemetry メトリクスに変換します。また、既存の Prometheus 設定を再利用することもできます。

Prometheus と互換性のあるサードパーティ製アプリケーションの全リストは、Prometheus の公式ドキュメント Prometheus エクスポーターを参照してください。

詳しくは Prometheusメトリクスでアプリケーションを構成するを参照してください。

はじめに 🔗

注釈

このコンポーネントは、ホスト監視 (エージェント) モードでデプロイする場合、Splunk Distribution of the OpenTelemetry Collector のデフォルト設定に含まれます。詳細は Collector のデプロイモードを参照してください。

デフォルト設定の詳細については、Helmで Collector for Kubernetes を設定する、Collector for Linux のデフォルト設定、または Collector for Windows のデフォルト設定を参照してください。この文書で説明されているように、いつでも設定をカスタマイズすることができます。

以下の手順に従って、コンポーネントの設定とアクティベーションを行ってください：

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

インストーラ・スクリプトを使用して Linux 用 Collector をインストールします。

インストーラ・スクリプトを使用して Collector for Windows をインストールします。

Install the Collector for Kubernetes using Helm

次のセクションで説明するようにレシーバーを設定します。
Collector を再起動します。

サンプル構成 🔗

デフォルトでは、Splunk Distribution of OpenTelemetry Collector には、metrics/internal パイプラインに Prometheus レシーバーが含まれています。

追加の Prometheus レシーバーをアクティブにするには、次の例のように Collector 設定ファイルの receivers セクションに新しい prometheus エントリーを追加します：

receivers:
  prometheus:
    config:
      scrape_configs:
        - job_name: 'sample-name'
          scrape_interval: 5s
          static_configs:
            - targets: ['0.0.0.0:8888']

コンフィギュレーションを完了するには、コンフィギュレーションファイルの service セクションの metrics パイプラインに、レシーバーを含めます。例：

service:
  pipelines:
    metrics:
      receivers:
        - prometheus

注意

設定から prometheus/internal レシーバーを削除しないでください。内部メトリクスは Splunk Distribution of OpenTelemetry Collector のデフォルトダッシュボードにフィードされます。

スクレーパーの構成 🔗

Prometheus レシーバーは、config.scrape_configs セクションを通して、サービスディスカバリーを含む Prometheus のスクレイプ設定のほとんどをサポートしています。設定ファイルの scrape_config セクションでは、ターゲットとそのスクレイピング方法を記述するパラメータのセットを指定することができます。

基本構成では、単一のスクレイプ構成は単一のジョブを指定します。static_configs パラメータを使用して静的ターゲットを設定することができます。動的に発見されたターゲットはPrometheusのサービス発見メカニズムを使用します。さらに、relabel_configs パラメータは、スクレイピングの前に任意のターゲットとそのラベルを高度に修正することができます。

以下は基本的なスクレイプ設定の例です：

receivers:
  prometheus:
    config:
      scrape_configs:
      # The job name assigned to scraped metrics by default.
      # <job_name> must be unique across all scrape configurations.
        - job_name: 'otel-collector'
        # How frequently to scrape targets from this job.
        # The acceptable values are <duration> | default = <global_config.scrape_interval> ]
          scrape_interval: 5s
        # List of labeled statically configured targets for this job.
          static_configs:
            - targets: ['0.0.0.0:8888']
        - job_name: k8s
        # Scraping configuration for Kubernetes
          kubernetes_sd_configs:
          - role: pod
          relabel_configs:
          - source_labels: [__meta_kubernetes_pod_annotation_prometheus_io_scrape]
            regex: "true"
            action: keep
          # List of metric relabel configurations.
          metric_relabel_configs:
          - source_labels: [__name__]
            regex: "(request_duration_seconds.*|response_duration_seconds.*)"
            action: keep

Prometheus レシーバー設定で環境変数を使用するには、${<var>} 構文を使用します。例：

prometheus:
  config:
    scrape_configs:
      - job_name: ${JOBNAME}
        scrape_interval: 5s

既存の Prometheus 設定を使用している場合は、$ を $$ に置き換えて、Collector が環境変数として読み込まないようにしてください。

スケーリングに関する考慮事項 🔗

Collectorの複数のレプリカを同じ設定で実行すると、Prometheusレシーバーはターゲットを複数回スクレイピングします。各レプリカを異なるスクレイピング設定で構成する必要がある場合は、スクレイピングをシャーディングします。Prometheus レシーバーはステートフルです。スケーリングに関する考慮事項については、サイジングとスケーリングを参照してください。

既知の制限 🔗

以下の Prometheus 機能はサポートされておらず、レシーバー設定で使用するとエラーを返します：

alert_config.alertmanagers
alert_config.relabel_configs
remote_read
remote_write
rule_files

設定 🔗

以下の表は、Prometheusレシーバーの設定オプションを示しています：

メトリクス 🔗

Prometheus レシーバーは、以下の変換ルールに従って Prometheus メトリクスを OpenTelemetry メトリクスに変換します：

Prometheusのメトリクスタイプ	OpenTelemetryのメトリクスタイプ
カウンター（単調）	合計 (データ型 `double` )
ゲージ\|br\| 不明	ゲージ (データ型 `double` )
ヒストグラム	ヒストグラム（累積分布）
概要	サマリー（パーセンタイル）

Histograms support 🔗

For more information on histogram support, see Send histogram metrics in OTLP format.

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

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

Splunk Observability Cloudをご利用のお客様

Splunk サポートポータルでケースを送信する
Contact Splunk Support .

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

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

This page was last updated on 2024年05月29日.

Related Topics