Docs » Splunk Observability Cloud でサポートされているインテグレーション » ネットワーク用アプリケーション・レシーバーの設定 » Traefik

Traefik 🔗

The Splunk Distribution of the OpenTelemetry Collector uses the Smart Agent receiver with the traefik monitor type to collect metrics from Traefik.

このモニターはKubernetes、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/traefik:
    type: traefik
    ...  # Additional config

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

service:
  pipelines:
    metrics:
      receivers: [smartagent/traefik]

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

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

オプション

必須

タイプ

説明

httpTimeout

いいえ

int64
読み込みと書き込みの両方のHTTPタイムアウト時間。

ParseDuration が受け入れる継続時間文字列である必要があります。デフォルト値は 10s です。

username

いいえ

string

各リクエストで使用するユーザー名。

password

いいえ

string

各リクエストで使用するパスワード。

useHTTPS

いいえ

bool
trueの場合、エージェントは、プレーン HTTP の代わりに HTTPS を使用してサーバーに接続

プレーン HTTP。デフォルト値は 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 です。

Collector またはSmart Agent は、Traefikにネットワークアクセスできる必要があります。

Traefik の設定 🔗

Traefik の設定ファイル、例えば traefik.toml を編集して、エンドポイントで Prometheus メトリクスを公開するように Traefik を有効にします。デフォルトでは、エンドポイントはパス /metrics にあります。Traefik バイナリを実行するとき、-c 引数を使用して設定ファイルへのパスを渡します。例えば、./traefik -c traefik.toml 。

Traefik Dockerイメージを実行する際は、/etc/traefik/traefik.toml ボリュームを使用してください。例えば、docker run -d -p 8080:8080 -p 80:80 -v $PWD/traefik.toml:/etc/traefik/traefik.toml 。

Traefikの設定ファイルがない場合は、サンプルの設定ファイルを使用してください。詳しくはTraefikのドキュメントを参照してください。

メトリクス 🔗

Traefikは、Traefik、エントリーポイント、バックエンドメトリクスに分類できるPrometheusメトリクスをエクスポートします。

  • Traefik 関連のメトリクスは、Traefik 自体を監視するためのもので、go_ と process_ が先頭に付きます。例えば、go_memstats_sys_bytes メトリクスは、Traefikのメモリ使用量をプロットするために使用できます。

  • エントリーポイントとバックエンドのメトリクスは、エントリーポイントとバックエンドで測定されたリクエストの数と期間です。エントリーポイント関連のメトリクスには、traefik_entrypoint_ が先頭に付きます。バックエンド関連のメトリクスの接頭辞は traefik_backend_ です。

次の表は、このインテグレーションで使用できるメトリクスを示しています：

備考 🔗

  • To learn more about the available in Splunk Observability Cloud see メトリクスタイプ

  • In host-based subscription plans, default metrics are those metrics included in host-based subscriptions in Splunk Observability Cloud, such as host, container, or bundled metrics. Custom metrics are not provided by default and might be subject to charges. See メトリクスカテゴリ for more information.

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

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

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

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年10月04日.