プロジェクトアラートの管理
プロジェクトアラートを使用すると、指定した条件を満たしたときに通知が送信され、Zilliz Cloud クラスターをプロアクティブに監視できます。CU 容量やクエリパフォーマンスなどのクラスターメトリクスを監視するようにプロジェクトアラートを構成することで、対応が必要な潜在的な問題をすぐに把握できます。
この機能は Dedicated クラスターでのみ利用できます。
事前準備
プロジェクトアラートを作成または管理する前に、以下の条件を満たしていることを確認してください。
- Organization Owner または Project Admin ロールの権限を持っていること
プロジェクトアラートの表示
左サイドバーの Project Alerts に移動すると、プロジェクトアラートのダッシュボードにアクセスできます。
アラート履歴
過去のイベントを調査したり、アラートのパターンを把握したり、システムの信頼性を示したりする必要がある場合は、History タブを使用します。
アラート設定
- Cloud Console
- Bash
Settings タブでは、設定済みのすべてのアラートとその現在のステータスを確認できます。これにより、監視範囲を一元的に把握できます。
アラートを表示すると、以下の設定項目が表示されます。
フィールド | 説明 |
|---|---|
名前 | アラートを識別するための説明的な名前(例:"High CU Usage - Dedicated Clusters"、"P99 Query Latency") |
ステータス | アラートの現在の状態を示すトグルスイッチ:Enabled(アクティブな監視)または Disabled(通知なし) |
対象クラスター | 監視対象のクラスター。特定のクラスター(例:"Dedicated-02, Dedicated-01")またはすべての Dedicated クラスター(今後作成されるクラスターを含む)です。 |
メトリクスと条件 | 監視対象のパラメーターとトリガー設定を組み合わせて表示します(例:"CU Capacity > 80%, Duration >= 10 min"、"Query Latency (P99) > 1000 ms, Duration >= 10 min")。 |
重大度レベル | 影響度の分類
|
受信者 | 設定済みのメールアドレスや通知チャネルを含む、通知の受信者です。 利用可能な通知チャネルの一覧については、通知チャネルの管理 を参照してください。 |
アラート間隔 | 各アラートの送信後、設定された時間だけ繰り返し通知を抑制します。
|
操作 | 利用可能な管理操作:Edit、Clone、Delete |
特定のプロジェクトに作成されたアラートの一覧を表示できます。パラメーターの詳細については、List Alert Rules を参照してください。
export BASE_URL=https://api.cloud.zilliz.com
export PROJECT_ID=proj-bf71ce2fd4f3785d*****
export API_KEY=c84c9a9515**********81319c2f147ffdd47ad6c36b31c126d1b790f457619c23237eba9287de73575943d2bfebcecd728bd07e
curl --request GET \
--url "${BASE_URL}/v2/alertRules?projectId=${PROJECT_ID}" \
--header "Authorization: Bearer ${API_KEY}" \
--header "Accept: application/json" \
--header "Content-type: application/json"
プロジェクトアラートの作成
- Cloud Console
- Bash
クラスターのパフォーマンスと健全性をさまざまな観点から監視するための新しいアラートを設定します。
特定の Dedicated クラスターまたはすべての Dedicated クラスターに対してアラートを作成できます。パラメーターの詳細については、Create Alert Rule を参照してください。
export BASE_URL=https://api.cloud.zilliz.com
export PROJECT_ID=proj-bf71ce2fd4f3785d*****
export API_KEY=c84c9a9515**********81319c2f147ffdd47ad6c36b31c126d1b790f457619c23237eba9287de73575943d2bfebcecd728bd07e
curl --request POST \
--url "${BASE_URL}/v2/alertRules" \
--header "Authorization: Bearer ${API_KEY}" \
--header "Accept: application/json" \
--header "Content-type: application/json" \
--data-raw '{
"projectId": "'"${PROJECT_ID}"'",
"ruleName": "High CU Computation",
"level": "CRITICAL",
"metricName": "CU_COMPUTATION",
"metricUnit": "percent",
"threshold": 80,
"windowSize": 10,
"comparisonMethod": "GREATER_THAN",
"targetClusterIds": ["inxx-xxxxxxxxxxxxxxx"],
"enabled": true,
"sendResolved": true,
"actions": [
{
"type": "EMAIL",
"config": {
"recipients": {
"members": ["leryn.li@zilliz.com"],
"orgRoles": ["OWNER"],
"projectRoles": ["OWNER"]
}
}
}
]
}'
プロジェクトアラートの管理
既存のアラートを変更、整理、保守して、監視を適切かつ効果的に維持します。
プロジェクトアラートは RESTful API からも管理できます。詳細については、Update Alert Rule および Delete Alert Rule を参照してください。
アラートの無効化または有効化
設定を失わずに、アクティブな監視を制御します。
-
無効化されたアラート: 通知の送信は停止しますが、すべての設定は保持されます
-
有効化されたアラート: クラスターをアクティブに監視し、しきい値を超えたときに通知を送信します
アラートの編集
監視要件が変更されたら、アラート設定を更新します。
以下を含む、任意のアラートパラメーターを変更できます。
-
しきい値と比較演算子
-
対象クラスターとメトリクスの種類
-
通知チャネル、受信者、アラート間隔
-
重大度レベルと期間の設定
アラートの複製
最小限の設定作業で類似のアラートを作成できます。複製では既存の設定がすべてコピーされるため、次のことが可能です。
-
異なるクラスター環境向けのバリエーションを作成する
-
他のパラメーターを維持したまましきい値を調整する
-
複数のプロジェクトにわたって監視を拡張する
アラートの削除
不要になった監視ルールや重複した監視ルールを削除します。
アラートの削除は永続的で、元に戻すことはできません。先に進む前に、そのアラートが不要であることを確認してください。
アラート受信者設定の構成
プロジェクト全体のデフォルト通知設定を行い、チーム全体で一貫した監視運用を確保します。
設定を構成する際には、以下の項目を確認します。
-
Send to: 新しいアラートに自動的に選択されるデフォルトの通知チャネル(メール、Slack、Webhook)です。よく使用するチャネルを設定しておくと、アラートの作成を効率化できます。
-
Alert Resolution Notification: 有効にすると、アラートが解決したときに通知を受け取ります。
-
Apply Settings to Existing Alerts: 新しいデフォルト設定で既存のすべてのアラートを更新するかどうかを選択します。
FAQ
アラートがトリガーされたとき、アラート通知はどのくらいの頻度で届きますか?
アラート通知は、以下の自動的な頻度パターンに従います。
-
最初の通知: アラートのしきい値を超えた時点で即座に送信されます
-
2 回目の通知: 条件が継続している場合は、1 時間後に送信されます
-
以降の通知: アラート条件が有効な間、1 日 1 回送信されます
通知が頻繁すぎると感じる場合は、次の対応が可能です。