Traefik

Supported OS Linux Mac OS Windows

Integrationv1.0.0

概要

Traefik のメトリクス、ログ、トレースを Datadog に送信し、Traefik サービスを監視します。

セットアップ

Traefik チェックは Datadog Agent パッケージに含まれていないため、お客様自身でインストールする必要があります。

インストール

Agent v7.21 / v6.21 以降の場合は、下記の手順に従い Traefik チェックをホストにインストールします。Docker Agent または 上記バージョン以前の Agent でインストールする場合は、コミュニティインテグレーションの使用をご参照ください。

  1. 以下のコマンドを実行して、Agent インテグレーションをインストールします。

    datadog-agent integration install -t datadog-traefik==<INTEGRATION_VERSION>
    
  2. コアのインテグレーションと同様にインテグレーションを構成します。

コンフィギュレーション

v2 について

v1 から v2 への変更点については、Traefik 移行ガイドを参照してください。最新バージョンについては、Traefik のドキュメントを参照してください。

メトリクスの収集

Traefik のドキュメントに従って、Traefik メトリクスを Datadog に送信してください。

ログの収集

Agent 6.0 以上で使用可能

Traefik のログは、デフォルトで stdout に送信されます。Datadog Agent は、コンテナ stdout/stderr から直接ログを収集できるため、コンテナバージョンではこれを変更しないでください。

  1. Traefik がログをファイルに記録するように構成する場合は、Traefik 構成ファイルに以下を追加します。

     log:
       filePath: "/path/to/traefik.log"
    

    一般的な Apache Access 形式がデフォルトで使用され、このインテグレーションでサポートされています。

  2. Datadog Agent で、ログの収集はデフォルトで無効になっています。以下のように、datadog.yaml ファイルでこれを有効にします。

    logs_enabled: true
    
  3. Traefik ログの収集を開始するには、Agent のコンフィギュレーションディレクトリのルートにある traefik.d/conf.yaml ファイルに次のコンフィギュレーションブロックを追加します。

    logs:
      - type: file
        path: /path/to/traefik.log
        source: traefik
        service: traefik
    

    path パラメーターと service パラメーターの値を変更し、環境に合わせて構成してください。

  4. Agent を再起動します

トレースの収集

  1. 必要に応じて、Datadog の APM の有効化を行います。
  2. Traefik のドキュメントに従って、トレースを Datadog に送信してください。

v1 について

v1 については Traefik のドキュメントを、v1 から v2 への変更点については Traefik 移行ガイドをご覧ください。

メトリクスの収集

  1. Traefik のメトリクスを収集するには、Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダ内の traefik.d/conf.yaml ファイルを開きます。

  2. メトリクスの収集を開始するには、traefik.d/conf.yaml ファイルに次のコンフィギュレーションセットアップを追加します。

    init_config:
    
    instances:
    - host: 10.1.2.3
        port: "8080"
        path: "/health"
        scheme: "http"
    

    構成オプション

    • host: クエリする Traefik エンドポイント。必須
    • port: Traefik エンドポイントの API リスナー。デフォルト値は 8080。オプション
    • path: Traefik の健全性チェックエンドポイントのパス。デフォルトは /health。オプション
    • scheme: Traefik の健全性チェックエンドポイントのスキーム。デフォルトは httpオプション
  3. Agent を再起動すると、Datadog への Traefik メトリクスの送信が開始されます。

使用可能なすべての構成オプションの詳細については、サンプル traefik.d/conf.yaml を参照してください。

ログの収集

Agent 6.0 以上で使用可能

Traefik のログは、デフォルトで stdout に送信されます。Datadog Agent は、コンテナ stdout/stderr から直接ログを収集できるため、コンテナバージョンではこれを変更しないでください。

  1. Traefik がログをファイルに記録するように構成する場合は、Traefik 構成ファイルに以下を追加します。

    [traefikLog]
    filePath = "/path/to/traefik.log"
    

    一般的な Apache Access 形式がデフォルトで使用され、このインテグレーションでサポートされています。

  2. Datadog Agent で、ログの収集はデフォルトで無効になっています。以下のように、datadog.yaml ファイルでこれを有効にします。

    logs_enabled: true
    
  3. Traefik ログの収集を開始するには、Agent のコンフィギュレーションディレクトリのルートにある traefik.d/conf.yaml ファイルに次のコンフィギュレーションブロックを追加します。

    logs:
      - type: file
        path: /path/to/traefik.log
        source: traefik
        service: traefik
    

    path パラメーターと service パラメーターの値を変更し、環境に合わせて構成してください。

  4. Agent を再起動します

トレースの収集

Traefik v1.7+ で使用可能

  1. 必要に応じて、Datadog の APM の有効化を行います。
  2. Traefik のドキュメントに従って、トレースを Datadog に送信してください。

検証

Agent の status サブコマンドを実行し、Checks セクションで traefik を探します。

互換性

このチェックは、すべての主要プラットフォームと互換性があります。

メトリクス

v2 については、Datadog に送られる Traefik メトリクスのリストをご覧ください。

v1 については、インテグレーションによって提供されるメトリクスのリストを参照してください。

収集データ

メトリクス

traefik.total_status_code_count
(gauge)
total count for each returned status code
traefik.total_count
(gauge)
count total number of requests

イベント

Traefik チェックには、イベントは含まれません。

サービスのチェック

traefik.check
Returns ok if the Traefik is up, critical when down and unknown when unknown exception occurred.
Statuses: ok, critical, unknown

トラブルシューティング

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