# dora-team/fourkeys

Platform for monitoring the four key software delivery metrics of software delivery

Repository: https://github.com/dora-team/fourkeys
Canonical: https://ross.abutalabs.com/products/fourkeys
Language: Python
License: Apache-2.0
License Family: permissive
Topics: metrics, monitoring
Archived: true
Last push: 2024-01-23T16:12:12+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 2247, "days_push": 953, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: archived
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2236, forks 612 (observed 2026-08-28T04:06:29.426993+00:00)

## What it is
Four Keys is a self-hostable platform from Google's DORA team that collects events from development environments like GitHub and GitLab via webhooks and computes the four key software delivery metrics: deployment frequency, lead time for changes, time to restore services, and change failure rate. It runs on Google Cloud (Cloud Run, Pub/Sub, BigQuery) and renders the metrics in a dashboard.

## Use cases
- measure my team's software delivery performance
- track DORA four key metrics for GitHub or GitLab projects
- monitor deployment frequency and lead time for changes
- baseline our devops performance before and after new tooling
- visualize change failure rate and time to restore service
- collect webhook events from GitHub into a metrics dashboard

## When to choose
- you want to measure DORA's four key software delivery metrics
- your project lives in GitHub or GitLab and has deployments
- you are already on Google Cloud and can use Cloud Run, Pub/Sub, and BigQuery
- you want a forkable reference implementation for building your own metrics instrumentation

## When to avoid
- the repository is no longer maintained, so you need active support or updates
- your project ships libraries with releases but no deployments
- you are not using Google Cloud and cannot easily adapt the Cloud Run/Pub/Sub/BigQuery architecture
- you need a turnkey hosted metrics product rather than a reference platform

## Facets
- artifact type: application
- maturity: abandoned
- function: monitoring, analytics, webhook, data-visualization, etl
- domain: analytics, monitoring, developer-tools
- platform: cloud, python
- tags: dora-metrics, devops-metrics, bigquery, cloud-run, pubsub, software-delivery-performance, unmaintained, devops, docker

## Member repositories
- dora-team/fourkeys (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:29.426993+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:44:17.102938+00:00, confidence not recorded.
  - readme: https://github.com/dora-team/fourkeys (fetched 2026-08-28T04:06:29.426993+00:00, sha d052e0c63f8d)
- Data as of 2026-08-30T08:39:29.467469+00:00.