Traefik のモニター
Instana エージェントをインストールすると、Traefikセンサーが自動的にデプロイおよびインストールされます。
Instana は、Traefik を通過する要求のメトリックと分散トレースの両方を収集することができます。
サポート情報
Traefikセンサーが現在の環境と互換性があるかどうかを確認するには、以下のサポート情報セクションをご確認ください：
対応バージョンとサポート方針
以下の表は、最新のサポート対象バージョンとサポート方針を示しています：
| テクノロジー | サポート・ポリシー | 最新技術バージョン | サポートされる最新バージョン |
|---|---|---|---|
| Traefik | オンデマンド | 3.4.1 | 3.4 |
サポートポリシーに関する詳細については、 「センサーのサポート戦略」 を参照してください。
エージェント構成
エージェント設定ファイルでは、以下のフィールドを設定できます：
com.instana.plugin.traefik:
enabled: true
poll_rate: 1 # seconds
構成
メトリック収集
メトリクスを表示するには、 Instana のユーザーインターフェースのサイドバーで 「Infrastructure」 を選択し、監視対象の特定のホストをクリックします。すると、収集されたすべてのメトリクスと監視対象のプロセスが表示されたホストダッシュボードが表示されます。
構成データ
- PID
- バージョン
- 開始時刻
パフォーマンス・メトリック
| メトリック | 説明 | 粒度 |
|---|---|---|
| 1 秒あたりの HTTP 要求数 | 1 秒あたりの HTTP 要求数 | 1 秒 |
| 構成の最後の再ロード成功 | 最後に正常に構成が再ロードされた時刻 | 1 秒 |
| 構成再ロード数 | 1 秒あたりの構成再ロード数 | 1 秒 |
| Entrypoint | エントリー・ポイントごとの 1 秒あたりの HTTP 要求数 | 1 秒 |
メトリック収集の有効化
Traefik アプリケーションからのメトリック収集を有効にするには、Prometheus メトリックを使用してエンドポイントを公開する必要があります。 これを行うには複数の方法があります。
- 構成ファイル (YAML または TOML 形式) の使用
- 環境変数の設定
- コマンド・ライン引数の追加
例えば、構成ファイル内の以下の行は、:8888/metrics でメトリックを公開します。
#config.yaml
entryPoints:
metrics:
address: ":8888"
metrics:
prometheus:
entryPoint: metrics
メトリック・エンドポイントは Instana エージェントからアクセス可能でなければなりません。
その他の例については、Traefik Web サイトを参照してください。
トレースの有効化
Traefik アプリケーションでトレースを有効にするには、トレースが構成されなければなりません。 これを行うには複数の方法があります。
- 構成ファイル (YAML または TOML 形式) の使用
- 環境変数の設定
- コマンド・ライン引数の追加
例:
#config.yaml
tracing:
instana: {}
Instana エージェントは Traefik アプリケーションからアクセス可能でなければなりません。
その他の例については、Traefik [Web サイト]https://doc.traefik.io/traefik-enterprise/operations/metrics/instana/を参照してください。
Traefikの Helm チャート
公式の Traefik Proxy Helm チャートを使用するには、以下のように、Instana トレースを有効にして Traefik Prometheus メトリックを公開するための構成を明示的に指定する必要があります。
helm install \
--set="additionalArguments={--tracing.instana=true}" \
--set ports.metrics.port=8080 \
--set ports.metrics.exposedPort=8080 \
traefik \
traefik/traefik
トラブルシューティング
監視対象の種類： traefik_metrics_api_not_accessible
この問題を解決するには、メトリック・エンドポイントを公開するように Traefik アプリケーションを構成する方法について、 メトリック・コレクションの有効化 で説明されている手順を参照してください。
監視対象の種類： traefik_metrics_api_not_enabled
この問題を解決するには、メトリック・エンドポイントを公開するように Traefik アプリケーションを構成する方法について、 メトリック・コレクションの有効化 で説明されている手順を参照してください。
監視対象の種類： traefik_tracing_not_enabled
この問題を解決するには、Traefik アプリケーションでトレースを有効にする方法について、「 トレースの有効化 」で説明されている手順を参照してください。