Racks, notes and to-do, OS support, suggested dependencies, Nginx Proxy Manager and Home Assistant
- Racks page and a network diagram (UniFi tree with servers, printable) - Notes on servers and devices; To do list shown in Coming up and My work - Agents report the operating system (Linux 7, Windows 6); end-of-life badge and alert - Suggested dependencies from where a service is reached - Nginx Proxy Manager integration: proxy hosts page, certificate and host alerts, suggested checks - Home Assistant integration: watch chosen entities, history chart, limit and unavailable alerts - TimeChart gets a "value" scale that fits negatives; docs updated Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
68b41b5586
commit
18ceed62e8
77 files changed
+20432
-35
No files matched your search
+77
-1
@@ -61,6 +61,10 @@ erDiagram
|
||||
integrations ||--o{ network_devices : "cascade"
|
||||
integrations ||--o{ network_segments : "cascade"
|
||||
integrations ||--o{ network_server_links : "cascade"
|
||||
integrations ||--o{ ha_watched : "cascade"
|
||||
integrations ||--o{ ha_entities : "cascade"
|
||||
integrations ||--o{ ha_readings : "cascade"
|
||||
users ||--o{ todos : "assignee (set null)"
|
||||
servers ||--o{ network_server_links : "cascade"
|
||||
integration_credentials ||--o{ dns_providers : "credential (set null)"
|
||||
dns_providers ||--o{ dns_zones_cache : "cascade"
|
||||
@@ -74,7 +78,7 @@ erDiagram
|
||||
integrations ||--o{ alert_tickets : "osTicket used (set null)"
|
||||
```
|
||||
|
||||
Seventeen tables stand alone, with no foreign keys: `settings`, `secrets`,
|
||||
Eighteen tables stand alone, with no foreign keys: `settings`, `notes`, `secrets`,
|
||||
`ipam_entries`, `domains`, `diag_log`, `notification_queue`,
|
||||
`consistency_ignores`, `tag_definitions`, `share_links`, `maintenance_schedules`, `metrics_tokens`, `event_webhooks`, `alert_incidents`, `dependencies`, `endpoint_checks`, `restore_tests`, `heartbeats`. `maintenance_windows` and `maintenance_aliases` also have no
|
||||
foreign key — see [soft references](#soft-references-not-foreign-keys).
|
||||
@@ -238,6 +242,7 @@ what it last reported.
|
||||
| `host_health` | text | JSON `{"failedUnits":[{unit,description}],"smart":[{device,model,healthy,temperatureC,wearPercent}],"zfs":[{name,health,capacityPercent}],"reportedAt":"…"}`. Each part is present only if the agent reported it, and a report that leaves one out leaves it as it was. Null until an agent says anything. Judged by the health check and shown on the server's page. |
|
||||
| `hw_manufacturer`, `hw_model`, `hw_serial` | text | What the machine is, as its firmware says (the agent reports it; placeholders like "To Be Filled By O.E.M." are left out). Each is replaced only when a report has a value, so an agent that can't tell doesn't wipe what it said. Used to fill in the inventory. |
|
||||
| `agent_diagnostics` | text | JSON `{"items":[{check,status,reason?,detail?}],"reportedAt":"…"}`: what the agent says it could not collect (`status` is `unavailable` or `failed`). Replaced by each report that carries the list (an empty list means nothing was missed) and kept when a report doesn't. Turned into words and fixes by the server; never sent to the browser as it is. |
|
||||
| `os_id`, `os_name`, `os_version` | text | The operating system the agent reports: `os_id` is lower case (`ubuntu`, `debian`, `proxmox-ve`, `windows`…), `os_name` is what to show, `os_version` the release (a Windows build number on Windows). Replaced only by a report that says; null until then. The end-of-life dates are not stored: they are a table in the app. |
|
||||
| `agent_version` | integer | Which version of the agent script runs on it, as the agent says in each report. Null until it says; an agent that predates the number counts as version 1. Compared with the scripts the app serves to say which agents are behind. |
|
||||
|
||||
#### `scheduled_tasks`
|
||||
@@ -471,6 +476,12 @@ JSON) plus a few internal bookkeeping rows. Details under
|
||||
|
||||
Internal flag `unifiSync`: a JSON object keyed by integration id, `{ at (ISO — the last *successful* read), ok, error, sites, mode, devices, networks, ssids }`. A controller whose `at` is older than twenty minutes is not judged for offline devices.
|
||||
|
||||
Internal flag `homeAssistantSync`: a JSON object keyed by integration id, `{ at (ISO — the last *successful* read), ok, error, entities }`. A Home Assistant whose `at` is older than twenty minutes is not judged.
|
||||
|
||||
Internal flag `dependencySuggestionsDismissed`: a JSON array of the suggestion keys (`integration:3>server:1`) somebody said *Not that* to.
|
||||
|
||||
Setting `healthChecks.osSupportWarnDays` (default 90, 0–365): how many days before an operating system's end of support it is a warning.
|
||||
|
||||
Internal flag `flapState`: a JSON object keyed by alert key, `{ raises: number[] (epoch ms of raises in the last hour), flapping: boolean, since, lastEvent, message }`. It is what lets a restart remember which alerts are being held as flapping; entries are dropped once an alert has been calm for an hour.
|
||||
|
||||
#### `tag_definitions`
|
||||
@@ -728,6 +739,71 @@ The networks (VLANs) and Wi-Fi names of a UniFi controller, replaced as a whole
|
||||
| `security`, `network_name` | text | A Wi-Fi name's security, and the network its clients land on. |
|
||||
| `updated_at` | text NOT NULL | ISO. |
|
||||
|
||||
#### `notes`
|
||||
|
||||
A free-text note about a server or a network device.
|
||||
|
||||
| Column | Type | Notes |
|
||||
|---|---|---|
|
||||
| `id` | integer PK | |
|
||||
| `target_type`, `target_id` | text, integer NOT NULL | `server` or `device`, and its id. Unique together: one note each. Not a foreign key (a removed thing's note is ignored). |
|
||||
| `body` | text NOT NULL | The text, with the small formatting runbooks use. Saving an empty one deletes the row. |
|
||||
| `updated_by` | text | Who last saved it, as a name. |
|
||||
| `updated_at` | text NOT NULL | ISO. |
|
||||
|
||||
#### `todos`
|
||||
|
||||
The small jobs of **Operations → To do**.
|
||||
|
||||
| Column | Type | Notes |
|
||||
|---|---|---|
|
||||
| `id` | integer PK | |
|
||||
| `title` | text NOT NULL | |
|
||||
| `detail` | text | |
|
||||
| `due_date` | text | `YYYY-MM-DD`. A job with a day, while open, is on the Coming up calendar. |
|
||||
| `assignee_user_id` | integer → `users.id`, **set null** | Who it is handed to. |
|
||||
| `assignee_name` | text | Their name when it was handed over, so it still reads if they are removed. |
|
||||
| `target_type`, `target_id` | text, integer | `server` or `device`, and its id, when the job is about one. Not a foreign key. |
|
||||
| `created_by`, `created_at` | text | |
|
||||
| `done_at`, `done_by` | text | ISO and a name; null while open. |
|
||||
|
||||
#### `ha_watched`
|
||||
|
||||
The Home Assistant entities somebody chose to watch (see INTEGRATIONS.md).
|
||||
|
||||
| Column | Type | Notes |
|
||||
|---|---|---|
|
||||
| `id` | integer PK | |
|
||||
| `integration_id` | integer NOT NULL → `integrations.id`, **cascade** | The Home Assistant. Unique together with `entity_id`. |
|
||||
| `entity_id` | text NOT NULL | `sensor.ups_battery`. |
|
||||
| `name` | text | What to call it here; the entity's own friendly name when null. |
|
||||
| `above`, `below` | real | Limits for a numeric value: an alert when it is over `above` or under `below`. |
|
||||
| `created_at` | text NOT NULL | ISO. |
|
||||
|
||||
#### `ha_entities`
|
||||
|
||||
What the last read said about each watched entity. Primary key (`integration_id`, `entity_id`); `integration_id` is a foreign key with **cascade**. Rows of an entity no longer watched are removed on the next read.
|
||||
|
||||
| Column | Type | Notes |
|
||||
|---|---|---|
|
||||
| `friendly_name`, `unit`, `device_class` | text | |
|
||||
| `state` | text NOT NULL | As Home Assistant says it; `missing` when it is no longer in Home Assistant at all. |
|
||||
| `value` | real | The state as a number, when it is one. |
|
||||
| `last_changed` | text | ISO, from Home Assistant. |
|
||||
| `unavailable_since` | text | ISO. When it was first seen `unavailable`, `unknown` or missing; kept until it speaks again. The alert counts from here. |
|
||||
| `updated_at` | text NOT NULL | ISO. |
|
||||
|
||||
#### `ha_readings`
|
||||
|
||||
A numeric value of a watched entity at a moment, for the chart: one at most every two minutes, deleted after 35 days. `integration_id` is a foreign key with **cascade**; (`integration_id`, `entity_id`, `at`) is indexed.
|
||||
|
||||
| Column | Type | Notes |
|
||||
|---|---|---|
|
||||
| `id` | integer PK | |
|
||||
| `entity_id` | text NOT NULL | |
|
||||
| `at` | text NOT NULL | ISO. |
|
||||
| `value` | real NOT NULL | |
|
||||
|
||||
#### `push_subscriptions`
|
||||
|
||||
A browser or phone that asked for push notifications, one row per device.
|
||||
|
||||
Reference in new issue
Block a user