Docs » Splunk Observability Cloud でサポートされているインテグレーション » Collectorコンポーネント: レシーバー » Prometheusレシーバー

Prometheusレシーバー 🔗

The Prometheus receiver allows the Splunk Distribution of the OpenTelemetry Collector to collect metrics from any source exposing telemetry in Prometheus format. The supported pipeline type is metrics. See パイプラインでデータを処理する for more information.

注釈

シングルエンドポイントをサポートする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 のデフォルト設定 を参照してください。この文書で説明されているように、いつでも設定をカスタマイズすることができます。

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

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

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

  2. Collector を再起動します。

サンプル構成 🔗

By default, the Splunk Distribution of the OpenTelemetry Collector includes the Prometheus receiver in the metrics/internal pipeline.

追加の 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

注意

Don’t remove the prometheus/internal receiver from the configuration. Internal metrics feed the Splunk Distribution of the OpenTelemetry Collector default dashboard.

スクレーパーの構成 🔗

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 Answers のコミュニティサポートで質問し、回答を得る

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

This page was last updated on 2024年09月18日.