Live Globe
Primary situational view. Shows tracked aircraft, live anomaly events by class, watch-grid overlays, and the historical leaderboard. The dashboard and watch-grid workflow start here.
Open Globe →Platform User Guide
The core SkyGrid workflow is five steps: open the live map, create a watch grid, review events, route alerts, and access structured data. This guide walks through each step with the specifics needed to run a practical monitoring loop.
Quick-start order
- Check the live globe to understand current regional activity.
- Create one watch grid with a single anomaly class and confirm events are arriving.
- Add a webhook destination and test delivery before treating it as operational.
- Expand to additional classes or regions once the first grid is working reliably.
- Use the API and leaderboard to pull structured data into reporting workflows.
01
Open the live anomaly map
Start from the homepage. The live globe shows tracked aircraft, active anomaly events, and your watch-grid overlays in one view. Use Basic View for the current air picture. Switch to Advanced View to enable coverage and weather context layers.
Tip
The hero stats panel shows tracked aircraft count, active anomalies, active watch grids, and alert deliveries in the last 24 hours. Use these as a quick signal check before drilling into events.
02
Create a watch grid
Open the Dashboard and scroll to the Watch-Grid control plane. Enter a name, choose your anomaly classes from eight available types (loiter, ghost, squawk, rapid-descent, ICAO spoof, formation flight, callsign duplicate, and GPS jamming), and use the Quick Location lookup or draw mode to define the H3 cell region. Set the minimum loiter dwell time to match your review cadence. Start with one grid before expanding coverage.
Tip
Tighter filters mean fewer alerts. Start with a single anomaly class in a high-interest region and confirm you can action the event volume before adding more classes or regions.
03
Review anomaly events
The watch-grid manager shows event history for each active grid. Click a grid to expand its event list. Each event includes the aircraft ICAO24 identifier, callsign, anomaly type, dwell time (for loiter events), location, and a timestamp. Signed-in users can use the historical leaderboard on the live map to review regional and country-level aggregations over 24h, 7d, or 30d windows.
Tip
Activity scoring weights: loiter x3, ghost x2, squawk x1, rapid-descent x3, ICAO-spoof x3, GPS-jamming x3, formation-flight x2, callsign-duplicate x2. Use this to prioritise which aircraft to investigate across a historical window.
04
Route alerts to your workflow
In the watch-grid manager, add a webhook destination to each grid. Choose Slack, Teams, Discord, or a generic HTTPS endpoint. Enter the target URL. Use the Test button to confirm delivery before treating the destination as operational. Events matching the grid's anomaly filters will POST to the destination automatically.
Tip
Email routing is configured separately through the alert settings. Webhook delivery is recommended for team integrations and automation. Keep at least one active destination per mission-critical watch grid.
05
Use the API for structured data access
The SkyGrid API provides live aircraft snapshots, anomaly event streams, watch-grid configuration endpoints, and the historical anomaly leaderboard. Generate an API key from the Dashboard keys section. Use the key in the x-api-key header. Review the OpenAPI spec for full endpoint coverage, request shapes, and response schemas.
Tip
The anomaly leaderboard endpoint (/api/v1/network/anomaly-leaderboard) supports window, type, and offenderQuery parameters. Use it to pull structured regional summaries into reporting tools or notebooks.
Key platform surfaces
Dashboard
Primary workspace for watch-grid configuration, event history review, webhook destination management, API key issuance, and alert delivery health. Requires sign-in.
Open Dashboard →API & Data
Structured access to aircraft snapshots, anomaly events, watch-grid configuration, and the historical leaderboard. Full OpenAPI spec available with request and response examples.
View API Docs →