Saltar al contenido principal

DEVOPS_METRICS_AND_STATISTICS_API

API_SEC_LOG: PIPELINES_MONITOR_ACTIVE

El canal de reportes y estadísticas recopila y consolida métricas detalladas de Azure DevOps sobre el estado de compilaciones, tasa de fallos de ramas y consumo de almacenamiento mensual del Workspace.

01_OVERVIEW_STATISTICS​

El Frontend consume estos endpoints principales para compilar los micro-gráficos del tablero principal:

A. Resumen General del Proyecto (Overview)​

  • Endpoint: POST /admin/reports/getProject
  • Payload Requerido:
{
  "workspaceId": 1,
  "startDate": "2026-06-01T00:00:00.000Z",
  "endDate": "2026-06-19T23:59:59.000Z"
}
  • Descripción: Retorna el volumen acumulado de ejecuciones exitosas, fallidas y duración promedio en la ventana de tiempo especificada.

B. Resumen de Ramas y Git (Branches)​

  • Endpoint: POST /admin/reports/getProjectBranch
  • Descripción: Retorna métricas segmentadas exclusivas por rama (ej. main, develop) para identificar derivaciones inestables.

02_GLOBAL_METRICS_AND_LEADERBOARDS​

Endpoints agregativos de alto nivel para reportes unificados de la organización:

A. Reportes Consolidados (Global)​

  • Endpoint: POST /admin/reports/globalReports
  • Descripción: Recopila datos de tiempos ahorrados, tasa de éxito acumulada por equipo y resúmenes para compilar los gráficos globales de costos.

B. Líder de Tareas Fallidas (Failed Tasks Leaderboard)​

  • Endpoint: GET /admin/reports/getFDSStats
  • Descripción: Entrega el listado denso de tareas que más fallas acumulan, ordenadas de forma decreciente, incluyendo repositorio, rama, porcentaje de participación y LED de criticidad.

03_BILLING_AND_GB_STORAGE_CONSUMPTION​

El sistema monitorea dinámicamente el almacenamiento de base de datos consumido por registros de logs de pipelines para calcular los costos mensuales.

Endpoint: GET /admin/reports/getBillingGBStorage

  • Petición Autenticada: Requiere token JWT en cabeceras.
  • Respuesta JSON:
{
  "workspaceId": 1,
  "monthlyGbConsumed": 42.85,
  "storageLimitGb": 100,
  "additionalCostUsd": 12.50,
  "period": "2026-06"
}

04_API_LEVEL_TELEMETRY_AND_CONSUMPTION​

API_SEC_LOG: GATEWAY_MONITOR

Para garantizar la estabilidad de las integraciones externas, el dashboard corporativo consume telemetría avanzada de consumo y rendimiento de la propia API de DevOps Monitor.

A. Latencia y Rendimiento de Gateway​

  • Endpoint: POST /admin/reports/getApiLatencyStats
  • Payload de Consulta:
{
  "workspaceId": 1,
  "period": "2026-06"
}
  • Respuesta JSON:
{
  "workspaceId": 1,
  "avgLatencyMs": 142.5,
  "successRate": 99.94,
  "requestsPerSecond": 14.8,
  "breakdown": {
    "status2xx": 24800,
    "status4xx": 12,
    "status5xx": 2
  }
}

B. Consumo Acumulado de API Keys​

  • Endpoint: GET /admin/reports/getApiKeyMonthlyUsage
  • Descripción: Retorna la cuota consolidada consumida por todos los tokens de integración creados en el Workspace para alertar sobre límites de solicitudes mensuales.

05_ANALYTICS_ALERTS​

  • Sincronización: Los reportes de Azure DevOps se actualizan cada 60 segundos por defecto.
  • Rango de Fechas: Las consultas masivas con rangos mayores a 12 meses pueden experimentar retrasos en el procesamiento de datos. Se sugiere aplicar filtros semanales o mensuales.