---
title: Kubernetes Metrics Server
description: Monitors the Kubernetes Metrics Server
breadcrumbs: Docs > Integrations > Kubernetes Metrics Server
---

# Kubernetes Metrics Server
Supported OS Integration version6.4.0
## Overview{% #overview %}

This check monitors [Kube_metrics_server](https://github.com/kubernetes-incubator/metrics-server) v0.3.0+, a component used by the Kubernetes control plane.

**Minimum Agent version:** 6.12.0

## Setup{% #setup %}

### Installation{% #installation %}

The Kube_metrics_server check is included in the [Datadog Agent](https://app.datadoghq.com/account/settings/agent/latest) package. No additional installation is needed on your server.

### Configuration{% #configuration %}

{% tab title="Host" %}
#### Host{% #host %}

To configure this check for an Agent running on a host:

1. Edit the `kube_metrics_server.d/conf.yaml` file, in the `conf.d/` folder at the root of your Agent's configuration directory to start collecting your kube_metrics_server performance data. See the [sample kube_metrics_server.d/conf.yaml](https://github.com/DataDog/integrations-core/blob/master/kube_metrics_server/datadog_checks/kube_metrics_server/data/conf.yaml.example) for all available configuration options.

1. [Restart the Agent](https://docs.datadoghq.com/agent/guide/agent-commands.md#restart-the-agent).

{% /tab %}

{% tab title="Containerized" %}
#### Containerized{% #containerized %}

For containerized environments, see the [Kubernetes Autodiscovery Integration Templates](https://docs.datadoghq.com/agent/kubernetes/integrations.md) for guidance on applying the parameters below.

| Parameter            | Value                                                |
| -------------------- | ---------------------------------------------------- |
| `<INTEGRATION_NAME>` | `kube_metrics_server`                                |
| `<INIT_CONFIG>`      | blank or `{}`                                        |
| `<INSTANCE_CONFIG>`  | `{"prometheus_url": "https://%%host%%:443/metrics"}` |

{% /tab %}

#### SSL{% #ssl %}

If your endpoint is secured, additional configuration is required:

1. Identify the certificate used for securing the metric endpoint.

1. Mount the related certificate file in the Agent pod.

1. Apply your SSL configuration. See the [default configuration file](https://github.com/DataDog/integrations-core/blob/master/openmetrics/datadog_checks/openmetrics/data/conf.yaml.example) for more information.

### Validation{% #validation %}

[Run the Agent's status subcommand](https://docs.datadoghq.com/agent/guide/agent-commands.md#agent-status-and-information) and look for `kube_metrics_server` under the Checks section.

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

|  |
|  |
| **kube\_metrics\_server.authenticated\_user.requests**(count)              | Counter of authenticated requests broken out by username             |
| **kube\_metrics\_server.go.gc\_duration\_seconds.count**(gauge)            | Number of the GC invocation                                          |
| **kube\_metrics\_server.go.gc\_duration\_seconds.quantile**(gauge)         | GC invocation durations quantiles                                    |
| **kube\_metrics\_server.go.gc\_duration\_seconds.sum**(gauge)              | GC invocation durations sum                                          |
| **kube\_metrics\_server.go.goroutines**(gauge)                             | Number of goroutines that currently exist                            |
| **kube\_metrics\_server.kubelet\_summary\_request\_duration.count**(gauge) | Number of Kubelet summary request                                    |
| **kube\_metrics\_server.kubelet\_summary\_request\_duration.sum**(gauge)   | The Kubelet summary request latencies sum                            |
| **kube\_metrics\_server.kubelet\_summary\_scrapes\_total**(count)          | Total number of attempted Summary API scrapes done by Metrics Server |
| **kube\_metrics\_server.manager\_tick\_duration.count**(gauge)             | The total time spent collecting and storing metrics                  |
| **kube\_metrics\_server.manager\_tick\_duration.sum**(gauge)               | The total time spent collecting and storing metrics                  |
| **kube\_metrics\_server.process.max\_fds**(gauge)                          | Maximum number of open file descriptors                              |
| **kube\_metrics\_server.process.open\_fds**(gauge)                         | Number of open file descriptors                                      |
| **kube\_metrics\_server.scraper\_duration.count**(gauge)                   | Time spent scraping sources                                          |
| **kube\_metrics\_server.scraper\_duration.sum**(gauge)                     | Time spent scraping sources                                          |
| **kube\_metrics\_server.scraper\_last\_time**(gauge)                       | Last time metrics-server performed a scrape since unix epoch         |

### Events{% #events %}

kube_metrics_server does not include any events.

### Service Checks{% #service-checks %}

**kube\_metrics\_server.prometheus.health**

Returns `CRITICAL` if the check cannot access the metrics endpoint.

*Statuses: ok, critical*

**kube\_metrics\_server.up**

Returns `CRITICAL` if Kubernetes Metrics Server is not healthy.

*Statuses: ok, critical*

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).