Sites

Sites represent the physical or logical locations where your network infrastructure resides. Every device in Chompy is assigned to a site, which enables geographic map visualization, site-level health rollups, inter-site traffic analysis, and per-site filtering across dashboards and flow queries.

Site Management

The Site Management table displays all configured sites with the following columns:

Column	Description
ID	Auto-generated unique identifier for the site.
Name	A short, unique label for the site (e.g., Default, AWS, Probes). Site names must be unique across the system.
Description	A free-text description providing additional context. This can be a location description (e.g., us-east-2), a functional label (e.g., Auto-created site for probe devices), or left as the default value.
Address	An optional street address or region label for the site. Displayed for reference purposes — geographic positioning on the map is driven by the Coordinates field.
Coordinates	Latitude and longitude values used to place the site on the geographic map. Displayed as a comma-separated pair (e.g., 34.6937, -82.8374). Sites without coordinates show a dash (—) and will not appear on the geographic map.
Created	The date the site was created.
Actions	Edit or delete the site.

+ Add Site

Opens a form to create a new site. The following fields are available:

• Name (required) — Must be unique. Used throughout the UI in device assignment dropdowns, dashboard filters, and the geographic map.
• Description — Optional context for the site.
• Address — Optional street address or region label.
• Latitude / Longitude — Decimal coordinates for geographic map placement. You can obtain coordinates from Google Maps by right-clicking any location and copying the latitude/longitude values.

Edit

Opens the site form pre-populated with the current values. All fields except the ID can be modified. Changing a site's coordinates will immediately update its position on the geographic map.

Delete

Permanently removes the site. Devices assigned to this site will have their site assignment cleared due to the cascading foreign key relationship. Use caution when deleting sites that have active devices — reassign devices to another site first if needed.

How Sites Are Used

Device Organization

Every device (routers, switches, firewalls, VPCs, probes) is assigned to a site via the Devices settings tab. This assignment drives site-level aggregation throughout the platform. When a device's health status changes (detected via SNMP polling or flow-based health checks for VPC devices), the site's overall health indicator reflects the worst status among its member devices.

Geographic Map

The geographic map on the main dashboard plots each site as a marker at its configured coordinates. Sites are color-coded by health status (green, yellow, red). LLDP-discovered connections between devices at different sites are drawn as lines between the markers, with line thickness representing traffic volume. Sites without coordinates are excluded from the map.

Site-Level Filtering

Dashboards, flow queries, and reports can be filtered by site. This narrows results to only traffic and metrics from devices assigned to the selected site, which is useful for multi-location networks where you want to analyze a single office or data center in isolation.

Auto-Created Sites

Some sites are created automatically by the system. For example, the Probes site is auto-created when the first Chompy probe registers and no explicit site assignment is configured. Auto-created sites can be edited or deleted like any manually created site.

Importing Sites from NetBox

If you have a NetBox instance configured under Settings → Integrations → NetBox, you can import sites directly rather than creating them manually. The NetBox integration pulls site name, description, physical address, and latitude/longitude coordinates, so imported sites are immediately available on the geographic map.

To import sites from NetBox:

1. Navigate to Settings → Integrations → NetBox and ensure your API URL and token are saved.
2. Check the Sites checkbox under Import Options.
3. Click Preview Selected to review which sites will be created or updated. Sites that already exist in Chompy (matched by name) are flagged as updates rather than new imports.
4. Click Import Selected to execute the import.

The import uses an upsert strategy — existing sites are updated with any new data from NetBox (description, coordinates, address) without overwriting fields that already have values in Chompy. An integration_mappings record is created for each imported site to track the relationship between the local Chompy site and the remote NetBox record for future syncs.

tip

Import sites before importing devices. The device import maps each device to a Chompy site by matching the NetBox site name, so sites need to exist first.

Common Site Configurations

On-Premises Sites — Represent physical office locations, data centers, or colocation facilities. Set the coordinates to the building's location for accurate map placement. Assign all local routers, switches, and firewalls to the site.

Cloud Sites — Represent cloud regions or VPCs. For example, an AWS site with description us-east-2 groups all VPC devices in the Ohio region. Address can be set to the region name for quick reference. Coordinates can point to the AWS region's approximate geographic location.

Probe Sites — Group remote Chompy probes. Probes deployed to remote locations (branch offices, cloud instances) can be assigned to their own site or co-located with the infrastructure they monitor.