スタンドアップ前に完了する自動エラートリアージ

Sentry 連携: Zero が読み取るエラー

必須

Zero は Sentry のエラートラッキングを Issues API 経由で読み取り、指定した環境の未解決エラーを発生頻度順で問い合わせます。各エラーについて、タイトルと culprit、イベント数と影響ユーザー数、レベル、初回・最終発生時刻を読み取り、さらに最新イベントを取得して完全なスタックトレースとリリース・環境タグを確認します。トリアージの判断に必要な情報、つまり何が壊れ、どれくらいの頻度で、どこで、いつから起きているかが、これで揃います。このワークフローでの Sentry 連携は読み取り専用です。Zero が Sentry の Issue を解決済みにしたり、マージしたり、担当者を変更したりすることはなく、記録は代わりに GitHub に書き込まれます。

GitHub 連携: Zero が作成する Issue

必須

しきい値を超えたエラーは、指定したリポジトリの GitHub Issue になります。Issue にはエラータイトル、スタックトレース、発生回数と影響ユーザー数、初回・最終発生時刻、そして元データにすぐ戻れるよう Sentry Issue へのリンクが含まれます。Zero は指定されたラベルを付け、スタックトレースに現れたファイルのコードオーナーをアサインします。書き込み権限は許可したリポジトリに限定され、Zero が行うのは Issue の作成だけです。コミットもプルリクエストもリポジトリ設定の変更も行いません。

Axiom 連携: Zero が突き合わせる Axiom ログ

オプション

Axiom は任意ですが、重複排除で効いてきます。ログ管理をすでに Axiom で行っているなら、Zero は同じパスでそれを読み取ります。選択したデータセットに対し、Sentry の取得と同じ時間範囲に絞って APL クエリを実行し、その Axiom ログを既に得ているエラーシグネチャと突き合わせます。これにより、ひとつの障害が異なる形式で二重に現れるケースを捕捉でき、Sentry のイベント単体では得られないリクエスト単位の文脈も補えます。Axiom がなくてもワークフローは最後まで動作し、その場合の重複排除は Sentry のデータのみに基づきます。

手作業トリアージ

エンジニアがSentryとAxiomをレビューし、重複を特定し、重要度を判断し、issueを開き、担当者を見つけます。柔軟ですが、毎朝同じ20〜30分の作業を繰り返します。

Sentryアラートルール

ルールは閾値を超えたときにチームへ通知します。検出には役立ちますが、チームは依然としてログを突き合わせ、エラーを重複排除し、GitHub Issueを作成し、担当者をアサインしなければなりません。

ZeroのSentryワークフロー自動化

ZeroはSentryの自動化を端から端まで実行します：クエリ、ソースをまたいだ重複排除、閾値の適用、issue作成、スタックトレースの添付、コードオーナーのアサイン。オンデマンド実行とデプロイ後実行は同じワークフローを使います。