This glossary defines the key terms used throughout the Kudzu Canopy NOC documentation. Use it as a quick reference when you encounter an unfamiliar concept.
- Action Center
- The first view you see after login. It shows a color-coded network status banner, overview widgets for devices, gateways, alarms, and certification, and AI-generated network optimization suggestions.
- Navigation sidebar
- The persistent left-side panel present on every page. It is divided into three sections: the network selector header at the top, the navigation menu in the middle, and the utility bar and profile button at the bottom.
- Network selector
- The clickable header at the top of the navigation sidebar that displays the current network name and opens a dropdown for switching between networks. Private networks show a yellow padlock icon; public networks show a blue globe icon.
- Nomi
- The platform’s built-in AI chatbot assistant. Accessible from the Chat with Nomi button in the sidebar, the
/ keyboard shortcut, and contextual Get Insights sparkle buttons on metrics, gateways, devices, and alarms. - Get Insights
- A sparkle icon button that appears on metrics cards, gateway entries, device entries, and alarms. Clicking it opens Nomi with context pre-focused on the specific item.
- Theme toggle
- A button in the sidebar utility bar that switches the interface between light and dark themes. Shows a moon icon in light mode and a sun icon in dark mode.
- Notifications bell
- A bell icon in the sidebar utility bar that provides access to alarm notifications. Displays a badge when unread notifications exist. Notifications are also delivered through email and browser alerts.
- Onboarding checklist
- A guided setup checklist shown on the Action Center when a network has not completed initial configuration. It tracks required steps such as adding an LNS integration, populating devices and gateways, importing dashboards, and enabling monitoring.
- Onboarding view
- The state of the Action Center shown to new users whose network is not yet configured. The status area is grayed out with a “No data” indicator, and the main content shows the onboarding checklist.
Networks and Inventory#
- Network
- The main operational scope in Canopy NOC. A network contains gateways, devices, integrations, zones, deployment plans, analysis instances, dashboards, reports, insights, and permissions.
- Private network
- A network marked with a yellow padlock icon in the network selector. Access is restricted to authorized users.
- Public network
- A network marked with a blue globe icon in the network selector. Accessible to all platform users.
- Gateway
- A LoRaWAN gateway in the operator’s network. Gateways can be active, idling, inactive, or decommissioned based on recent statistics and traffic.
- Gateway status
- The operational lifecycle state of a gateway — Planning, Live, or Decommissioned.
- GPS synchronization (gateway)
- A toggle that, when enabled, automatically updates the gateway’s map location from its GPS antenna signal.
- Integration binding
- The cross-integration identifier mapping configured per gateway. It links a gateway to its records across different LNS or data-source systems.
- Device / mote
- A LoRaWAN end device. Devices can be known, external/noise, active, recently seen, not seen, or disabled depending on inventory and activity.
- Device EUI
- The globally unique LoRaWAN identifier for an end device.
- Estimated device location
- A platform-computed position for a device based on signal triangulation from collected gateway data, shown as a red pin on the device’s location tab.
- Signal quality histogram
- A chart on the device detail view that shows the distribution of observed signal quality across all gateways, including average and band markers.
- Device EUI resolution
- An advanced integration option that controls how the platform deduplicates devices sharing the same device address, such as ABP devices or address reuse scenarios.
Integrations#
- Integration
- A configured data connection that brings network evidence into the platform. Includes LNS integrations, HTTP ingress endpoints, and API ingress credentials.
- LNS integration
- A dedicated integration that connects to a LoRaWAN Network Server through implementation-specific channels. This is the preferred high-quality data source.
- HTTP ingress
- A network-specific HTTP endpoint that receives pushed payloads and uses a decoder script to interpret them.
- API ingress
- An API-based ingestion path for external collectors or middleware, useful for packet-forwarder collection and custom integrations.
- Payload decryption script / decoder script
- A selectable script on the HTTP Ingress creation form that interprets inbound payloads from an upstream system into the platform’s normalized format.
- Kudzu analytics repository
- The public GitHub repository at
github.com/kudzu-technologies/analytics containing protobuf definitions, a gRPC endpoint, and example clients for building custom API Ingress integrations.
Analysis and KPIs#
- KPI / metric
- A computed value emitted by an analysis algorithm. A metric can be a number, a ratio, or a count with references to the affected entities.
- Analysis algorithm / analysis template
- A scheduled JavaScript program that reads network data and emits metrics, references, tags, and geotags.
- Analysis instance
- The configuration that enables one or more analysis algorithms for a specific network, including parameters, pinned metrics, and notification preferences.
- Analysis data
- The stored result of an analysis run — the evidence frame used by metric history, alarms, reports, map layers, and AI context.
- Import analysis
- The action on the Monitoring KPIs configuration page that registers analysis algorithms for a network, causing their metrics to appear on the Metrics Dashboard.
- Enable reporting
- An action on the Metrics Dashboard that activates automated metric computation for the network. Once enabled, you must also import analysis algorithms to begin producing KPI data.
- Problem tree / taxonomy
- The hierarchy that classifies problems, analysis algorithms, metrics, alarms, and insights into five root categories.
- Favorites
- A user-curated collection of pinned metrics on the Metrics Dashboard. Each metric card has a pin button, and pinned metrics appear in a dedicated section at the top.
- Map focus
- An automatic behavior on the Metrics Dashboard and Alarms views where hovering over a metric, algorithm, or problem category updates the adjacent map panel. Map focus can be locked by clicking a section title.
Alarms and Notifications#
- Alarm
- A threshold rule attached to a metric. Multiple alarms may exist for one metric to represent different severity levels.
- Criticality / severity level
- The user-facing importance of an alarm, represented by a name, color, and weight from 0 to 100.
- Alarm status
- The current state of a metric after alarm evaluation, including the highest-weight active alarm and whether the state is flapping.
- Investigate
- A contextual action on the Alarms metric detail page that opens Nomi with full context about the alarm, metric history, and affected entities for AI-assisted debugging.
- Notification
- A user-facing message stored in the inbox and optionally delivered through email, Discord, or other channels.
AI and Reports#
- Network insight problem
- An AI- or user-created representation of an operational issue in a network.
- Network insight solution
- A proposed action or strategy for addressing a network insight problem.
- Network optimization suggestion
- An Action Center recommendation that proposes ways to address a network insight problem, including strategy metadata, feasibility, implementation guidance, checklist items, and entity references.
- Report
- An asynchronously generated document for a network and reporting range. Reports move through lifecycle states: Draft, Rendering, Failed, Needs Input, and Completed.
- Certification
- An optional operator status workflow that tracks whether surfaced network issues are resolved within an agreed SLA.
Operations and Planning#
- Deployment
- A planned or imported representation of network infrastructure, including simulated gateways, sample points, coverage files, and related metadata.
- Deployment view
- The map-centered interface under Operations used by field teams to track installation progress against planned coverage.
- Deployment cell
- A hexagonal map tile representing a geographic area and its deployment status — red (not matched), blue (in progress), or green (fully deployed).
- Planned gateway location
- A position on the deployment map where the RF planning simulation expects a gateway. Rendered as a blue ring; darkened when matched by an actual gateway.
- RF path shadowing
- An advanced deployment map layer showing a monochrome heat map of locations with high RF absorption, typically caused by buildings or obstructions.
- Deployment preset / layer preset
- One of three preconfigured layer combinations in the deployment view: View Deployment Overview, View Gateway Location and Coverage, and View Device Locations.
- Planning session
- A map-centered workflow for allocation, analysis, management, and reporting of future network changes.
Investigation and Visualization#
- Dashboard / Investigation View
- A saved, widget-based page that visualizes raw aggregated network data through charts, tables, gauges, heat maps, and maps. Predefined dashboards include Geo-Positioned Analysis, LoRa Uplink Analysis, LoRa Infrastructure Stress, and LoRa Downlink Analysis.
- Traffic source filter
- A global dropdown on investigation dashboards that filters data by origin — All Traffic, Only Internal, or Only External. Useful for isolating interference from neighboring networks.
- Time window selector (investigation views)
- A global dropdown that controls the time range for all widgets. Options include 24 hours, 2 days, 1 week, 2 weeks, 30 days, 90 days, and custom ranges.
Map and Geography#
- Entity reference
- A typed link to a platform object or geography — device, gateway, integration, metric, dashboard, incident, zone, point, or H3 cell. Entity references connect markdown, maps, charts, AI output, and API responses to the same underlying evidence.
- RF-quality hexagon / signal-strength cell
- A map region that summarizes observed signal quality for devices in that area, color-coded against the Avg RSSI (dBm) legend.
- Estimated radiation pattern
- A gateway hover visualization that reconstructs directional signal behavior from observed device traffic. This is a synthetic operational estimate, not the physical antenna’s laboratory pattern.
- Zone
- A user-defined geographic polygon that classifies traffic by the devices within each region. Zones enable zone-scoped analysis, reporting, and metric breakdowns.
Configuration and Access#
- Support notes
- Free-text contextual information on the Network configuration page describing deployment specifics. The automatic analysis uses these notes to produce more relevant results.
- Preferences (network)
- Sensitivity sliders on the Network configuration page that control how aggressively the platform triggers alarms. Adjustable dimensions include outage sensitivity, coverage degradation, scale of impact, time criticality, and data quality.
- Listing options
- A toggle that controls whether the network is publicly discoverable on the platform.
- Frequency plan
- Regional RF settings used by analysis algorithms and planning simulations.
- API tokens
- Personal access tokens issued through the profile menu for programmatic access to the platform, including a REST API base URL and an MCP endpoint.