---
url: https://docs.zenavo.app/ja-JP/operations/alert-rules
---

# アラートルール

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

## ルールを追加する {#add-a-rule}

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

| 監視対象 | しきい値 | 発火する条件 |
| --- | --- | --- |
| **サーバー CPU** | 全コア合計の割合（%） | 直近 *N* 分間のすべてのサンプルがしきい値以上 |
| **サーバーメモリ** | 使用率（%） | 同上 |
| **サーバーディスク** | 使用率（%） | 同上 |
| **サービス CPU** | vCPU、全インスタンスの合計（1 vCPU = 1 コア） | 同上 |
| **サービスメモリ** | MiB、全インスタンスの合計 | 同上 |
| **ログ行** | 行数 | 直近 *N* 分間に、その文字列を含む行が指定した数以上出力された |

*N* は 1〜60 分です。メトリクスはおよそ 1 分ごとに取得されるため、ルールが発火するにはサンプルが期間全体をカバーしている必要があります。しばらく静かだった後の高い値 1 つだけでは発火しません。サーバーが報告を止めている間（オフラインのときなど）はルールの状態は変わりません。その場合は組み込みの **サーバーオフライン** 通知が届きます。

**ログ行** のルールは、プロジェクトの 1 つのサービス、またはすべてのサービスを監視します。照合は変数の値を伏せた後に行い、行のどこに含まれていても一致とし、大文字と小文字は区別しません。行は出力されたときに数えるだけで、ルールのために保存されることも、アラートに含まれることもありません。

ルールは 1 分ごとにチェックされます。一覧には各ルールの直近の値が表示され、条件を満たしている間は **発火中** と表示されます。ルールを変更すると判定は最初からやり直しになります。ルールの追加・変更・削除は[監査ログ](https://docs.zenavo.app/ja-JP/account/audit-log)に記録されます。

## アラート {#alerts}

ルールが発火すると、チームに **アラートルールの発火** が送られます。この通知をオンにしているメンバーへのメール（他の[通知](https://docs.zenavo.app/ja-JP/operations/notifications#who-gets-them)と同じく、オーナーと管理者は最初からオン）と、これを購読しているチームの[チャンネル](https://docs.zenavo.app/ja-JP/operations/notifications#channels)への投稿です。条件を満たさなくなると **回復** のメッセージが続きます。

各ルールのアラートは 1 時間に最大 1 回です。1 時間以内に再び発火した場合、コンソールには **発火中** と表示されますが、通知は送られず、回復の通知も送られません。

アラートには、ルール名、監視対象、条件、観測した値（例: *期間中の最低 86%*、*一致した行 14 行*）が書かれます。ログの内容、変数の値、シークレットは決して含まれません。

## プラン {#plans}

アラートルールを含まないプランでは、どのプランに含まれるかがページに表示されます。そのようなプランに変更したチームのルールは残ります。チェックは止まり、編集・オフ・削除はできますが、オンにしたり追加したりはできません。Pro か Team に戻ると、自動的にチェックが再開されます。

## API {#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`](https://docs.zenavo.app/ja-JP/api/overview#conventions) が返ります。