Skip to content

Kubernetes API Server

Configuration¶

Install DataKit on Kubernetes ¶

Configure Collector¶

Create the following ConfigMap to manage the collector configuration:

apiVersion: v1
kind: ConfigMap
metadata:
  name: datakit-conf
  namespace: datakit
data:
  kube-apiserver.conf: |-
    [inputs.kubernetesprometheus]
     [[inputs.kubernetesprometheus.instances]]
      role       = "pod"
      namespaces = ["kube-system"]
      selector   = "component=kube-apiserver,tier=control-plane"
      scrape          = "true"
      scheme          = "https"
      port            = "6443"
      path            = "/metrics"
      scrape_interval = "60s"
      node_local      = "ture"
      [inputs.kubernetesprometheus.instances.custom]
        measurement        = "kube_apiserver"
        job_as_measurement = false
        [inputs.kubernetesprometheus.instances.custom.tags]
          cluster_name_k8s = "fill-your-cluster-name"
          instance         = "__kubernetes_mate_instance"
          pod_name         = "__kubernetes_pod_name"
          pod_namespace    = "__kubernetes_pod_namespace"
          node_name        = "__kubernetes_pod_node_name"
      [inputs.kubernetesprometheus.instances.auth]
        bearer_token_file = "/var/run/secrets/kubernetes.io/serviceaccount/token"
        [inputs.kubernetesprometheus.instances.auth.tls_config]
          insecure_skip_verify = false
          ca_certs = ["/var/run/secrets/kubernetes.io/serviceaccount/ca.crt"]

For detailed configuration, please refer to Kubernetes Prometheus Discovery.

Mount Configuration File for DataKit¶

Modify the DataKit resource file and mount the collection configuration to enable the corresponding collector:

apiVersion: apps/v1
kind: DaemonSet
...
spec:
  ...
  template:
    ...
    spec:
      ...
      containers:
        ...
        volumeMounts:
          ...
          - name: datakit-conf
            subPath: kube-apiserver.conf
            mountPath: /usr/local/datakit/conf.d/kubernetesprometheus/kube-apiserver.conf
      volumes:
        ...
        - name: datakit-conf
          configMap:
            name: datakit-conf

Metrics¶

The following table lists key metrics and their descriptions:

Metric	Metric Type	Description
`apiserver_request_total`	Counter	Counts requests by verb, dry_run, group, version, resource, scope, component, and code
`apiserver_current_inflight_requests`	Gauge	Counts current read/write requests by request_kind
`apiserver_request_terminations_total`	Counter	Counts requests discarded for self-protection by code, component, group, resource, scope, subresource, verb, and version
`apiserver_request_duration_seconds_bucket`	Histogram	Measures response latency distribution by verb, dry_run, group, version, resource, subresource, scope, and component
`etcd_request_duration_seconds_bucket`	Histogram	Measures Etcd response latency distribution by operation and type
`apiserver_admission_controller_admission_duration_seconds_bucket`	Histogram	Measures admission controller latency distribution by name, operation, rejected, and type
`apiserver_admission_webhook_admission_duration_seconds_bucket`	Histogram	Measures admission Webhook response latency distribution by name, operation, rejected, and type
`workqueue_queue_duration_seconds_bucket`	Histogram	Measures request dwell time distribution in work queues by name
`workqueue_work_duration_seconds_bucket`	Histogram	Measures request processing time distribution in queues by name
`apiserver_storage_objects`	Gauge	Counts latest resources by resource