---
title: "System monitoring"
description: "Monitor CPU, memory, network, broker health and gRPC performance of a running topology with Prometheus and the dashboards built with --with-metrics."
source: https://developer.remotivelabs.com/docs/remotive-topology/usage/run/system-monitoring
last_updated: 2026-11-20
---

# System monitoring

System monitoring gives you live visibility into a running topology, including CPU, memory, network, and disk usage per container, broker health, gRPC performance, and frame and signal throughput across the brokers. It's useful for understanding how the topology behaves under load, spotting bottlenecks, and confirming that simulations and tests are running as expected.

The feature is built on a standard observability stack. Prometheus scrapes metrics from each RemotiveBroker, and a set of dashboards that ship with the generated topology visualize them. The stack is wired up for you and requires no configuration.

The same dashboards are reachable from [RemotiveStudio](https://developer.remotivelabs.com/docs/remotive-studio/monitoring.md), which embeds them directly in the **Monitoring** tab.

## Enable metrics

In order to use system monitoring, the topology has to be generated with metrics enabled. Without this flag, no monitoring services are included in the generated stack and the **Monitoring** tab in RemotiveStudio is unavailable.

Pass `--with-metrics` to `remotive topology build`:

```sh
remotive topology build -f mytopology.instance.yaml --with-metrics build
```

This adds the monitoring services to the generated `docker-compose.yml`, configures metrics scraping from every RemotiveBroker in the topology, and copies a set of default dashboards into the build folder. No further configuration is required.

> **Tip**
>
> Re-run `topology build` with `--with-metrics` whenever you change platform or instance files. The generated files are overwritten every time `build` runs, so any custom dashboards you've added won't be preserved.

## View dashboards

Once the topology is up and running, use [RemotiveStudio → Monitoring](https://developer.remotivelabs.com/docs/remotive-studio/monitoring.md) to browse the dashboards.
