observability
Overview
gnome-hive-monitor is an extension for GNOME Shell (extension.js) written in JavaScript/GJS. It queries the Hive status API (GET /api/widget) and optionally communicates with GitHub API endpoint (POST /repos/{owner}/{repo}/issues) via libsoup 3.0 (Soup.Session).
Managed-Project Observability Posture
Per operations policy:
- The extension has no exporter or external backend for telemetry.
- The extension includes no telemetry exporter (e.g. Prometheus exporter, OTLP collector endpoint).
- Observability relies on structured client-side GLib/GJS console logging (
console.log,console.warn,console.error) written to standard system logger (journalctl -f -u gnome-shellorjournalctl --user -f -o cat).
Operational Guidelines & Diagnostic Logging
- Client Diagnostics: Structured console logs must include the
[GNOME Hive Monitor]prefix for auditability. - Error Logging: Record network timeouts, HTTP 4xx/5xx responses, invalid JSON, and errors from issue submission through the API in
journalctl. - Future Exporter Integration: If an operator selects a telemetry collector or backend, send client metrics through a local loopback listener. Include poll latency, counters for HTTP status codes, and UI error rates. Do not add dependencies on third-party SaaS.