01 · Contexto
Qué está ocurriendo
Las consultas de ejecuciones de GitHub Actions pueden filtrarse por workflow, evento, estado, rama o actor. En conjuntos muy grandes, calcular el total exacto producía timeouts y en ocasiones devolvía números que parecían precisos sin serlo.
Desde el 25 de septiembre, la API y la interfaz indican 2.500+ cuando hay más de 2.500 coincidencias. La paginación sigue permitiendo recuperar hasta 1.000 elementos por consulta; quien necesite más debe acotar filtros, por ejemplo con ventanas de fecha.
El cambio mejora honestidad semántica: una cota deja de presentarse como medición exacta. Pero rompe supuestos en scripts que almacenaban total_count como un número completo para capacidad, cumplimiento, chargeback o respuesta a incidentes.
Particionar también requiere cuidado. Ventanas solapadas pueden duplicar runs y ventanas mal cerradas pueden omitirlos; la identidad del workflow run y límites de tiempo consistentes deben formar parte del recolector.
02 · Impacto
Por qué importa
Dashboards, exportaciones y controles que dependen del conteo agregado pueden subestimar volumen o interpretar el sufijo como error. En una investigación o auditoría, una cifra incompleta puede distorsionar el universo revisado. La corrección es diseñar extracción paginada y particionada, conservar identificadores únicos y demostrar cobertura del intervalo consultado.
03 · Recomendaciones
Qué conviene hacer
- Buscar integraciones que consuman total_count o el conteo mostrado por Actions; marcar 2.500+ como cota inferior y evitar usarlo en cálculos que exijan exactitud.
- Particionar por rangos de fecha suficientemente pequeños, paginar hasta completar cada rango y deduplicar por workflow run ID; usar límites inclusivos y exclusivos documentados.
- Probar dashboards, alertas, exportaciones y procesos de auditoría con más de 2.500 coincidencias y con el límite de 1.000 elementos recuperables por consulta.
- Conservar consulta, filtros, ventanas, número de páginas y cantidad de IDs únicos como evidencia; alertar si un rango vuelve a alcanzar la cota y necesita subdivisión adicional.