Files
grafana/devenv/frontend-service
Josh Hunt c1c5c2db8b FS: Handle unavailable backend (#108544)
* add dev mechanism for making backend unavailable

* handle unavailable backend in html

* fix ordering of /-/ routes

* Add new loader to index.html

* tweak light colours

* fix readme

* add error handling and error state

* use setTimeout for the retry loop

* easier on the comments:
2025-07-25 17:21:48 +01:00
..

frontend-service local dev

This directory contains a docker compose + Tilt setup for running a full frontend service stack locally. It contains:

  • frontend-service
  • backend api
  • static asset cdn.

Getting started

On top of the main Grafana development dependencies, you will need installed:

  • Docker
  • Tilt. At the moment we're not using Kubernetes locally, so you shouldn't need to follow the instructions to install kubectl or kind.

To start the stack, from the root of the Grafana project run make frontend-service-up. Tilt will orchestrate the webpack and docker builds, and then run the services with Docker compose. You can monitor it's progress and see logs with the URL to the Tilt console. Once done, you can access Grafana at http://localhost:3000.

Quitting the process will not stop the service from running. Run make frontend-service-down when done to shut down the docker containers.

Bootdata unavailable

To simulate the /bootdata endpoint being available, there are special control URLs you can visit that use cookies to control behaviour:

  • /-/down - Simulates the endpoint being unavailable for 60 seconds.
  • /-/down/:seconds - Simulates the endpoint being unavailable for a custom number of seconds.
  • /-/up - Restores the endpoint to being available.

When unavailable, the API will return HTTP 503 Service Unavailable with a JSON payload.