Update CLAUDE.md: OID col 7, visible name formula, template group permissions

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-04-17 10:58:27 +02:00
parent 2034f275d0
commit a2358ed0c3

View File

@@ -62,6 +62,7 @@ Web UI
- col 4 `STRING` last_seen (ISO-8601) - col 4 `STRING` last_seen (ISO-8601)
- col 5 `INTEGER` updating (0/1) - col 5 `INTEGER` updating (0/1)
- col 6 `INTEGER` registered (0/1) - col 6 `INTEGER` registered (0/1)
- col 7 `INTEGER` last_seen_unix (Unix timestamp, 0 if unknown) — used by the "not seen 4h" trigger
The Yodeck ID is used directly as the SNMP table index — OIDs are stable (e.g. `.1.3.6.1.4.1.99999.1.1.3.54239` = online status of player 54239). The Yodeck ID is used directly as the SNMP table index — OIDs are stable (e.g. `.1.3.6.1.4.1.99999.1.1.3.54239` = online status of player 54239).
@@ -75,7 +76,7 @@ The Yodeck ID is used directly as the SNMP table index — OIDs are stable (e.g.
Targets **Zabbix 7.x** (also works with 6.0+). Each player becomes a host: Targets **Zabbix 7.x** (also works with 6.0+). Each player becomes a host:
- **Host name:** `yodeck-<id>` (e.g. `yodeck-54239`) — `#` is not valid in Zabbix 7.x host names - **Host name:** `yodeck-<id>` (e.g. `yodeck-54239`) — `#` is not valid in Zabbix 7.x host names
- **Visible name:** `QRS-<yodeck_name>` (e.g. `QRS-AMS-COF1`) - **Visible name:** `QRS-{first4chars}MB-{remainder}` (e.g. Yodeck name `AMS-COF1` `QRS-AMS-MB-COF1`)
- **SNMP interface:** `APP_HOST:161`, SNMPv2c, community from `ZABBIX_SNMP_COMMUNITY` - **SNMP interface:** `APP_HOST:161`, SNMPv2c, community from `ZABBIX_SNMP_COMMUNITY`
- **Items:** `yodeck.online`, `yodeck.last_seen`, `yodeck.updating`, `yodeck.registered` — SNMP type 20, polled every 1 minute - **Items:** `yodeck.online`, `yodeck.last_seen`, `yodeck.updating`, `yodeck.registered` — SNMP type 20, polled every 1 minute
@@ -83,5 +84,7 @@ Targets **Zabbix 7.x** (also works with 6.0+). Each player becomes a host:
**Required Zabbix setup before first run:** **Required Zabbix setup before first run:**
1. Create host group `Yodeck Players` manually in Zabbix 1. Create host group `Yodeck Players` manually in Zabbix
2. Grant the API token's user group **Read-write** permission on that group (Administration → User groups → Permissions) 2. Grant the API token's user group **Read-write** permission on that host group (Administration → User groups → Host group permissions)
3. The API token user needs at minimum **Zabbix Admin** role to create hosts and items 3. Grant the API token's user group **Read** permission on the `Templates` template group (Administration → User groups → Template permissions) — required for `template.get` to return results
4. Import `zabbix_template.yaml` (Configuration → Templates → Import)
5. The API token user needs at minimum **Zabbix Admin** role to create hosts and items