---
title: Kube Proxy
description: Monitor Kube Proxy with Datadog.
breadcrumbs: Docs > Integrations > Kube Proxy
---

# Kube Proxy
Supported OS Integration version9.3.0
## Overview{% #overview %}

Get metrics from kube_proxy service in real time to:

- Visualize and monitor kube_proxy states
- Be notified about kube_proxy failovers and events.

## Setup{% #setup %}

### Configuration{% #configuration %}

The integration relies on the `--metrics-bind-address` option of the kube-proxy, by default it's bound to `127.0.0.1:10249`. Start the Agent on the host network if the kube-proxy is also on the host network (default) or start the kube-proxy with `--metrics-bind-address=0.0.0.0:10249`

Edit the `kube_proxy.d/conf.yaml` file to point to your server and port, set the masters to monitor

**Note**: If you edit the namespace & metrics name, or add any other metric they are considered as custom

Contribute to the integration if you want to add a relevant metric.

### Validation{% #validation %}

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

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

### Metrics{% #metrics %}

|  |
|  |
| **kubeproxy.cpu.time**(gauge)                                      | Total user and system CPU time spent in seconds*Shown as second*                                                                                                                                                                                                                                       |
| **kubeproxy.mem.resident**(gauge)                                  | Resident memory size in bytes*Shown as byte*                                                                                                                                                                                                                                                           |
| **kubeproxy.mem.virtual**(gauge)                                   | Virtual memory size in bytes*Shown as byte*                                                                                                                                                                                                                                                            |
| **kubeproxy.rest.client.exec\_plugin.certificate.rotation**(gauge) | Histogram of the number of seconds the last auth exec plugin client certificate lived before being rotated. If auth exec plugin client certificates are unused, histogram will contain no data.*Shown as second*                                                                                       |
| **kubeproxy.rest.client.exec\_plugin.ttl**(gauge)                  | Gauge of the shortest TTL (time-to-live) of the client certificate(s) managed by the auth exec plugin. The value is in seconds until certificate expiry (negative if already expired). If auth exec plugins are unused or manage no TLS certificates, the value will be +INF. (alpha)*Shown as second* |
| **kubeproxy.rest.client.request.duration**(gauge)                  | Request latency in seconds. Broken down by verb and URL.*Shown as second*                                                                                                                                                                                                                              |
| **kubeproxy.rest.client.requests**(gauge)                          | Number of HTTP requests partitioned by status code method and host*Shown as request*                                                                                                                                                                                                                   |
| **kubeproxy.sync\_proxy.rules.duration**(gauge)                    | SyncProxyRules latency in seconds (alpha)*Shown as second*                                                                                                                                                                                                                                             |
| **kubeproxy.sync\_proxy.rules.endpoint\_changes.pending**(gauge)   | Pending proxy rules Endpoint changes (alpha)                                                                                                                                                                                                                                                           |
| **kubeproxy.sync\_proxy.rules.endpoint\_changes.total**(gauge)     | Cumulative proxy rules Endpoint changes (alpha)                                                                                                                                                                                                                                                        |
| **kubeproxy.sync\_proxy.rules.iptables**(gauge)                    | Number of proxy iptables rules programmed (alpha)                                                                                                                                                                                                                                                      |
| **kubeproxy.sync\_proxy.rules.iptables.restore\_failures**(gauge)  | Cumulative proxy iptables restore failures (alpha)                                                                                                                                                                                                                                                     |
| **kubeproxy.sync\_proxy.rules.last\_queued\_timestamp**(gauge)     | The last time a sync of proxy rules was queued (alpha)*Shown as second*                                                                                                                                                                                                                                |
| **kubeproxy.sync\_proxy.rules.last\_timestamp**(gauge)             | The last time proxy rules were successfully synced (alpha)*Shown as second*                                                                                                                                                                                                                            |
| **kubeproxy.sync\_proxy.rules.latency.count**(gauge)               | SyncProxyRules latency count (alpha)                                                                                                                                                                                                                                                                   |
| **kubeproxy.sync\_proxy.rules.latency.sum**(gauge)                 | SyncProxyRules latency sum (alpha)*Shown as microsecond*                                                                                                                                                                                                                                               |
| **kubeproxy.sync\_proxy.rules.service\_changes.pending**(gauge)    | Pending proxy rules Service changes (alpha)                                                                                                                                                                                                                                                            |
| **kubeproxy.sync\_proxy.rules.service\_changes.total**(gauge)      | Cumulative proxy rules Service changes (alpha)                                                                                                                                                                                                                                                         |

### Events{% #events %}

Kube Proxy does not include any events.

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

**kubeproxy.up**

Returns `CRITICAL` if Kube Proxy is not healthy.

*Statuses: ok, critical*

## Troubleshooting{% #troubleshooting %}

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