Traefik

Supported OS Linux Windows Mac OS

インテグレーションバージョン1.1.0

概要

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

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

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

以下のコマンドを実行して、Agent インテグレーションをインストールします。
```
datadog-agent integration install -t datadog-traefik==<INTEGRATION_VERSION>
```
コアのインテグレーションと同様にインテグレーションを構成します。

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

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

Agent 6.0 以上で使用可能

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

Traefik がログをファイルに記録するように構成する場合は、Traefik 構成ファイルに以下を追加します。
```
[traefikLog]
  filePath = "/path/to/traefik.log"
  format   = "json"
```
一般的な Apache Access 形式がデフォルトで使用され、このインテグレーションでサポートされています。
Datadog Agent で、ログの収集はデフォルトで無効になっています。以下のように、datadog.yaml ファイルでこれを有効にします。
```
logs_enabled: true
```
Traefik ログの収集を開始するには、Agent のコンフィギュレーションディレクトリのルートにある traefik.d/conf.yaml ファイルに次のコンフィギュレーションブロックを追加します。
```
logs:
  - type: file
    path: /path/to/traefik.log
    source: traefik
    service: traefik
```
path パラメーターと service パラメーターの値を変更し、環境に合わせて構成してください。
Agent を再起動します。

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

Traefik のメトリクスを収集するには、Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダ内の traefik.d/conf.yaml ファイルを開きます。
メトリクスの収集を開始するには、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。オプション
Agent を再起動すると、Datadog への Traefik メトリクスの送信が開始されます。

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

Agent 6.0 以上で使用可能

Traefik がログをファイルに記録するように構成する場合は、Traefik 構成ファイルに以下を追加します。
```
[traefikLog]
  filePath = "/path/to/traefik.log"
  format   = "json"
```
一般的な Apache Access 形式がデフォルトで使用され、このインテグレーションでサポートされています。
Datadog Agent で、ログの収集はデフォルトで無効になっています。以下のように、datadog.yaml ファイルでこれを有効にします。
```
logs_enabled: true
```
Traefik ログの収集を開始するには、Agent のコンフィギュレーションディレクトリのルートにある traefik.d/conf.yaml ファイルに次のコンフィギュレーションブロックを追加します。
```
logs:
  - type: file
    path: /path/to/traefik.log
    source: traefik
    service: traefik
```
path パラメーターと service パラメーターの値を変更し、環境に合わせて構成してください。
Agent を再起動します。

Traefik v1.7+ で使用可能

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

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

メトリクス

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

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

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

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