# Metrics not appearing

> The server is connected but panels are empty — tell a dead agent apart from a disabled feature, an old agent, and a missing analytics grant.
>
> Canonical: https://xdp.network/docs/troubleshooting/metrics-not-appearing · Updated 2026-08-09

Empty panels do not all mean the same thing. Match your symptom in the table before
changing anything on the server.

## Identify which case you are in

| Symptom | What it means | What to do |
| --- | --- | --- |
| Whole server row offline (red dot) | The console cannot poll the agent at all | Follow [Server shows offline](/docs/troubleshooting/server-shows-offline) |
| Green row, some panels empty or muted | The agent omits that section | See "Empty panels on a green server" below |
| Blank for you, fine for a teammate | You lack analytics permission | See "Blank for one viewer only" below |

## Empty panels on a green server

Not every agent section is always present in the payload: older agents or disabled
features simply omit sections, and the console renders those as muted empty states
rather than errors. A missing panel is not, by itself, a failure.

Two fixes cover most cases:

- **Reload the agent after config edits.** If you just enabled the feature in
  `/etc/openshield/openshield.yaml`, run `openshield reload` so the section starts
  appearing in the payload.
- **Update the agent.** If the server runs an agent that predates the section, update
  to the current version — see [Installation](/docs/openshield-xdp/installation).

`openshield status` on the server shows what the agent is actually running.

## Blank for one viewer only

If a teammate sees data and you do not, the row shows a gray dot and the console reports
"forbidden: analytics access required". The data exists; your account may not read it.
Ask an admin to grant you analytics access — grants are managed under **Administration**
in the console. Nothing on the server needs to change.

## Next steps

- [Server shows offline](/docs/troubleshooting/server-shows-offline)
- [Common errors](/docs/troubleshooting/common-errors)
- [Enabling metrics](/docs/openshield-xdp/enabling-metrics)