Connections
Manage external service connections: ClickHouse databases for persistence and analytics, and tile servers for map rendering. Every connection has a lifecycle with built-in health testing.
graph LR
CM["ConnectionManager"] --> DB["Database<br/><small>ClickHouse</small>"]
CM --> TS["TileServer<br/><small>Local / Remote</small>"]
CM --> CU["Custom"]
DB --> ST["Status Lifecycle"]
TS --> ST
ST --> D["Disconnected"]
ST --> C["Connected"]
ST --> T["Testing"]
ST --> E["Error"]
Connection Types
enum ConnectionType auto-generated
| Variant | Fields | Description |
|---|---|---|
| Database | (DatabaseType) | |
| TileServer | (TileServerType) | |
| Custom | (String) |
Database Configuration
Configure ClickHouse connections for telemetry storage and historical analysis.
yaml DatabaseConfig auto-generated
| Field | Type | Default | Description |
|---|---|---|---|
| host* | String | — | |
| port* | u16 | — | |
| database* | String | — | |
| username* | String | — | |
| password | String | — | |
| use_tls* | bool | — |
Tile Server Configuration
Configure map tile endpoints for the Scene3D globe renderer.
yaml TileServerConfig auto-generated
| Field | Type | Default | Description |
|---|---|---|---|
| url* | String | — | |
| api_key | String | — | |
| tile_format* | TileFormat | — | |
| max_zoom* | u8 | — |
Connection Status Lifecycle
enum ConnectionStatus auto-generated
| Variant | Fields | Description |
|---|---|---|
| Disconnected | — | |
| Connected | — | |
| Testing | — | |
| Error | — |
Connection Management
- Add: Create a new connection with name, type, and type-specific config
- Test: Verify connectivity — transitions status to Testing, then Connected or Error
- Delete: Remove a connection by ID
- Groups: Organize connections with optional group labels
- Timestamps:
last_testedrecords when each connection was last verified
Questions?
Reach out for help with integration, deployment, or custom domain codecs.