プロジェクトアラートの管理
プロジェクトアラートを使用すると、指定した条件を満たした際に通知を送信し、Zilliz Cloud クラスターをプロアクティブに監視できます。CU キャパシティやクエリパフォーマンスなどのクラスターメトリクスを監視するよう設定することで、対応が必要な潜在的な問題が発生した際にすぐに通知を受け取ることができます。
始める前に
プロジェクトアラートを作成または管理する前に、以下の要件を満たしていることを確認してください。
- Organization Owner または Project Admin ロールのアクセス権限
プロジェクトアラートの表示
左サイドバーの Project Alerts に移動して、プロジェクトアラートダッシュボードにアクセスします。
アラート履歴
過去のイベントの調査、アラートパターンの把握、またはシステムの信頼性の確認が必要な場合は、History タブを使用します。
アラート設定
- Cloud Console
- Bash
Settings タブでは、設定済みのすべてのアラートとその現在のステータスを確認できます。これにより、監視対象の範囲を一元的に把握できます。
アラートを表示する際、以下の設定項目が表示されます。
Field | Description |
|---|---|
Name | アラートのわかりやすい識別子(例:"High CU Usage - Dedicated クラスター"、"P99 Query Latency") |
Status | 現在のアラート状態を示すトグルスイッチ:Enabled(監視有効)または Disabled(通知なし) |
Target Cluster | 監視対象のクラスター。特定のクラスター(例:"Dedicated-02, Dedicated-01")またはすべての Dedicated クラスター(今後作成されるクラスターを含む)を指定できます。 |
Metric & Condition | 監視対象パラメーターとトリガー設定を組み合わせて表示します(例:"CU Capacity > 80%, Duration >= 10 min"、"Query Latency (P99) > 1000 ms, Duration >= 10 min")。 |
Severity Level | 影響度の分類
|
Receiver | 設定済みのメールアドレスや通知チャネルを含む、通知の受信者です。 利用可能な通知チャネルの一覧については、Manage Notification Channels を参照してください。 |
Alert Interval | アラート送信後、設定された時間内は重複する通知を抑制します。
|
Actions | 利用可能な管理オプション: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 クラスター、またはすべてのクラスターを対象にアラートを作成できます。パラメーターの詳細については、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 を参照してください。
アラートの無効化または有効化
設定を保持したまま、監視の有効・無効を切り替えることができます。
-
無効化されたアラート: 通知の送信は停止しますが、すべての設定は保持されます。
-
有効化されたアラート: クラスターを積極的に監視し、閾値を超えた場合に通知を送信します。
アラートの編集
監視要件の変更に合わせてアラート設定を更新します。
以下を含む任意のアラートパラメーターを変更できます。
-
閾値と比較演算子
-
対象クラスターとメトリクスタイプ
-
通知チャネル、受信者、およびアラートインターバル
-
重大度レベルと期間設定
アラートの複製
最小限の設定作業で類似のアラートを作成できます。複製すると既存の設定がすべてコピーされるため、以下のような操作が可能です。
-
異なるクラスター環境向けにバリエーションを作成する
-
他のパラメーターを維持したまま閾値を調整する
-
複数のプロジェクトにわたって監視を拡張する
アラートの削除
不要になった監視ルールや冗長なルールを削除します。
アラートの削除は永続的であり、元に戻すことはできません。実行前に、そのアラートが不要であることを必ず確認してください。
アラート受信設定の構成
プロジェクト全体のデフォルト通知設定を定義し、チーム全体で一貫した監視体制を維持できます。
設定時には、以下の項目を確認してください。
-
送信先: 新規アラート作成時に自動選択されるデフォルトの通知チャネル(メール、Slack、Webhook)です。よく使うチャネルを登録しておくと、アラート作成がスムーズになります。
-
アラート解決通知: 有効にすると、アラートが解消された際にも通知が届きます。
-
既存のアラートに設定を適用: 新しいデフォルト設定を既存のすべてのアラートに反映するかどうかを選択できます。
FAQ
アラート発生時、通知はどのくらいの頻度で届きますか?
アラート通知は、以下のスケジュールで自動的に送信されます。
-
初回通知: アラートのしきい値超過時に即時送信
-
2回目の通知: 条件が継続している場合、1時間後に送信
-
以降の通知: アラート状態が継続中は1日1回送信
通知が頻繁すぎると感じる場合は、以下の対応が可能です。