概要

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

Datadog-Apache Traffic Server インテグレーションを有効にすると、以下のことができます。

• Web サイトやアプリケーションなどのオンラインリソースの可用性とパフォーマンスを確保する。
• Web サイトやアプリケーションへのアクセス数、ボリューム、変化などのメトリクスを追跡する。
• リクエストの平均応答時間およびサイズを決定する。
• システムログ、エラーログを監視する。

セットアップ

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

インストール

Traffic Server チェックは Datadog Agent パッケージに含まれています。

Traffic Server で監視を有効にするには、Traffic Server で Stats Over HTTP プラグインを有効にし、plugin.config ファイルに次の行を追加して Traffic Server をリロードしてください。

stats_over_http.so

構成

1. Traffic Server のパフォーマンスデータの収集を開始するには、Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーの traffic_server.d/conf.yaml ファイルを編集します。使用可能なすべてのコンフィギュレーションオプションについては、サンプル sample traffic_server.d/conf.yaml を参照してください。

注: デフォルトのコンフィギュレーションファイルを使用する場合、デフォルトではすべてのメトリクスが収集されるわけではありません。

利用可能なすべてのメトリクスを収集するために metric_patterns オプションをコメントアウトするか、別のサブセットのメトリクスを収集するために編集してください。

    ## @param metric_patterns - mapping - optional
    ## 包含または除外するメトリクスのマッピングで、各エントリーは正規表現です。
    ##
    ## `exclude` で定義されたメトリクスは、オーバーラップした場合に優先されます。
    ## このオプションをコメントアウトすると、利用可能なすべてのメトリクスを収集することができます。
    #
    metric_patterns:
      include:
         - <METRIC_1>
         - <METRIC_2>

2. Agent を再起動します。

検証

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

収集データ

メトリクス

ログ収集

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

1. Traffic Server のログは高度にカスタマイズ可能ですが、Datadog のインテグレーションパイプラインは、デフォルトの変換パターンをサポートしています。異なるフォーマットがある場合は、インテグレーションパイプラインを複製して編集してください。

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

   logs_enabled: true
   

3. traffic_server.d/conf.yaml ファイルのコメントを解除して、ログコンフィギュレーションブロックを編集します。環境に基づいて、path パラメーターと service パラメーターの値を変更してください。使用可能なすべてのコンフィギュレーションオプションの詳細については、traffic_server.d/conf.yaml のサンプルを参照してください。

   logs:
      - type: file
        path: /opt/trafficserver/var/log/trafficserver/traffic.out
        source: traffic_server
      - type: file
        path: /opt/trafficserver/var/log/trafficserver/diags.log
        source: traffic_server
      - type: file
        path: /opt/trafficserver/var/log/trafficserver/error.log
        source: traffic_server
   

イベント

Traffic Server インテグレーションには、イベントは含まれません。

サービスチェック

traffic_server.can_connect
Returns CRITICAL if the Agent is unable to connect to and collect metrics from the monitored Traffic Server instance. Returns OK otherwise.
Statuses: ok, critical

トラブルシューティング

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