SignalFx Gateway Prometheusリモート書き込みレシーバー

はじめに

以下の手順に従って、レシーバーの設定と有効化を行ってください：

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

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

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

   • Helmを使用してCollector for Kubernetesをインストールする

2. このドキュメントに記載されているようにレシーバーを設定します。

3. Collector を再起動します。

デフォルト設定

Splunk Distribution of the OpenTelemetry Collector で signalfxgatewayprometheusremotewritereceiver レシーバーを使用するには、構成ファイルに以下を追加します。

receivers:
  signalfxgatewayprometheusremotewritereceiver:

構成を完了するには、構成ファイルの service セクションの必須パイプラインにレシーバーを含めます。例：

service:
  pipelines:
    metrics:
      receivers: [signalfxgatewayprometheusremotewritereceiver]

高度な設定

このレシーバーは、標準 OpenTelemetry メカニズムを介して設定されます。詳細は、「Collector config go」を参照してください。

以下のパラメータを設定できます。

• path。デフォルトでは /metrics です。レシーバーが Prometheus のリモート書き込みリクエストに応答するパス。

• buffer_size。デフォルトでは 100 です。以降の書き込みリクエストをブロックしないメトリクス変換のためのバッファ。

  • Collector の confighttpオプションを使用して TLS とその他の機能をセットアップします。詳細は「Collector config http」を参照してください。

• endpoint。デフォルトでは localhost:19291 です。レシーバーがリッスンするインターフェイスとポート。

既知の制限

このレシーバーは、SignalFx Prometheusリモート書き込みゲートウェイの動作をほぼ忠実に再現していますが、いくつかの違いがあります。

Prometheusリモート書き込み仕様との違い

この動作は、Prometheusリモート書き込み仕様バージョン1とは以下の点で異なります：

• このレシーバーはサフィックスを除去しません。これは Prometheus レシーバーにより実行されるからです。

• このレシーバーはヒストグラムをカウンターに変換します。

• このレシーバーは、クォンタイル（要約）をゲージに変換します。

• 浮動小数点の表現が損失なしで整数として表現できる場合、レシーバーは浮動小数点の表現を整数として設定します。

• サンプルの表現がNaNの場合、レシーバーは、メトリクス名 prometheus.total_NAN_sample を持つ追加カウンターを報告します。

• サンプルの表現にメトリック名がない場合、レシーバーはメトリクス名 prometheus.total_bad_datapoints を持つ追加カウンターを報告します。

• リクエストの解析でエラーが発生すると、追加のカウンター prometheus.invalid_request をレポートします。

• prompb.WriteRequest からのメタデータは無視されます。

SignalFxゲートウェイのサポートされていない動作

SignalFxゲートウェイからの次の動作はサポートされていません：

• request_time.ns はレポートされなくなくなりました。obsreport は同様の機能を扱います。

• drain_size はレポートされなくなくなりました。obsreport は同様の機能を扱います。

トラブルシューティング