Insight: Dashboard
Overview
Use this page to monitor Insight agent fleet health and investigate offline, stale, or unonboarded agents. An Insight agent is a lightweight process installed on a machine that collects performance data for Insight and reports its status to this dashboard. Without this view, a disconnected agent can silently stop producing monitoring data long before anyone notices the gap.
Before this page shows anything, you need at least one Insight agent installed and registered on Configuration: Insight: Machines, and assigned to a machine group on Insight: Machine Groups. Once agents report in, their data feeds Insight's monitoring; when this dashboard shows agents as Offline, Needs Onboarding, or stale, fix registration or connectivity on Configuration: Insight: Machines, then return here to confirm the fix.
This page itself shows four KPI cards for Total Agents, Active, Offline, and Needs Onboarding, a chart breaking agents down by machine group, a chart showing which agent versions are deployed, a warning when active agents stop checking in, and a searchable, filterable table listing every machine in the fleet.
Key concepts
- Insight agent - A lightweight process installed on a machine that collects performance data for Insight monitoring and reports its status back to this dashboard. (related: Configuration: Insight: Machines)
- Machine group - A named collection of machines whose agents are reported together, used to break fleet counts down by site, environment, or role. (related: Insight: Machine Groups)
- Stale agent - An agent currently marked Active that has not checked in for more than 5 minutes, meaning it may have stopped collecting data without yet being reclassified as Offline.
- Needs Onboarding - The status for an agent that is installed but not yet fully configured to collect data, so it is excluded from the Active and Offline counts until setup is complete. (related: Configuration: Insight: Machines)
When to use it
- Check whether all expected Insight agents are online before relying on the data they collect.
- Investigate why a machine group shows fewer active agents than expected.
- Find agents that have stopped checking in (stale) before they are reclassified as Offline.
- Review which agent versions are deployed across the fleet before planning an upgrade.
- Locate agents that still need onboarding before they start collecting data.
- Search for or filter to a specific machine when you need to check one machine instead of the whole fleet.
Before you begin
- At least one Insight agent installed and registered on Configuration: Insight: Machines, otherwise the KPI cards and charts have nothing to summarize.
- The agent assigned to a machine group, created on Insight: Machine Groups, so it appears in the Agents by Group chart.
- Network connectivity between the agent and the LoadGen platform, since a disconnected agent is what causes the Offline or Stale Agents states this page reports.
Common workflows
Check fleet health before trusting monitoring data
Persona: Load-test operator or admin
- Open the Insight Dashboard.
- Expect: The Insight Agent Overview page loads, showing the Total Agents, Active, Offline, and Needs Onboarding KPI cards for the current fleet.
- Compare the Active and Offline KPI cards against the number of machines you expect to be monitored.
- Expect: Any gap between the expected count and the Active count signals agents that are down or were never registered.
- Check the Stale Agents warning for any listed agents.
- Expect: If an active agent has not checked in for more than 5 minutes, it appears here so you can investigate before relying on its data.
Verify: The KPI cards reflect your current fleet size with no unexplained entries in Offline or Needs Onboarding, and no agents appear in the Stale Agents warning.
Find machines in a specific status or group
Persona: Load-test operator or admin
- Scroll to the All Machines table below the charts.
- Expect: The full list of machines in the fleet is shown with a search box and status and group filters.
- Select a value in the Status filter or Group filter, or type a name into Search machines.
- Expect: The table narrows to only the machines matching the filter or search text.
Verify: The All Machines table lists only the machines matching your filter or search, letting you confirm the status of a specific machine without scanning the full fleet.
Steps
Step 1
Open the Insight Dashboard page.
Expected result: The Insight Agent Overview page loads, showing the Total Agents, Active, Offline, and Needs Onboarding KPI cards, the Agents by Group and Agent Versions charts, and a Stale Agents warning if any active agent has stopped checking in recently.
This is the first page to check before trusting Insight monitoring data, since it shows whether agents are actually online and reporting.
- Total Agents, Active, Offline, and Needs Onboarding KPI cards summarize the fleet at a glance.
- The Agents by Group chart breaks that count down by machine group.
- The Agent Versions chart shows which agent software versions are deployed.
- The Stale Agents warning appears only when an active agent has not checked in for more than 5 minutes.
Field reference
| Field | Purpose | Format / Validation | Required | Default |
|---|---|---|---|---|
| Search machines | Filters the All Machines table to machines whose name matches the text you type, so you can find one machine instead of scanning the whole fleet. | free text | No | empty (shows all machines) |
| Status filter | Narrows the All Machines table to machines in a specific status, mirroring the Active, Offline, and Needs Onboarding categories in the KPI cards, so you can list only the machines in the state you're investigating. | dropdown selection | No | all statuses |
| Group filter | Narrows the All Machines table to machines belonging to one machine group, so you can focus on a single group instead of the whole fleet. | dropdown selection | No | all groups |
Column reference
| Column | What it shows | How to read it |
|---|---|---|
| Total Agents | Shows the total count of Insight agents currently registered in your fleet, across all machine groups and statuses. | This equals the sum of Active, Offline, and Needs Onboarding; if the totals don't add up, an agent was recently added or removed. |
| Active | Shows the count of agents currently checking in and collecting data normally. | A drop here without a matching rise in Offline or Needs Onboarding suggests agents that stopped reporting but have not yet been reclassified; check the Stale Agents warning. |
| Offline | Shows the count of agents that are not currently checking in. | Any nonzero value means at least one agent needs investigation, since it is no longer sending data to Insight. |
| Needs Onboarding | Shows the count of agents installed but not yet fully configured to collect data. | These agents are excluded from Active and Offline until setup is finished; a persistent nonzero count usually means onboarding was started but not completed. |
Controls reference
Agents by Group chart
Displays a horizontal bar for each machine group, sized by how many Insight agents are assigned to it.
When to use: Use it to spot a machine group with fewer agents than expected or to see where your fleet is concentrated.
Side effects: Read-only; it only displays data, it does not change anything.
Agent Versions chart
Shows a donut chart with one segment per agent version currently installed, with a legend listing each version string.
When to use: Use it to check whether agents are still running an older version before planning an upgrade.
Side effects: Read-only; it only displays data, it does not change anything.
Stale Agents warning
Lists how many agents are marked Active but have not checked in for more than 5 minutes.
When to use: Check it whenever the Active count looks healthy but you suspect some agents have silently stopped reporting.
Side effects: Read-only; it appears or disappears automatically based on current agent check-in state, it does not change any data.
Machine group link (All Machines table)
Opens the data-health view scoped to that machine's group when you select its entry in the All Machines table.
When to use: Use it when you need to drill into a specific group's agents instead of reading the aggregate charts above.
Side effects: Navigates you away from the dashboard to the group's data-health view; it does not change any data.
Verify the result
The dashboard confirms fleet health when the Total Agents count matches the number of agents you expect, Active plus Offline plus Needs Onboarding add up to that total, and no agents are listed in the Stale Agents warning. The Agents by Group chart should show a bar for every machine group you've set up, and the Agent Versions chart should show only the versions you intend to run. If the numbers look wrong or haven't changed in a while, check first for a failed-to-load message, which means the page is still showing the last known data instead of a fresh read.
Troubleshooting
- Symptom: The dashboard shows a message that it failed to load and the last known data is still displayed.
- Symptom: Needs Onboarding stays above zero. Fix: Open Configuration: Insight: Machines and complete setup for the listed machines so they move to Active.
- Symptom: An agent appears in the Stale Agents warning even though you expect it to be reporting. Fix: Confirm the agent's service is running and has network access, since Stale means it has not checked in for more than 5 minutes.
- Symptom: The Offline count stays at 0 but you know a specific machine's agent is down. Fix: Use Search machines in the All Machines table to find that machine directly; dashboard-level counts can lag behind a single machine's real-time status.
- Symptom: A machine group you created shows no bar in Agents by Group. Fix: Confirm at least one agent is assigned to that group on Insight: Machine Groups; empty groups don't appear until an agent is attached.
Related articles
- Prerequisite: Configuration: Insight: Machines - Insight agents are installed and registered here before they appear on the dashboard
- Prerequisite: Insight: Machine Groups - machine groups must exist before agents can be organized and shown in the Agents by Group chart
- See also: Main: Insight - entry point describing the Insight module this dashboard belongs to