GitHub Actions、検索件数の表示を変更。大量の実行履歴は日付で分けて取得へ
GitHubは9月25日、ActionsのAPIと画面で実行履歴を検索した際、該当件数が2,500を超えると正確な件数ではなく『2,500+』と報告する変更を発表しました。大量検索のタイムアウトで不完全な数字を返す問題への対応です。履歴を監視・集計しているチームは、一度の検索結果を全件とみなさず、日付などで範囲を区切る必要があります。
大量検索のタイムアウト対策
対象はワークフロー、イベント、状態、ブランチ、実行者で絞り込む検索です。これまでは大量の履歴を数える途中で処理が時間切れになり、その時点で見つかった件数が返ることがありました。今回の変更は、精密そうに見える不完全な数字より、上限を超えたことを明示する方針です。
報告件数と取得上限を混同しない
『2,500+』は件数の報告方法であり、一覧を取得できる上限とは別です。ページを分けて返される検索結果は引き続き最大1,000件と説明されています。2,500件まで全データを一度に取得できるようになった、と読み違えないことが重要です。
日付を区切り、実行IDで抜けを確認
監視や監査用スクリプトは、取得した件数と表示上の件数を混同していないか確認したいところです。期間を細分化して取り出し、境界日時で重複や抜けが生じないよう実行IDで照合する運用が考えられます。件数が少なく見える場合も、すぐに実行失敗の減少とは判断できません。 変更はgithub.comとGitHub Enterprise Cloudへ順次展開されます。自前の集計や連携の動作確認が必要で、今回の変更によって実行履歴そのものが削除されるという発表ではありません。