概要

Traefik Mesh は、Traefik Proxy の機能を活用して、マイクロサービス アプリケーション向けに高度なトラフィック管理、セキュリティ、可観測性機能を提供する、軽量でデプロイが容易なサービス メッシュです。Datadog の Traefik インテグレーションにより、次のことが可能になります:

• サービス メッシュに入ってくるトラフィックに関するインサイトを得る。
• メッシュ内の各サービスのパフォーマンス、信頼性、セキュリティに関する重要なインサイトを得て、効率的な稼働を確認し、問題の迅速な特定と解決に役立てる。
• サービス メッシュ内部のトラフィック フローに関する詳細なインサイトを得て、パフォーマンスの監視と信頼性の確保に役立てる。

このチェックは、Datadog Agent を通じて Traefik Mesh を監視します。

セットアップ

ホストで実行されている Agent 用にこのチェックをインストールおよび構成する場合は、以下の手順に従ってください。コンテナ環境の場合は、オートディスカバリーのインテグレーションテンプレートのガイドを参照してこの手順を行ってください。

インストール

Agent リリース v7.55.0 以降、Traefik Mesh チェックは Datadog Agent パッケージに同梱されています。サーバー側での追加インストールは不要です。

注: このチェックを使用するには Agent v7.55.0 以降が必要です。

構成

Traefik Mesh は、Prometheus 形式のメトリクスを公開するよう構成できます。Datadog Agent は、以下のインテグレーションを使用してこれらのメトリクスを収集できます。Traefik Mesh インスタンスのデータ収集を構成するには、手順に従ってください。Prometheus メトリクスを公開するために必要な構成については、公式 Traefik Mesh ドキュメントの Observability ページ を参照してください。

さらに、いくつかの API エンドポイントにアクセスすることで、小規模なサブセットのメトリクスを収集できます。具体的には:

• /api/version: Traefik Proxy のバージョン情報。
• /api/status/nodes: Traefik コントローラー から見えるノードの Ready ステータス。
• /api/status/readiness: Traefik コントローラーの Ready ステータス。

注: このチェックでは、メトリクスの収集に OpenMetrics を使用しており、Python 3 が必要です。

コンテナ化

メトリクスの収集

Traefik Mesh クラスターで Prometheus 形式のメトリクスが公開されていることを確認してください。これらの公開の構成とカスタマイズは、公式 Traefik Mesh ドキュメントの Observability ページ の手順に従って実施できます。Agent がメトリクスの収集を開始するには、Traefik Mesh の Pod にアノテーションを付与する必要があります。アノテーションの詳細については、Autodiscovery インテグレーション テンプレート を参照してください。追加の構成オプションは、traefik_mesh.d/conf.yaml のサンプル を確認してください。

注: 次のメトリクスは、利用可能な場合にのみ収集できます。特定の操作を実行した場合にのみ生成されるメトリクスもあります。

Traefik Mesh チェックを構成する際は、次のパラメーターを使用できます:

• openmetrics_endpoint: Prometheus 形式のメトリクスを公開している場所を設定します。デフォルト ポートは 8082 ですが、--entryPoints.metrics.address で変更できます。コンテナ化された環境では、ホストの自動検出 のために %%host%% を使用できます。
• traefik_proxy_api_endpooint: このパラメーターはオプションです。デフォルト ポートは 8080 で、--entryPoints.traefik.address で設定できます。コンテナ化された環境では、ホストの自動検出 のために %%host%% を使用できます。
• traefik_controller_api_endpoint: このパラメーターはオプションです。デフォルト ポートは 9000 です。

Traefik Proxy

# (...)
metadata:
  name: '<POD_NAME>'
  annotations:
    ad.datadoghq.com/<CONTAINER_NAME>.checks: |
      {
        "traefik_mesh": {
          "init_config": {},
          "instances": [
            {
              "openmetrics_endpoint": "http://%%host%%:8082/metrics",
              "traefik_proxy_api_endpoint": "http://%%host%%:8080"
            }
          ]
        }
      }
    # (...)
spec:
  containers:
    - name: <CONTAINER_NAME>
# (...)

Traefik Controller

# (...)
metadata:
  name: '<POD_NAME>'
  annotations:
    ad.datadoghq.com/<CONTAINER_NAME>.checks: |
      {
        "traefik_mesh": {
          "init_config": {},
          "instances": [
            {
              "traefik_controller_api_endpoint": "http://%%host%%:9000"
            }
          ]
        }
      }
    # (...)
spec:
  containers:
    - name: <CONTAINER_NAME>
# (...)

利用可能な構成オプションの一覧は、traefik_mesh.d/conf.yaml のサンプル を参照してください。

ログ収集

Agent バージョン 6.0 以降で利用可能

Traefik Mesh のログは、Kubernetes を通じて各種 Traefik Mesh Pod から収集できます。Datadog Agent ではログ収集はデフォルトで無効です。有効にするには、Kubernetes ログ収集 を参照してください。

オートディスカバリーのインテグレーションテンプレートのガイドを参照して、次のパラメーターを適用してください。

検証

Agent の status サブコマンドを実行 し、Checks セクションに traefik_mesh が表示されていることを確認してください。

収集データ

メトリクス

イベント

Traefik Mesh インテグレーションにはイベントは含まれません。

サービスチェック

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問合せください。