oncall-engine/README.md

Developer-friendly, incident response management with brilliant Slack integration.

• Collect and analyze alerts from multiple monitoring systems
• On-call rotations based on schedules
• Automatic escalations
• Phone calls, SMS, Slack, Telegram notifications

Getting Started

Production environment

For production setup check PRODUCTION.md.

Hobby environment

Download docker-compose.yaml:

curl https://github.com/... -o docker-compose.yaml

Set environment:

export DOMAIN=http://localhost
export SECRET_KEY=my_random_secret_must_be_more_than_32_characters_long
export RABBITMQ_PASSWORD=rabbitmq_secret_pw
export MYSQL_PASSWORD=mysql_secret_pw
export COMPOSE_PROFILES=with_grafana
export GRAFANA_USER=admin
export GRAFANA_PASSWORD=admin

Launch services:

docker-compose -f docker-compose.yml up --build -d

Issue invite token and get further instructions:

docker-compose -f docker-compose.yml run engine python manage.py issue_invite_for_the_frontend --override

Further Reading

• Documentation - Grafana OnCall
• Blog Post - Announcing Grafana OnCall, the easiest way to do on-call management
• Presentation - Deep dive into the Grafana, Prometheus, and Alertmanager stack for alerting and on-call management