Traefik
セキュリティモニタリングが使用可能です セキュリティモニタリングが使用可能です

Traefik

Agent Check Agentチェック

Supported OS: Linux Mac OS Windows

概要

このインテグレーションは Traefik からデータを収集して、Traefik の健全性をチェックすると共に、以下を監視します。

  • エラーログ (4xx コード、5xx コード)
  • リクエスト数
  • 送受信されたバイト数

セットアップ

インストール

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

  1. 開発ツールキットをインストールします。
  2. integrations-extras リポジトリを複製します。

    git clone https://github.com/DataDog/integrations-extras.git.
  3. ddev 構成を integrations-extras/ パスで更新します。

    ddev config set extras ./integrations-extras
  4. traefik パッケージをビルドします。

    ddev -e release build traefik
  5. Datadog Agent をダウンロードして起動します。

  6. 次のコマンドを実行して、Agent でインテグレーション Wheel をインストールします。

    datadog-agent integration install -w <PATH_OF_TRAEFIK_ARTIFACT_>/<TRAEFIK_ARTIFACT_NAME>.whl
  7. 他のパッケージ化されたインテグレーションと同様にインテグレーションを構成します。

コンフィグレーション

  1. Traefik のメトリクスまたはログを収集するには、Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーの traefik.d/conf.yaml ファイルを編集します。使用可能なすべてのコンフィギュレーションオプションについては、サンプル traefik.d/conf.yaml を参照してください。

  2. Agent を再起動します

メトリクスの収集

メトリクスの収集を開始するには、traefik.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オプション

Agent を再起動すると、Datadog への Traefik メトリクスの送信が開始されます。

ログの収集

Agent 6.0 以上で使用可能

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

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

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

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

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

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

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

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

  3. Agent を再起動します

検証

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

互換性

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

収集データ

メトリクス

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

イベント

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

Service Checks

Traefik をクエリすると、ステータスコードとして 200 が返されます。

開発

Agent ベースのインテグレーションのテストおよび開発方法の詳細については、メインドキュメントを参照してください。