Skip to content

The Dashboard

The dashboard is the first thing you see when you sign in to GridNMS. It pulls together the most important signals about your network — what’s up, what’s down, what just changed, and what needs attention — into a single screen you can scan in seconds.

The GridNMS dashboard The dashboard shows device status and open events at a glance.

The dashboard is built from panels. Each panel is a self-contained widget that shows one kind of information. A fresh install comes with a sensible default layout, and you can rearrange, add, or remove panels to suit how your team works.

Common panels include:

Panel What it shows
Device status A breakdown of how many devices are Up, Down, or Unknown, usually as a donut or stat card.
Open events A live feed of unresolved events, newest first, color-coded by severity.
Recent changes Devices that recently went up or down, interfaces that flapped, and other state transitions.
Upcoming maintenance Planned maintenance windows so you know which devices are expected to be offline.
Top event sources The devices generating the most events — a quick way to spot a noisy or failing device.
Metric graphs Live charts for traffic, CPU, memory, and other monitored metrics.
Service status The health of the GridNMS services themselves, so you know the platform is collecting normally.

The device status panel uses three states, the same ones used throughout GridNMS:

  • Up — the device is reachable and responding to monitoring.
  • Down — the device failed its reachability check and is considered offline.
  • Unknown — GridNMS has not yet been able to determine the device’s state (for example, it was just added, or its collector is offline).

Clicking any segment or number takes you straight to a filtered device list so you can see exactly which devices are in that state.

If your organization has more than one site, a Site selector appears at the top of the page. Use it to scope the entire dashboard — and most other pages — to a single location, or choose All sites to see everything together. This is handy when different teams own different buildings, campuses, or regions.

Press Cmd+K (Mac) or Ctrl+K (Windows/Linux) anywhere in GridNMS to open global search. Start typing a device name, IP address, interface, or page name and jump straight there. It’s the fastest way to pull up a specific device without clicking through menus.

You can shape the dashboard to match what your team needs to watch.

  1. Click Customize (or Edit layout) in the top-right of the dashboard.
  2. Click Add Panel.
  3. Choose a panel type from the list and confirm.
  4. The new panel appears at the bottom of the layout, ready to be positioned.

Beyond the built-in status panels, you can add graph panels that chart a device’s monitored metrics — traffic, errors, packets, CPU, a service’s response time — right on the dashboard.

The most direct way to create one is from the Metrics page:

  1. Go to Metrics and pick the device (and, for traffic, the interface) you want to chart.
  2. Choose the metric and the time range you’d like the chart to cover — for example, Traffic on an uplink over the last 24 hours.
  3. Pin the chart to a dashboard. It’s added as a graph panel on that dashboard, ready to position like any other.

Once a graph panel is on a dashboard, open its menu (the / Cog icon in its corner) to:

  • Change its time range (1h, 6h, 24h, 7d, 30d) so the panel always shows the window you care about.
  • Set its column span to make a busy chart wider.
  • Copy it to another dashboard, or unpin it.

The panel library you reach through Add Panel also lists the other panel types you can drop onto any dashboard:

Panel type What it shows
Device Status Up / Down / Unknown counts and recently-down devices.
Open Events Live feed of unresolved events by severity.
Recent Changes The latest configuration and state changes.
Upcoming Maintenance Scheduled maintenance windows.
Top Event Sources The devices generating the most events.
Graph / metric panels Live charts for a device metric or service latency (pinned from Metrics).

While in customize mode:

  • Drag and drop any panel by its title bar to reorder the layout.
  • Resize a panel by changing its column span — narrow panels sit side by side, while a full-width panel spans the whole row. Stat cards work well narrow; event feeds and charts usually want more width.

Each panel can refresh on its own schedule. Open a panel’s menu (the icon in its corner) and set how often it should reload its data — for example, every 30 seconds for the open-events feed, or every 5 minutes for a slower-moving inventory count. Faster refresh keeps data current; slower refresh is lighter on busy displays.

When the layout looks right, click Done or Save. Your changes are stored to your account, so the dashboard looks the same the next time you sign in.

You can keep more than one dashboard and switch between them from the dashboard selector at the top of the page. This lets you build purpose-specific views — for example:

  • An NOC wallboard with large status cards and the open-events feed.
  • A capacity view full of traffic and utilization charts.
  • A per-site view scoped to one building for the team that runs it.

Create a new dashboard from the selector menu, give it a name, lay out its panels, and save. Switching between them is instant.