Supported OS Linux Windows

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

概要

Wayfinder は、一元構成によって開発者のセルフサービスを可能にするインフラストラクチャー管理プラットフォームです。このチェックでは、Datadog Agent を通じて Wayfinder のキー管理コンポーネントを監視します。

インテグレーションは Wayfinder API サーバー、コントローラー、Webhook コンポーネントからキーメトリクスを収集します。これらのメトリクスは、管理されたワークスペースの問題を明らかにします。

セットアップ

以下の手順に従って、Wayfinder Kubernetes 管理クラスターにインテグレーションをインストールしてください。

インストール

コンテナ環境では、Docker Agent とこのインテグレーションを使用する最善の方法は、Wayfinder インテグレーションをインストールした Agent をビルドすることです。

前提条件:

Datadog Agent が Wayfinder コンポーネントに接続できるようにするには、 ネットワークポリシーを構成する必要があります。以下のネットワークポリシーは、 Datadog が Datadog ネームスペースに、 Wayfinder が Wayfinder ネームスペースにデプロイされていることを前提としています。

apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
  name: datadog-agent
  namespace: wayfinder
spec:
  ingress:
  - from:
    - namespaceSelector:
        matchLabels:
          name: datadog
      podSelector:
        matchLabels:
          app: datadog-agent
    ports:
    - port: 9090
      protocol: TCP
  podSelector:
    matchExpressions:
    - key: name
      operator: In
      values:
      - wayfinder-controllers
      - wayfinder-apiserver
      - wayfinder-webhooks
  policyTypes:
  - Ingress

Agent のアップデート版をビルドするには

  1. 以下の Dockerfile を使用します。

    FROM gcr.io/datadoghq/agent:latest
    
    ARG INTEGRATION_VERSION=1.0.0
    
    RUN agent integration install -r -t datadog-wayfinder==${INTEGRATION_VERSION}
    
  2. イメージをビルドし、プライベート Docker レジストリにプッシュします。

  3. Datadog Agent コンテナイメージをアップグレードします。Helm チャートを使用している場合は、 values.yaml ファイルの agents.image セクションを変更して、 デフォルトの Agent イメージを置き換えます。

    agents:
      enabled: true
      image:
        tag: <NEW_TAG>
        repository: <YOUR_PRIVATE_REPOSITORY>/<AGENT_NAME>
    
  4. 新しい values.yaml ファイルを使用して Agent をアップグレードします。

    helm upgrade -f values.yaml <RELEASE_NAME> datadog/datadog
    

構成

  1. Agent の構成ディレクトリの root にある conf.d/ フォルダーの wayfinder/conf.yaml ファイルを編集して、 Wayfinder データの収集を開始します。 使用可能なすべての構成オプションの詳細については、サンプル wayfinder/conf.yaml を参照してください 。

  2. Agent を再起動します

検証

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

収集データ

メトリクス

wayfinder.controller_runtime.active_workers
(gauge)
Number of currently used workers per controller.
wayfinder.controller_runtime.max_concurrent_reconciles
(gauge)
Maximum number of concurrent reconciles per controller.
wayfinder.controller_runtime.reconcile_errors_total.count
(count)
Total number of reconciliation errors per controller.
wayfinder.controller_runtime.reconcile_time_seconds.bucket
(count)
Bucket of length of time per reconciliation per controller.
wayfinder.controller_runtime.reconcile_time_seconds.count
(count)
Count of length of time per reconciliation per controller.
wayfinder.controller_runtime.reconcile_time_seconds.sum
(count)
Sum of length of time per reconciliation per controller.
wayfinder.controller_runtime.reconcile_total.count
(count)
A summary of the total controller reconciles.
wayfinder.workqueue.adds_total.count
(count)
Total number of adds handled by workqueue.
wayfinder.workqueue.depth
(gauge)
Current depth of workqueue.
wayfinder.workqueue.queue_duration_seconds.bucket
(count)
Bucket of length of time in seconds an item stays in workqueue before being requested.
wayfinder.workqueue.queue_duration_seconds.count
(count)
Count of time in seconds an item stays in workqueue before being requested.
wayfinder.workqueue.queue_duration_seconds.sum
(count)
Sum of time in seconds an item stays in workqueue before being requested.
wayfinder.workqueue.retries.count
(count)
Total number of retries handled by workqueue.
wayfinder.workqueue.unfinished_work_seconds
(gauge)
How many seconds of work has been done that is in progress and hasn't been observed by work_duration. Large values indicate stuck threads. One can deduce the number of stuck threads by observing the rate at which this increases.

サービスチェック

Wayfinder には、サービスのチェック機能は含まれません。

イベント

Wayfinder には、イベントは含まれません。

トラブルシューティング

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