GitHub Actions begrenzt die Zählung großer Workflow-Run-Abfragen auf 2.500+

GitHub ändert die Darstellung umfangreicher Abfrageergebnisse für Workflow-Runs in GitHub Actions. Bei Suchen, die nach Workflow, Ereignis, Status, Branch oder Akteur gefiltert sind, erscheint für Ergebnismengen mit mehr als 2.500 Einträgen künftig die Angabe 2.500+ statt einer vermeintlich exakten Zahl. GitHub kündigte die Änderung am 25. September 2026 an. Die Einführung auf github.com und in GitHub Enterprise Cloud war zu diesem Zeitpunkt bereits im Gange.

Warum exakte Zählungen entfallen

GitHub zufolge kommt es bei Abfragen, die mehr als 2.500 Workflow-Runs umfassen, häufig zu Zeitüberschreitungen. Die bislang zurückgegebene Zahl konnte deshalb lediglich die Datensätze berücksichtigen, die vor dem Abbruch gefunden worden waren, und damit unter dem tatsächlichen Gesamtwert liegen. Die neue Untergrenze ist zwar weniger präzise, soll den Umfang aber zutreffender wiedergeben und zugleich die Leistung der Abfragen verbessern.

Paginierung bleibt begrenzt

Die Anpassung betrifft nur die ausgewiesene Anzahl, nicht die bestehende Obergrenze der Paginierung. GitHub liefert weiterhin auf mehrere Seiten verteilte Ergebnisse mit insgesamt höchstens 1.000 Workflow-Runs zurück. Die Kennzeichnung 2.500+ bedeutet daher nicht, dass sich sämtliche passenden Einträge über dieselbe breit gefasste Anfrage abrufen lassen. Sie zeigt lediglich an, dass die Ergebnismenge den festgelegten Schwellenwert überschreitet.

Integrationen benötigen möglicherweise engere Filter

Skripte und Integrationen, die mit einer einzelnen Abfrage mehr als 2.500 passende Workflow-Runs erfassen müssen, sollten ihre Anfragen in kleinere Bereiche aufteilen. GitHub empfiehlt ausdrücklich, die Filter weiter einzugrenzen, beispielsweise durch zusätzliche Datumsbereiche. Auf diese Weise kann jede Abfrage gezielter auf die benötigten Runs beschränkt werden.

Wie stark sich die Änderung auswirkt, hängt von der Verarbeitung der API-Antwort ab. Dashboards, die lediglich auf einen großen Rückstand hinweisen sollen, können die Untergrenze möglicherweise direkt anzeigen. Berichtssysteme, Archivierungsaufträge oder Prüfungen, die eine exakte und vollständige Erfassung verlangen, müssen ihre Suche dagegen aufteilen und mögliche Überschneidungen zwischen den enger gefassten Ergebnismengen berücksichtigen.

Eine klarere Grenze für unvollständige Ergebnisse

Mit der Änderung ersetzt GitHub einen potenziell irreführenden, exakt wirkenden Wert durch einen eindeutig definierten Zustand oberhalb des Grenzwerts. Zugleich werden zwei Aspekte der API klarer voneinander getrennt: Die Zählung signalisiert, dass mehr als 2.500 Datensätze übereinstimmen, während die Paginierung weiterhin bestimmt, wie viele Workflow-Runs tatsächlich zurückgegeben werden können. Anwendungen sollten diese beiden Beschränkungen bei der Verarbeitung umfangreicher GitHub-Actions-Verläufe unabhängig voneinander behandeln.

KI-generierte redaktionelle Illustration; kein Dokumentarfoto.

Quelle: Changes to query results in the GitHub Actions API and UI