Skip to main content
Version: 0.10

Coverage

The Coverage module measures how much of your estate each endpoint agent is actually on. It shows one panel per agent integration: the share of in-scope assets that have the agent, the assets that are missing it, agents installed outside the scope, and breakdowns by department, asset type and criticality.

Open it from the sidebar: Modules → Coverage.

Prerequisites​

A panel needs an agent integration that reports coverage. Three do:

IntegrationField that marks an asset as covered
Elastic Agentelastic_exits
CrowdStrikecs_exits
Nessus Agentsnessus_exits

When a tenant creates its first instance of one of these integrations, Velum Edge creates that integration's coverage panel automatically. The figures fill in once the integration has run in a scan and its results are in the inventory.

If none of the tenant's integrations reports coverage, the screen says so and points to Settings › Integrations.

The coverage screen​

The screen is a stack of collapsible panels, one per integration. The first one opens on arrival; the others open when you click them.

Each panel starts with the default widgets:

WidgetWhat it counts
Integration CoverageThe share of in-scope endpoints that have the agent (a gauge)
Total assets in scopeEndpoints that match the scope
Installed integration AgentsAssets with the agent, in or out of scope
Agents out of defined scopeAssets with the agent that are outside the scope
Assets without agentsIn-scope assets missing the agent
New agentsAgents first enrolled or seen in the last 30 days
Agents offlineAgents that have not checked in for 30 days
Integration Agents EnrolledEnrolments over time
Integration Agent VersionInstalled agents by version
By departmentsCoverage per department, worst first
By asset typeCoverage per asset type
By criticalityCoverage per criticality

Click a count or a chart segment to open a menu that takes you to the matching assets in the inventory.

Coverage figures and breakdowns​

The gauge and the three breakdowns are worked out on the server as covered ÷ in scope: the endpoints matching the panel's scope filter that have the agent, divided by all endpoints matching it. An agent on an asset outside the scope does not raise the figure; it is counted under Agents out of defined scope instead.

  • By departments ranks departments from the lowest coverage up. Ties are broken by size, so a large department at the same low coverage comes first. Departments with no covered asset at all are left out of the chart, because they would fill it without telling you much; the card header says how many there are (for example "worst 10 of 37 · 4 with none").
  • By asset type and By criticality list their groups by size.
  • Open the full list on a breakdown opens every group in a table, including those with no coverage, with links to the in-scope and missing assets of each group and an export to CSV.

A breakdown considers at most 1,000 groups. Beyond that the remaining groups are not shown and the breakdown is marked as truncated.

The coverage figures are coloured against the panel's thresholds: below the Problem below value they show as a problem, below Warning below as a warning, and at or above it as healthy.

Refresh​

Refresh reloads every panel and moves relative time windows (such as the last 30 days) up to the current time.

Configuring panels​

Configure opens the Coverage configuration dialog. On the left it lists every integration the module supports, each marked Panel active, No panel or Not configured (the tenant has no instance of it).

ActionEffect
Add panelCreates the integration's panel with the default widgets. Only offered when the tenant runs that integration.
Remove panelTakes the panel and its widgets off the screen. Its settings are kept, so adding the panel again restores them. No asset data is touched.
Save changesSaves the edited settings of every integration in the dialog.

Settings​

Each integration has its own settings.

SettingDefaultWhat it does
Scope filterfields.type: "Server" OR fields.type: "Endpoint"An asset search query for the assets this agent is expected to be on: the denominator of the coverage figures.
Total assets filterEmptyOptional. Narrows the universe the scope is taken from.
New agents window30 daysAn agent enrolled within this window counts as new.
Offline threshold30 daysAn agent that has not checked in for this long counts as offline.
Warning below70%Coverage below this shows as a warning.
Problem below50%Coverage below this shows as a problem.

When you save, Velum Edge checks the settings first:

  • each filter can be at most 2,000 characters;
  • the windows cannot be negative;
  • both thresholds must be between 0% and 100%, and Problem below cannot be above Warning below;
  • the scope filter is run once against the inventory, and a query the asset search rejects is refused, so a broken filter never reaches the panel.
TODO

In the current code only the Scope filter (for the gauge and the three breakdowns) and the two thresholds change what a panel shows. Total assets filter, New agents window and Offline threshold are validated and stored, but no widget reads them yet: the count tiles use the default panel's own queries (servers and endpoints, and a fixed 30-day window for new and offline agents). Update this page when the remaining settings take effect.

Permissions​

TaskPermission
View the coverage screen and its settingsModule Coverage read
See the count and chart tilesAsset Management read (they query the inventory)
Add or remove panels, save settingsModule Coverage write

The module must also be switched on for the tenant; see Modules.