diff --git a/README.md b/README.md index b819927..66fa7c7 100644 --- a/README.md +++ b/README.md @@ -206,7 +206,10 @@ servers along the bottom. Power gear (PDU, UPS, power strip) sits in a rail on t - **Unknown devices**: something plugged into a switch port that Gandalf can't name is a grey stub, labelled with the port name (or its address), linking to that port. By default each switch's unknown devices are one block with one bundled cable ("10 unknown devices"); click it to show them one by - one, or pick "one by one" or "hidden" in the toolbar. + one, or pick "one by one" or "hidden" in the toolbar. When the cutsheet records the cable going into + a patch panel, the far end is drawn as that panel's 24 jacks with the cable on its documented port, + named "Patch panel port 1" (the device beyond the panel is unknown); a stub that already has a name + keeps it and adds "via Patch panel port 2". The cable details show where the cutsheet cable goes. - **Port names**: a ⚠ marks a port named after one device with a different one plugged in (a port called "Large1 Management" with the AP on it). Generic names ("Port 4", "SFP+ 2", "Uplink") and "Downlink to X" with X on the other end never flag. @@ -214,16 +217,24 @@ servers along the bottom. Power gear (PDU, UPS, power strip) sits in a rail on t severity colour, and the NIC it is about is marked. - **Power**: each PDU, UPS and power strip card lists its outlets that feed something, draw power or are off, with live watts; each device it feeds shows a ⚡ badge with what it draws. Hover a power - card or a device to draw its feeds. An outlet that is off but feeds something is listed above the + card or a device to draw its feeds. The SmartPower Strip has no metering, so it never shows watts. An outlet that is off but feeds something is listed above the diagram. What an outlet feeds comes from, in order: an assignment saved here, the outlet's name in UniFi when it names a device ("storage-01", "Dream Machine Pro", "AT&T Modem" for the modem), or a MAC in its name that belongs to a host NIC or UniFi device. Admins click an outlet to set what it feeds, set it to nothing, or go back to automatic. Assignments are kept in Gandalf (table `power_feeds`); Gandalf never renames outlets in UniFi. API: `PUT /api/topology/power//` with `{"target": ""}`, `""` for nothing or `null` for automatic. +- **Stale outlet watts**: UniFi can keep serving one frozen set of USP PDU Pro outlet readings for hours + while the unit's total stays live. When a unit's loaded outlets have not changed at all for 15 minutes, + the monitor marks them stale: the outlet rows say "stale" instead of watts, ⚡ badges say "fed", and + the list above the diagram says since when (`outlets_stale_since` in `link_stats.unifi_devices`). The + marks clear on the next poll after the readings move. The 15 minutes start again when the monitor + restarts. Restarting the PDU or updating its firmware in UniFi is the usual cure. - Click a device for its page, or a port on a faceplate for that port. Click a cable for its details: both ends, speed, cable type and module, traffic each way and how busy it is, errors and drops, and - its cutsheet record. Hovering a device traces its path to the internet. + its cutsheet record. Hovering a device traces its path to the internet. On a touch screen, which + has no hover, the first tap on a device traces it (path and power feeds) and a second tap opens it; + tapping empty canvas clears it. - Drag to pan, scroll or pinch to zoom, **Fit** (or `0`) to see everything, `+` and `-` to zoom. Show unknown devices grouped, one by one or not at all. **Server 1G links** (off by default) adds each server's slower second cable, its management link; **Power gear** shows or hides the power rail. Traffic labels and dimming everything without an alert can be switched too. The @@ -245,7 +256,8 @@ interface and port names, and LLDP neighbors. - **Alerts**: active and past alerts for this device - **WAN** (routers): connection state, speed, latency, availability - **Connected to** (hosts): switch ports that see this host over LLDP -- **Outlets** (PDUs): per-outlet state, power, and auto power-cycle setting +- **Outlets** (PDUs, UPS, power strip): per-outlet state, power, and auto power-cycle setting; readings + UniFi has frozen are marked stale (see Topology) - **Port inspector** (switches, routers): see below - **Interfaces / Ports**: one row each with state, speed, RX/TX rate, and neighbor, filterable. Expanding a host's row shows duplex, auto-negotiation, carrier changes, error and drop rates, @@ -318,6 +330,7 @@ neighbors that can't be matched show their MAC. Bonded NICs share a MAC, so only | `USMINI` | USW Flex Mini | 5×RJ45, PoE in on port 1 | | `USPPDUP` | USP PDU Pro | 20 outlets (4 USB-C, 16 AC), management port 21, surge pass-through ports 22-23 | | `USPDA2B` | UPS 2U Pro | Front with touchscreen outlet tiles; rear with 8 outlets, EPO, surge and MGMT ports | +| `UP6` | SmartPower Strip | Top face: 6 AC outlets in facing pairs, 4 USB-C (switched together as outlet 7) | Port LEDs use the colors from each model's quick start guide. Other models use plain blocks until they get an entry in `FACEPLATES`. @@ -833,6 +846,7 @@ gandalf/ UniFi gear drawn with live ports: UDM Pro (`UDMPRO`), USW Pro 24 PoE (`US24PRO`), USW Aggregation (`USL8A`), USW Flex (`USF5P`), USW Flex Mini (`USMINI`), USP PDU Pro (`USPPDUP`), UPS 2U Pro (`USPDA2B`), +SmartPower Strip (`UP6`, outlets only), USW Pro Max 24 PoE (`USPM24P`, also `USPM24`) and USW Pro Max 48 PoE (`USPM48P`, also `USPM48`), plus the UniFi NVR Pro (`UNVRPRO`), which UniFi Network doesn't report and so is picked by Front drawing. The Pro Max switches also have Front drawing options, so a new switch draws correctly on the rack before it is diff --git a/docs/img/topology.png b/docs/img/topology.png index a101532..69a4671 100644 Binary files a/docs/img/topology.png and b/docs/img/topology.png differ