Skip to content

A Kotlin project that adds sound to a set of monitored Prometheus metrics

License

Notifications You must be signed in to change notification settings

alkoclick/metrics-audio

Repository files navigation

Prometheus metrics-audio

A Kotlin project that adds sound to a set of monitored Prometheus metrics.

Quickstart

docker-compose -f docker/docker-compose.yaml up
./gradlew run

Q: Why do I hear nothing?

A: You may need to turn up the sound

Q: What am I listening to?

A: CPU usage percentage on your left ear, memory usage percentage on your right ear and a metronome with the disk space usage

Summary

Audio

There are 2 possible audio types currently: Metro and Synth.

  • Metro is short for metronome, it is a periodic sound similar to a heart rate monitor in hospital
  • Synth is short for synthesizer, it is a constant sound with some pink noise mixed in. It plays on alternating channels, so you will probably hear it on only one side of your audio output.

Config

You can find the full config definitions and defaults in the Config file.

A config file is roughly the equivalent of a Grafana dashboard, it's a collection of Prometheus metrics that are being output as sound.

Future goals / Areas for improvement

  • Scrape multiple times within a run and support a scrape_interval config
  • Consider switching to a server/client arch and playing sound via Javascript in the browser
  • Study hearing theory and add explicit failsafes to protect people's hearing at all times
  • Allow loading multiple configs and switching between them dynamically

This project is licensed under the MIT License.

About

A Kotlin project that adds sound to a set of monitored Prometheus metrics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages