Linkerd

Supported OS Linux Windows Mac OS

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

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email [email protected].

概要

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

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

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

セットアップ

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

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

インストール

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

構成

    ホスト

    ホストで実行中の Agent に対してこのチェックを構成するには

    1. Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーの linkerd.d/conf.yaml ファイルを編集します。 最新の OpenMetrics チェック例を使用した利用可能なすべての構成オプションについては、linkerd.d/conf.yaml のサンプルを参照してください。以前にこのインテグレーションを実装したことがある場合は、レガシー例を参照してください。

    2. Agent を再起動します。

    コンテナ化

    コンテナ環境の場合は、オートディスカバリーのインテグレーションテンプレートのガイドを参照して、次のパラメーターを適用してください。

    Linkerd v1
    パラメーター値
    <INTEGRATION_NAME>linkerd
    <INIT_CONFIG>空白または {}
    <INSTANCE_CONFIG>{"openmetrics_endpoint": "http://%%host%%:9990/admin/metrics/prometheus"}

    注: これは新しいデフォルトの OpenMetrics チェックの例です。以前にこのインテグレーションを実装したことがある場合は、レガシーの例を参照してください。

    Linkerd v2
    パラメーター値
    <INTEGRATION_NAME>linkerd
    <INIT_CONFIG>空白または {}
    <INSTANCE_CONFIG>{"openmetrics_endpoint": "http://%%host%%:4191/metrics"}

    注: これは新しいデフォルトの OpenMetrics チェックの例です。以前にこのインテグレーションを実装したことがある場合は、レガシーの例を参照してください。

    ログ収集

    Datadog Agent で、ログの収集はデフォルトで無効になっています。有効にする方法については、Kubernetes ログ収集を参照してください。

    パラメーター値
    <LOG_CONFIG>{"source": "linkerd", "service": "<SERVICE_NAME>"}

    データプレーンログの冗長性を高めるには、プロキシログレベルの変更を参照してください。

    検証

    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 のサポートチームまでお問い合わせください。