Kubernetes Controller Manager

Supported OS Linux Windows Mac OS

インテグレーションバージョン7.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].

Kube Controller Manager ダッシュボード

概要

このチェックは、Kubernetes Control Plane の一部である Kubernetes Controller Manager を監視します。

注: サービスが公開されていないため、このチェックは Amazon EKS クラスターのデータを収集しません。

セットアップ

インストール

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

構成

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

  2. Agent を再起動します。

このインテグレーションは、コントローラーマネージャーのメトリクスエンドポイントにアクセスする必要があります。メトリクスエンドポイントにアクセスできるようにするには、以下が必要です。

  • controller-manager プロセスの IP/Port にアクセスできる
  • get RBAC 権限で /metrics エンドポイントにアクセスできる (デフォルトの Datadog Helm チャートでは、すでに適切な RBAC ロールとバインディングが追加されています)

検証

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

収集データ

メトリクス

kube_controller_manager.goroutines
(gauge)		Number of goroutines that currently exist
kube_controller_manager.job_controller.terminated_pods_tracking_finalizer
(count)		Used to monitor whether the job controller is removing Pod finalizers from terminated Pods after accounting them in Job status
kube_controller_manager.leader_election.lease_duration
(gauge)		Duration of the leadership lease
kube_controller_manager.leader_election.transitions
(count)		Number of leadership transitions observed
kube_controller_manager.max_fds
(gauge)		Maximum allowed open file descriptors
kube_controller_manager.nodes.count
(gauge)		Number of registered nodes, per zone
kube_controller_manager.nodes.evictions
(count)		Count of node eviction events, per zone
kube_controller_manager.nodes.unhealthy
(gauge)		Number of unhealthy nodes, per zone
kube_controller_manager.open_fds
(gauge)		Number of open file descriptors
kube_controller_manager.queue.adds
(count)		Elements added, by queue
kube_controller_manager.queue.depth
(gauge)		Current depth, by queue
kube_controller_manager.queue.latency.count
(gauge)		Processing latency count, by queue (deprecated in kubernetes v1.14)
kube_controller_manager.queue.latency.quantile
(gauge)		Processing latency quantiles, by queue (deprecated in kubernetes v1.14)
Shown as microsecond
kube_controller_manager.queue.latency.sum
(gauge)		Processing latency sum, by queue (deprecated in kubernetes v1.14)
Shown as microsecond
kube_controller_manager.queue.process_duration.count
(gauge)		How long processing an item from workqueue takes, by queue
kube_controller_manager.queue.process_duration.sum
(gauge)		Total workqueue processing time, by queue
Shown as second
kube_controller_manager.queue.queue_duration.count
(gauge)		How long item stays in a queue before being requested, by queue
kube_controller_manager.queue.queue_duration.sum
(gauge)		Total time of items stays in a queue before being requested, by queue
Shown as second
kube_controller_manager.queue.retries
(count)		Retries handled, by queue
kube_controller_manager.queue.work_duration.count
(gauge)		Work duration, by queue (deprecated in kubernetes v1.14)
kube_controller_manager.queue.work_duration.quantile
(gauge)		Work duration quantiles, by queue (deprecated in kubernetes v1.14)
Shown as microsecond
kube_controller_manager.queue.work_duration.sum
(gauge)		Work duration sum, by queue (deprecated in kubernetes v1.14)
Shown as microsecond
kube_controller_manager.queue.work_longest_duration
(gauge)		How many seconds has the longest running processor been running, by queue
Shown as second
kube_controller_manager.queue.work_unfinished_duration
(gauge)		How many seconds of work has done that is in progress and hasn’t been observed by process_duration, by queue
Shown as second
kube_controller_manager.rate_limiter.use
(gauge)		Usage of the rate limiter, by limiter
kube_controller_manager.slis.kubernetes_healthcheck
(gauge)		Result of a single controller manager healthcheck (alpha; requires k8s v1.26+)
kube_controller_manager.slis.kubernetes_healthcheck_total
(count)		Cumulative results of all controller manager healthchecks (alpha; requires k8s v1.26+)
kube_controller_manager.threads
(gauge)		Number of OS threads created

イベント

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

サービスチェック

kube_controller_manager.prometheus.health

Returns CRITICAL if the check cannot access the metrics endpoint.

Statuses: ok, critical

kube_controller_manager.leader_election.status

Returns CRITICAL if no replica is currently set as leader.

Statuses: ok, critical

kube_controller_manager.up

Returns CRITICAL if Kube Controller Manager is not healthy.

Statuses: ok, critical

トラブルシューティング

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