DrDroidLab / PlayBooks

Runbook automation platform with deep observability integrations & Jupyter-notebooks style interface

Home Page:https://docs.drdroid.io/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Doctor Droid Logo

Docs | Sandbox | Community


tl;dr Enrich your Slack alerts with contextual observability data, helping on-call engineer investigate faster.

About PlayBooks

PlayBooks are executable notebooks designed to Automate Preliminary Investigations in Production for engineers. Watch demo video.

Automating Playbook Executions

  1. Define a playbook with your enrichment logic
  2. Configure the playbook to auto-trigger basis a Slack alert received in a channel
  3. Receive automated investigation summary in the Slack thread for the same alert

Playground:

  • Explore the sandbox to get a sense of how the playbooks work.
  • You can also check out the #demo-alerts channel in community Slack workspace to see how automated replies are received for alerts.

Capabilities

  • Enrichment library: The tool currently supports fetching 50+ types of enrichment data from metric sources (Datadog, New Relic, Grafana+Prometheus, Cloudwatch Metrics), Logs & Events (Cloudwatch Logs, EKS) and Databases (PostgreSQL DB, Clickhouse DB)

  • Past Executions: See the historical runs of a playbook and go back to an investigation from a specific point in time.

  • Continuous monitoring: Setup continuous monitoring cron for specific use-cases (e.g. post deployment, peak hours, post bug-fix). Read docs for list of allowed configurations.

Coming Soon:

  • Interpretation Layer: Configure ML modules which can analyse & interpret data from your investigation playbooks.
  • Templates: Common investigation & troubleshooting logics which can be used out of the box.
  • Conditionals: Create decision trees in your playbooks basis evaluation of a playbook step.
  • More integrations: Find something missing? Request here.

Getting Started with alert enrichment

Self-hosting:

Step 1: We currently support setup using docker. Run the below command and signup on localhost to start creating playbooks.

Use latest docker images

docker-compose -f deploy.docker-compose.yaml up -d

or Build from source

git clone git@github.com:DrDroidLab/PlayBooks.git
docker-compose -f playbooks.docker-compose.yaml up -d

Step 2: Follow this Step-by-Step guide to do your first alert enrichment.

Have feedback or queries?

Asks questions in the Slack Community or write to us at founders [at] drdroid [dot] io

Want to contribute?

Read our contribution guidelines

About

Runbook automation platform with deep observability integrations & Jupyter-notebooks style interface

https://docs.drdroid.io/

License:MIT License


Languages

Language:Python 62.2%Language:JavaScript 21.9%Language:TypeScript 10.3%Language:CSS 4.5%Language:HTML 0.8%Language:Shell 0.2%Language:Dockerfile 0.1%