Release Metrics

API endpoints for release-related metrics

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.

Request

curl -X POST 'https://api.bilanc.co/metrics/releases-count' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "filters": {
      "repositories": [{"repository_name": "frontend-repo"}],
      "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
  }'

{
  "series": [
    {
      "name": "frontend-repo",
      "data": [3, 4, 5, 4, 6, 5]
    },
    {
      "name": "backend-repo",
      "data": [2, 2, 3, 4, 3, 4]
    },
    {
      "name": "mobile-repo",
      "data": [1, 2, 1, 2, 2, 3]
    }
  ],
  "categories": ["Jan 2023", "Feb 2023", "Mar 2023", "Apr 2023", "May 2023", "Jun 2023"],
  "meta": {
    "filters": {
      "repositories": [{"repository_name": "frontend-repo"}],
      "start_date": "2023-01-01",
      "end_date": "2023-12-31"
    },
    "date_range": {
      "start_date": "2023-01-01",
      "end_date": "2023-06-30"
    }
  }
}

Release Frequency Analysis

This endpoint provides an analysis of release frequency.

Request

curl -X POST 'https://api.bilanc.co/metrics/releases-count' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "filters": {
      "team": ["team123"],
      "start_date": "2023-01-01",
      "end_date": "2023-12-31"
    },
    "group_by": ["team_name"],
    "date_level": "quarter",
    "date_field": "created_at"
  }'

{
  "results": [
    {
      "metric_name": "releases-count",
      "value": 32,
      "group_by": {
        "team_name": "Platform Team"
      }
    },
    {
      "metric_name": "releases-count",
      "value": 45,
      "group_by": {
        "team_name": "Frontend Team"
      }
    },
    {
      "metric_name": "releases-count",
      "value": 28,
      "group_by": {
        "team_name": "Backend Team"
      }
    },
    {
      "metric_name": "releases-count",
      "value": 15,
      "group_by": {
        "team_name": "Mobile Team"
      }
    }
  ],
  "meta": {
    "filters": {
      "team": ["team123"],
      "start_date": "2023-01-01",
      "end_date": "2023-12-31"
    },
    "date_range": {
      "start_date": "2023-01-01",
      "end_date": "2023-12-31"
    }
  }
}

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

Applicable filters for release metrics:

• repositories: Array of {"repository_name": "..."} objects
• team: Filter by team IDs
• squad_ids: Filter by squad IDs
• squad_levels: Filter by squad hierarchy level
• manager_ids: Filter by manager user IDs
• departments: Filter by department names
• sources: VCS source — github, gitlab, bitbucket
• member: Filter by author merged user IDs
• locations: Filter by employee location
• levels: Filter by employee level

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