​
Development Metrics

Development metrics focus on the time spent in different phases of the development process, helping teams understand and optimize their development workflow.

​
Available Metrics

​
coding-time
string
Time spent coding
​
pickup-time
string
Time between commit and PR open
​
commit-to-open
string
Time from commit to PR open
​
reviews-count
string
Number of reviews
​
open-to-review
string
Time between PR open and first review
​
review-to-merge
string
Time between first review and merge
​
review-time
string
Total time spent in review
​
rework-time
string
Time spent on rework after review
​
cycle-time
string
Full cycle time from commit to merge

​
Cycle Time Metric

This example demonstrates how to retrieve the cycle time metric, which measures the full development cycle from initial commit to merge. 
curl -X POST 'https://api.bilanc.co/metrics/v2/cycle-time' \
  -H 'Authorization: Bearer YOUR_AUTH_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "filters": {
      "repositories": ["repo-name-1", "repo-name-2"],
      "start_date": "2023-01-01",
      "end_date": "2023-02-28"
    },
    "group_by": ["repository_name", "name"],
    "date_level": "month",
    "aggregation": "avg",
    "date_field": "merged_at",
  }'

​
Review Time Metric

This example demonstrates how to retrieve the review time metric, which measures the total time spent in the review phase. 
curl -X POST 'https://api.bilanc.co/metrics/v2/review-time' \
  -H 'Authorization: Bearer YOUR_AUTH_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "filters": {
      "team_ids": ["team123"],
      "start_date": "2023-01-01",
      "end_date": "2023-02-28"
    },
    "group_by": ["team_name"],
    "date_level": "month",
    "aggregation": "avg"
  }'

​
Parameter Notes

​
date_field
string
For development metrics, the following date fields are available:
  • created_at: For metrics related to the pull request creation time
  • merged_at: For metrics related to the pull request merge time (best for cycle time)
  • first_review_at: For metrics related to pull request first review time
​
aggregation
string
Metrics that are not count based can be aggregated using the following method:
  • sum, max, min, avg

​
Common Use Cases

  • Track Cycle Time Trends: Monitor how development cycle time changes over time
  • Identify Bottlenecks: Find which part of the development process takes the longest
  • Compare Team Performance: Compare cycle times across different teams or repositories
  • Set Performance Goals: Establish baseline metrics and set improvement goals