本文へスキップ

アラートルール ​

アラートルールは、自分で決めたしきい値を超えたときに通知します。サーバーやサービスが高負荷のまま続くときや、ログに同じエラーが出続けるときです。すべてのプランにある組み込みの通知に追加して使います。アラートルールは Pro 以上のプランに含まれます(Pro は 20 件、Team は 100 件まで)。

ルールを追加する ​

チームのオーナーと管理者は アカウント設定 → アラートルール(サイドバーで選んでいるチームが対象)を開き、ルールを追加 をクリックして、監視する対象を選びます。

監視対象しきい値発火する条件
サーバー CPU全コア合計の割合(%)直近 N 分間のすべてのサンプルがしきい値以上
サーバーメモリ使用率(%)同上
サーバーディスク使用率(%)同上
サービス CPUvCPU、全インスタンスの合計(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 が返ります。