Traefik

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

Splunk Distribution of OpenTelemetry Collectorは、Smart Agentレシーバーと traefik モニタータイプを使用してTraefikからメトリクスを収集します。

このモニターはKubernetes、Linux、Windowsで利用できます。

メリット

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

メトリクスを表示します。独自のカスタムダッシュボードを作成することができ、ほとんどのモニターは組み込みのダッシュボードも提供しています。ダッシュボードの詳細については、「Splunk Observability Cloudでダッシュボードを表示する」を参照してください。
Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他リソースのデータ駆動型の視覚化を表示します。ナビゲータの詳細については、「Splunk Infrastructure Monitoring でナビゲーターを使用する」を参照してください。
Metric Finder へアクセスし、モニターから送信されたメトリクスを検索します。詳細は、「メトリクス・ファインダーとメタデータ・カタログを検索する」を参照してください。

インストール

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

Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
[設定] セクションの説明に従ってインテグレーションを設定します。
Splunk Distribution of OpenTelemetry Collector を再起動します。

設定

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

Smart Agent レシーバーを設定ファイルに含めます。
レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。
- 「Collector でSmart Agent モニターを使用する」を参照してください。
- Smart Agent レシーバーの設定方法を参照してください。
- 一般的な構成オプションのリストについては、「モニターの共通設定」を参照してください。
- Collector の詳細については、「はじめに：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 を使用してサーバーに接続します。デフォルト値は `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.toml などの Traefik 設定ファイルを編集し、エンドポイントで Prometheus メトリクスを公開する Traefek をアクティブ化します。デフォルトでは、エンドポイントはパス /metrics 上にあります。Traefek バイナリを実行する場合、-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_ という接頭辞が付きます。

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

https://raw.githubusercontent.com/signalfx/splunk-otel-collector/main/internal/signalfx-agent/pkg/monitors/traefik/metadata.yaml

備考

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

トラブルシューティング

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

_________ __ ______ _____________ _____ _________

______ _ ____ __ ___ ______ _______ _______
_______ ______ ________

_________ __ ___________ _________ ___ ____ _____ _____

___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________
____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______