​
Release Metrics

Release metrics provide insights into the frequency, quality, and stability of your software releases.

​
Available Metrics

​
releases-count
string
Number of releases

​
Releases Count Metric

This endpoint provides data on the number of releases over time. 
curl -X POST 'https://api.bilanc.co/metrics/v2/releases-count' \
  -H 'Authorization: Bearer YOUR_AUTH_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "filters": {
      "repository_id": "123456",
      "start_date": "2023-01-01",
      "end_date": "2023-12-31"
    },
    "group_by": ["repository_name"],
    "date_level": "month",
    "date_field": "created_at",
    "time_series_data": true
  }'

​
Release Frequency Analysis

This endpoint provides an analysis of release frequency. 
curl -X POST 'https://api.bilanc.co/metrics/v2/releases-count' \
  -H 'Authorization: Bearer YOUR_AUTH_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "filters": {
      "team_id": "team123",
      "start_date": "2023-01-01",
      "end_date": "2023-12-31"
    },
    "group_by": ["team_name"],
    "date_level": "quarter",
    "aggregation": "sum",
    "date_field": "created_at"
  }'

​
Parameter Notes

​
date_field
string
For release metrics, the following date fields are available:
  • created_at: When the release was created
  • published_at: When the release was published or deployed
​
filters
object
Release-specific filters:
  • release_type: Filter by release type (e.g., major, minor, patch)
  • environment: Filter by deployment environment (e.g., production, staging)
  • status: Filter by release status (e.g., successful, failed, rolled back)

​
Common Use Cases

  • Release Frequency Tracking: Monitor how often teams are releasing software
  • Release Cadence Analysis: Analyze patterns in release timing and frequency
  • Team Comparison: Compare release metrics across different teams or repositories
  • Goal Setting: Set and monitor goals for deployment frequency
  • Continuous Delivery Maturity: Track improvements in deployment frequency as a measure of CD maturity