# ADO Exporter

ADO Exporter is a self-hosted databases app. Prometheus exporter for Azure DevOps work items, pull requests, and branches, with optional GitHub repository activity. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2555/ado-exporter

## Description

Prometheus exporter for Azure DevOps work items, pull requests, and branches, with optional GitHub repository activity. Polls each API read-only and exposes metrics in Prometheus text format, giving homelab Grafana dashboards a cross-project view that a single ADO board cannot provide.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

44/100 (Fair), based on 3 of 4 factors.
- Maintained: 75 (last commit 16 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- GitHub: https://github.com/louij2/ado-exporter
- Docker Hub: https://hub.docker.com/r/louij2/ado-exporter
- Unraid: https://ca.unraid.net/apps/ado-exporter-0jwkbzt0g4aibx?q=ado-exporter

## Common questions

### How can I tell whether the exporter is still polling successfully?

Check ado_exporter_last_run_timestamp. It is the unix time of the last successful poll.

### What permission should I check if ADO pull request metrics are missing?

Look at ado_exporter_pr_read_ok. If it is 0, the PAT lacks Code:Read.

### How does the exporter handle a branch comparison that fails?

A branch with ahead=-1 and status=unknown means the comparison failed. That branch is deliberately never counted as merged.

### How do I diagnose why GitHub metrics are unavailable?

Check github_read_problem when github_read_ok is 0. The reason can be no_token, api_error, or cannot_read_refs.

---
Source: Our Local Host (https://ourlocalhost.com/app/2555/ado-exporter), the self-hosted and open-source app directory.
