webdevops/azure-devops-exporter

Azure DevOps Exporter (VSTS)

镜像概述

Azure DevOps Exporter是一个Prometheus exporter，用于从Azure DevOps (VSTS)收集指标，包括项目、构建、构建时间（耗时和队列等待时间）、代理池利用率及活动拉取请求等数据，帮助监控Azure DevOps环境的性能和活动状态。

核心功能与特性

• 多类型指标收集：支持项目、构建、发布、部署、代理池、拉取请求、资源使用等多种指标
• 可配置的抓取时间：为不同类型的指标设置独立的抓取频率，平衡监控精度与资源消耗
• 灵活的项目与代理池过滤：支持通过白名单/黑名单筛选需要监控的项目和代理池
• 资源使用限制：可配置并发请求数、重试次数及数据查询范围（如构建/发布历史时间范围）
• 详细的状态监控：包括构建状态、发布环境状态、代理状态、拉取请求状态等

使用场景与适用范围

• DevOps团队监控CI/CD流水线性能（构建耗时、队列等待时间、成功率）
• SRE团队监控代理池资源利用率（代理数量、队列长度、活跃任务）
• 项目管理者跟踪项目活动（活跃拉取请求、代码仓库统计、发布频率）
• 需要将Azure DevOps数据集成到Prometheus+Grafana监控系统的场景

配置说明

命令行选项与环境变量

指标说明

使用示例

Docker Run 命令

bash
docker run -d \
  --name azure-devops-exporter \
  -p 8080:8080 \
  -e AZURE_DEVOPS_ACCESS_TOKEN="your-access-token" \
  -e AZURE_DEVOPS_ORGANISATION="your-organisation" \
  -e SCRAPE_TIME_LIVE="30s" \
  -e LIMIT_BUILD_HISTORY_DURATION="72h" \
  webdevops/azure-devops-exporter

Docker Compose 配置

yaml
version: '3'
services:
  azure-devops-exporter:
    image: webdevops/azure-devops-exporter
    ports:
      - "8080:8080"
    environment:
      - AZURE_DEVOPS_ACCESS_TOKEN=your-access-token
      - AZURE_DEVOPS_ORGANISATION=your-organisation
      - SCRAPE_TIME=30m
      - SCRAPE_TIME_LIVE=30s
      - LIMIT_BUILD_HISTORY_DURATION=72h
      - WHITELIST_PROJECT=project-uuid-1,project-uuid-2
    restart: always

Prometheus查询示例

单个项目每个定义的最近3次失败发布

promql
topk by(projectID,releaseDefinitionName,path) (3,
  azure_devops_release_environment{projectID="XXXXXXXXXXXXXXXX", status!="succeeded", status!="inProgress"}
  * on (projectID,releaseID,environmentID) group_left() (azure_devops_release_environment_status{type="created"})
  * on (projectID,releaseID) group_left(releaseName, releaseDefinitionID) (azure_devops_release_info)
  * on (projectID,releaseDefinitionID) group_left(path, releaseDefinitionName) (azure_devops_release_definition_info)
)

代理池使用率（排除PoolMaintenance任务）

promql
count by(agentPoolID) (
  azure_devops_agentpool_agent_job{planType!="PoolMaintenance"}
  * on(agentPoolAgentID) group_left(agentPoolID) (azure_devops_agentpool_agent_info)
)
/ on (agentPoolID) group_left() (azure_devops_agentpool_size)
* on (agentPoolID) group_left(agentPoolName) (azure_devops_agentpool_info)

当前运行的任务

promql
label_replace(
    azure_devops_agentpool_agent_job{planType!="PoolMaintenance"}
    * on (agentPoolAgentID) group_left(agentPoolID,agentPoolAgentName) azure_devops_agentpool_agent_info
    * on (agentPoolID) group_left(agentPoolName) (azure_devops_agentpool_info)
  , "projectID", "$1", "scopeID", "^(.+)$"
)
* on (projectID) group_left(projectName) (azure_devops_project_info)

代理池规模

promql
azure_devops_agentpool_info
* on (agentPoolID) group_left() (azure_devops_agentpool_size)

代理池规模（启用且在线的代理）

promql
azure_devops_agentpool_info
* on (agentPoolID) group_left() (
  count by(agentPoolID) (azure_devops_agentpool_agent_info{status="online",enabled="true"})
)