/doom-datasource

Hackathon project

Primary LanguageCApache License 2.0Apache-2.0

Grafana Doom

2022 March Grafana Labs hackathon project. Runs wasm compiled Doom as a Grafana datasource, renders in a timeseries chart.

You can read more about the project here: https://grafana.com/blog/2022/03/31/can-grafana-run-doom/

Try it

Doom WASM

  1. Install dependencies

    brew install emscripten automake sdl2 sdl2_mixer sdl2_net pkg-config

    The command above is using Homebrew. Use other package managers if needed.

  2. Copy doom1.wad to ./doom-wasm/src. Ensure it is called doom1.wad

  3. Run the following commands for building Doom:

    ./doom-wasm/scripts/clean.sh
./doom-wasm/scripts/build.sh

  4. Copy the following files to ./src/img:

    • ./doom-wasm/src/doom1.wad
    • ./doom-wasm/src/websockets-doom.wasm
    • ./doom-wasm/src/websockets-doom.wasm.map

Datasource

  1. Install dependencies

    yarn install

  2. Build plugin in production mode

    yarn build

  3. Add plugin to your grafana instance by sym-linking project root to Grafana's data/plugins folder

  4. Create a Doom datasource in Grafana and note down the ID. It will be needed later.

Dashboards

  1. Navigate to ./dashboards/ and pick one of the JSON files

  2. Replace datasource-id with the datasource ID that you obtained from last step in the Datasource instructions

  3. Import the dashboard in Grafana

  4. Enjoy!