ESO Dashboards
Your Grafana dashboards
iPhone · iPad · Apple TV
Coming soon to the App StoreAbout
ESO Dashboards shows the dashboards of your own Grafana server on iPhone, iPad and Apple TV. Pick a dashboard and its panels appear in the same layout as in Grafana, rendered by your server and arranged natively for the screen in your hand or on the wall. No advertising, no tracking, no ESO account: the app talks only to the servers you add.
- Dashboards: every dashboard of your server, grouped by folder, with search. Set one as the default and the app opens it at startup.
- Native layout: panels follow Grafana's grid on iPad and Apple TV, and are stacked full width on iPhone in portrait. Rows can be expanded and collapsed.
- Refresh: refresh by hand, or automatically every 30 seconds, 1, 5 or 15 minutes, with the time of the last update. Ideal for a status screen on Apple TV.
- Full screen: open any panel full screen, rendered at full resolution.
- Sign-in: a Grafana username and password, or single sign-on with your OpenID Connect identity provider (for example Keycloak). On Apple TV you sign in with a code or a QR code on your phone.
- Several servers: add as many Grafana servers as you like and switch between them.
Help
Add your server
- The first time, the app opens Add server. Later: Settings › Servers › Add.
- Enter a name and your Grafana address, starting with
https://. The app connects over HTTPS only. - Choose how you sign in: Username and password or OpenID Connect (see below).
- Tap Test connection, then save. The app then lists your server's dashboards.
No server of your own? On the same screen, tap Fill in the demo server: the app fills in the address and the demo login for you, so you can try it with sample dashboards without typing anything.
Sign in with OpenID Connect
Enter your identity provider's issuer URL and the client ID your administrator gives you. On iPhone and iPad the app opens your provider's sign-in page. On Apple TV it shows a code and a QR code: scan it with your phone, sign in there, and the Apple TV continues by itself. The app keeps you signed in and renews your session silently.
Open and refresh a dashboard
- Tap or select a dashboard in the list. It opens at the top; scroll for the rest.
- Refresh with the button in the toolbar, by pulling down on iPhone and iPad, or with Play/Pause on the Apple TV remote.
- Choose an auto-refresh interval in the toolbar for the current dashboard, or a default in Settings. Auto-refresh pauses while the app is in the background.
- Tap or select a panel to see it full screen; Back (or Menu on Apple TV) returns to the dashboard.
- To open a dashboard at every start, touch and hold it in the list (or press and hold on Apple TV) and choose Set as default dashboard.
Settings
Servers and the active server, the default dashboard, the default auto-refresh interval, the panel theme (follow the system, dark or light) and, on iPhone and iPad, keeping the screen awake while auto-refresh is on. On Apple TV the screen stays awake while an auto-refreshing dashboard is shown.
For your Grafana administrator
The panels are images made by the Grafana Image Renderer, which must be installed on the server. Username and password sign-in needs Grafana's basic authentication and works for local Grafana users. OpenID Connect sign-in needs Grafana's JWT authentication, validating the access tokens of your identity provider, and a public client in that provider with PKCE and the device authorization grant enabled.
Questions and answers
- Which Grafana servers does ESO Dashboards work with?
- Any Grafana server you can reach over HTTPS, at home, at work or in the cloud, as long as the Grafana Image Renderer is installed on it. The app is a viewer: it changes nothing on your server.
- The dashboard list works but the panels stay empty. Why?
- The panels are rendered as images by the Grafana Image Renderer. If it is not installed or not reachable from Grafana, the app shows an error on each panel. Ask your Grafana administrator to install it.
- Can I sign in with single sign-on, for example Keycloak?
- Yes, with OpenID Connect. Grafana must accept the access tokens of your identity provider through its JWT authentication. Username and password sign-in works for local Grafana users only.
- How do I sign in on Apple TV without typing?
- Choose OpenID Connect: the Apple TV shows a code and a QR code. Scan it with your iPhone, sign in there, and the Apple TV continues by itself.
- Can I try the app without a Grafana server?
- Yes. When you add a server, tap Fill in the demo server: the app fills in the address and the demo login of ESO's demo server, which shows sample dashboards only.
- Can I change the time range or the variables of a dashboard?
- Not in this version: the app shows each dashboard with its own default time range and variable values, as saved in Grafana.
- Can I keep a dashboard on screen all day?
- Yes. Set auto-refresh in the dashboard's toolbar. On Apple TV the screen stays awake while it refreshes; on iPhone and iPad, switch on Keep screen awake in Settings.
- Where are my passwords stored?
- In the Keychain of your device, on that device only. They are never synced and never sent anywhere other than to your own server.
- What data does ESO Dashboards collect?
- None. The app has no advertising, no analytics and no tracking, and sends nothing to ESO. It connects only to the Grafana servers and identity providers you add.
Support
- Privacy policy: www.eso.be/eso-dashboards/privacy
- A question, a problem or an idea? Write to us and mention the app, your device and its iOS version.