アラートルール
アラートルールは、自分で決めたしきい値を超えたときに通知します。サーバーやサービスが高負荷のまま続くときや、ログに同じエラーが出続けるときです。すべてのプランにある組み込みの通知に追加して使います。アラートルールは Pro 以上のプランに含まれます(Pro は 20 件、Team は 100 件まで)。
ルールを追加する
チームのオーナーと管理者は アカウント設定 → アラートルール(サイドバーで選んでいるチームが対象)を開き、ルールを追加 をクリックして、監視する対象を選びます。
| 監視対象 | しきい値 | 発火する条件 |
|---|---|---|
| サーバー CPU | 全コア合計の割合(%) | 直近 N 分間のすべてのサンプルがしきい値以上 |
| サーバーメモリ | 使用率(%) | 同上 |
| サーバーディスク | 使用率(%) | 同上 |
| サービス CPU | vCPU、全インスタンスの合計(1 vCPU = 1 コア) | 同上 |
| サービスメモリ | MiB、全インスタンスの合計 | 同上 |
| ログ行 | 行数 | 直近 N 分間に、その文字列を含む行が指定した数以上出力された |
N は 1〜60 分です。メトリクスはおよそ 1 分ごとに取得されるため、ルールが発火するにはサンプルが期間全体をカバーしている必要があります。しばらく静かだった後の高い値 1 つだけでは発火しません。サーバーが報告を止めている間(オフラインのときなど)はルールの状態は変わりません。その場合は組み込みの サーバーオフライン 通知が届きます。
ログ行 のルールは、プロジェクトの 1 つのサービス、またはすべてのサービスを監視します。照合は変数の値を伏せた後に行い、行のどこに含まれていても一致とし、大文字と小文字は区別しません。行は出力されたときに数えるだけで、ルールのために保存されることも、アラートに含まれることもありません。
ルールは 1 分ごとにチェックされます。一覧には各ルールの直近の値が表示され、条件を満たしている間は 発火中 と表示されます。ルールを変更すると判定は最初からやり直しになります。ルールの追加・変更・削除は監査ログに記録されます。
アラート
ルールが発火すると、チームに アラートルールの発火 が送られます。この通知をオンにしているメンバーへのメール(他の通知と同じく、オーナーと管理者は最初からオン)と、これを購読しているチームのチャンネルへの投稿です。条件を満たさなくなると 回復 のメッセージが続きます。
各ルールのアラートは 1 時間に最大 1 回です。1 時間以内に再び発火した場合、コンソールには 発火中 と表示されますが、通知は送られず、回復の通知も送られません。
アラートには、ルール名、監視対象、条件、観測した値(例: 期間中の最低 86%、一致した行 14 行)が書かれます。ログの内容、変数の値、シークレットは決して含まれません。
プラン
アラートルールを含まないプランでは、どのプランに含まれるかがページに表示されます。そのようなプランに変更したチームのルールは残ります。チェックは止まり、編集・オフ・削除はできますが、オンにしたり追加したりはできません。Pro か Team に戻ると、自動的にチェックが再開されます。
API
| メソッド | パス | |
|---|---|---|
GET POST | /api/teams/{tid}/alert-rules | ルールの一覧、または追加: {kind, name, threshold, window_minutes}。server_cpu・server_memory・server_disk は server_id、service_cpu(ミリコア)と service_memory(MiB)は project_id と service、log_match は project_id と pattern(service は任意) |
PATCH DELETE | /api/teams/{tid}/alert-rules/{rid} | kind 以外のフィールドや enabled の変更、削除 |
アラートルールを含まないプランでルールを作成・オンにすると、402 と plan_required が返ります。