> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/run-ai/self-hosted/v3.0/documentation/installation-and-configuration/operate/observability/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/run-ai/_mcp/server.

# Observability

Deploying NVIDIA Run:ai in mission-critical environments requires proper monitoring and maintenance of resources to ensure workloads run and are deployed as expected.

This section describes how to monitor NVIDIA Run:ai, including [collecting logs](/run-ai/self-hosted/documentation/installation-and-configuration/operate/observability/logs-collection) and [reviewing audit logs](/run-ai/self-hosted/documentation/installation-and-configuration/operate/observability/event-history) to meet compliance requirements.

In addition to monitoring NVIDIA Run:ai resources, it is also highly recommended to monitor NVIDIA Run:ai runs on Kubernetes, which manages containerized applications. In particular, focus on three main layers:

## NVIDIA Run:ai Control Plane and Cluster Services

This is the highest layer and includes the parts of NVIDIA Run:ai pods, which run in containers managed by Kubernetes.

## Kubernetes Cluster

This layer includes the main Kubernetes system that runs and manages NVIDIA Run:ai components. Important elements to monitor include:

* The health of the cluster and nodes (machines in the cluster).
* The status of key Kubernetes services, such as the API server. For detailed information on managing clusters, see the [official Kubernetes documentation](https://kubernetes.io/docs/tasks/debug/debug-cluster/resource-usage-monitoring/).

## Host Infrastructure

This is the base layer, representing the actual machines (virtual or physical) that make up the cluster IT teams need to handle:

* Managing CPU, memory, and storage
* Keeping the operating system updated
* Setting up the network and balancing the load

NVIDIA Run:ai does not require any special configurations at this level.

## Docs

- [System Monitoring](https://docs.nvidia.com/run-ai/self-hosted/v3.0/documentation/installation-and-configuration/operate/observability/system-monitoring.md)
- [Logs Collection](https://docs.nvidia.com/run-ai/self-hosted/v3.0/documentation/installation-and-configuration/operate/observability/logs-collection.md)
- [Event History](https://docs.nvidia.com/run-ai/self-hosted/v3.0/documentation/installation-and-configuration/operate/observability/event-history.md)