macluckylab.com
Gaugely
Support
Gaugely is a native iOS viewer for self-hosted Grafana dashboards. It reads dashboards through Grafana's HTTP API and re-renders the panels with Swift Charts - no embedded web pages and no image renderer. It supports multiple servers, alerts with notifications, widgets, Siri shortcuts, and an ad-hoc Explore mode for PromQL, LogQL, and LogsQL.
Contact
Email [email protected] with any question, bug report, or feature request. Include your Grafana version and the panel type or query involved when reporting a problem.
Common questions
- The app cannot connect to my server.
- Your Grafana server must be reachable from the device. For a homelab instance that usually means being on the same network or connected through a VPN such as Tailscale or WireGuard. Plain HTTP and self-signed certificates are supported; enable "Allow self-signed certificates" for the latter.
- Which authentication method should I use?
- A Grafana service account token (starts with glsa_) is the recommended option; a Viewer role is enough for dashboards and alerts. Basic auth and anonymous access work too, and custom HTTP headers cover reverse-proxy SSO setups such as Cloudflare Access.
- A panel shows "unsupported".
- Gaugely renders time series, stat, gauge, bar gauge, table, pie, bar chart, state timeline, status history, histogram, heatmap, geomap, logs, text, alert list, dashboard list, and news panels. Panels backed by datasources that cannot be queried through Grafana's API (for example SQL or Infinity) show a placeholder instead.
- Alert notifications arrive late or not at all.
- Notifications come from background polling of your own servers, and iOS decides when background refresh runs - typically every 15 minutes or more. The server must also be reachable at that moment, so a VPN that disconnects in the background will pause notifications.
- My widget shows old data.
- iOS budgets how often widgets refresh. The widget also shows the last fetched data when the server is unreachable, marked as offline, rather than an error.
Privacy policy - Gaugely collects no data.