title: Kubernetes: Memory
agents: kubernetes
catalog: containerization/kubernetes
license: GPLv2
distribution: check_mk
description:
 This check shows the memory usage of a Kubernetes object, its requests utilization and its limits
 utilization.

 Requests utilization is the memory usage divided by the sum of all configured container memory
 requests. Limit utilization is computed in the same manner. The utilization percentage values are
 omitted if any of the associated request/limit value are not configured. Moreover, limits
 utilization is omitted if any container has a limit of zero. The reason for omission is displayed
 in the check's details.

 Some care must be taken, when interpreting the usage on individual nodes. The "Memory resources"
 service reports the usage of running pods only. This means that the usage of operating and
 Kubernetes system daemons is not reflected. If you need full usage, use the "Memory" service
 instead. Another caveat is that "Node utilization" and "Cluster utilization" are computed relative
 to the allocatable space of the nodes, not relative to their capacity. For details on this
 distinction please consult the Kubernetes docs.

 The service includes metrics for the memory usage, the requests utilization, the limits utilization,
 the memory requests and memory limits of the Kubernetes object.

 There are no default thresholds for this service. However, thresholds can be configured via the
 "Kubernetes memory resource utilization" ruleset.

 Currently, this check does not have swap support.

 The check requires that the special agent kube is configured.

 For the Checkmk Openshift monitoring, the reported metric values will differ from the values
 reported on the Openshift dashboard as as the included values describe a different quantity.

discovery:
 One service is created per Kubernetes object.
