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

We prepared multiple environments: production, developer and hobby:

1. Download docker-compose.yaml:

curl https://github.com/grafana/oncall/blob/dev/docker-compose.yml -o docker-compose.yaml 

2. Set variables:

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

3. Launch services:

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

4. Issue one-time invite token:

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

5. Go to http://localhost:3000/plugins/grafana-oncall-app and connect OnCall plugin with OnCall backend:

Invite token: ^^^ from the previous step.
OnCall backend URL: http://engine:8080
Grafana Url: http://grafana:3000

6. Enjoy!

Join community

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