プロジェクトアラートの管理

プロジェクトアラートを使用すると、指定した条件を満たした際に通知を送信し、Zilliz Cloud クラスターをプロアクティブに監視できます。CU 容量やクエリパフォーマンスなどのクラスターメトリクスを監視するよう設定することで、対応が必要な潜在的な問題をいち早く検知できます。

📘Notes

この機能は Dedicated クラスターでのみ利用可能です。

事前準備

プロジェクトアラートを作成または管理する前に、以下の条件を満たしていることを確認してください。

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	影響度の分類 Warning: 制限に接近しています Critical: 即時対応が必要です
Receiver	通知の送信先です。設定済みのメールアドレスや通知チャネルが含まれます。利用可能な通知チャネルの一覧については、Manage Notification Channels を参照してください。
Alert Interval	アラート送信後、指定された時間だけ繰り返し通知を抑制します。アラートが継続している場合でも、この間隔中は再送信されず、次の間隔に入る前に通知が再送されます。アラートが解消されると、アラート間隔はリセットされ、評価が再開されます。
Actions	利用可能な操作: Edit、Clone、Delete

特定のプロジェクト用に作成されたアラートの一覧を表示できます。各パラメータの詳細については、List Alert Rules を参照してください。

bash
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 を参照してください。

bash
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"]
             }
           }
         }
       ]
     }'