概要

Linkerd は、CNCF のステータスを持つ、軽量かつ強力なオープンソースのサービスメッシュです。Linkerd は、安全で信頼性が高く、観測可能なクラウドネイティブアプリケーションを作成するために必要なツールを提供します。最小限の構成で、アプリケーションを変更することなく、Linkerd は、

• 相互 TLS を使用して、すべてのクラスター上の TCP 通信を透過的に保護します。
• レイテンシーを考慮したロードバランシング、リクエストの再試行、タイムアウト、ブルーグリーンデプロイメントを追加し、アプリケーションの回復力を維持します。
• メッシュ化された各ワークロードの成功率、レイテンシー、リクエスト量を追跡することにより、プラットフォームの健全性を評価します。

このインテグレーションは、アプリケーションの成功率、レイテンシー、飽和状態など、Linkerd のメトリクスを Datadog に送信します。

セットアップ

この OpenMetrics ベースのインテグレーションには、最新モード (ターゲットエンドポイントを指すように openmetrics_endpoint を設定することで有効) とレガシーモード (代わりに prometheus_url を設定することで有効) があります。すべての最新機能を利用するために、Datadog は最新モードを有効にすることを推奨します。詳しくは、OpenMetrics ベースのインテグレーションにおける最新バージョニングとレガシーバージョニングを参照してください。

[OpenMetrics V1] または [OpenMetrics V2] とマークされたメトリクスは、Linkerd インテグレーションの対応するモードを使用した場合にのみ利用できます。マークされていないメトリクスは、すべてのモードで収集されます。

インストール

Linkerd チェックは Datadog Agent パッケージに含まれています。サーバーに追加でインストールする必要はありません。

構成

検証

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

収集データ

メトリクス

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

Linkerd v1 については、メトリクスの説明は finagle メトリクスガイド、Linkerd が公開するメトリクスの例はこちらの gist を参照してください。

Linkerd は Prometheus ベースのインテグレーションです。Linkerd の構成によっては、一部のメトリクスが Linkerd によって公開されない場合があります。cURL の出力にメトリクスが存在しない場合、Datadog Agent はその特定のメトリクスを収集することができません。

現在の構成で公開されるメトリクスをリストするには、次のコマンドを実行します。

curl <linkerd_prometheus_endpoint>

ここで、linkerd_prometheus_endpoint は Linkerd Prometheus エンドポイントです (linkerd.yaml 内の prometheus_url 構成キーと同じ値を使用する必要があります)。

デフォルトで提供されないメトリクスを使用する必要がある場合は、linkerd.yaml にエントリを追加します。

詳しくはデフォルト構成の例を参照してください。

サービスチェック

linkerd.prometheus.health
Returns CRITICAL if the agent fails to connect to the prometheus endpoint, otherwise OK.
Statuses: ok, critical

トラブルシューティング

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