📊monitoring
- プラグイン
- zilliz
- ソース
- GitHub で見る ↗
説明
次のような場合に使用: ユーザーがクラスターのステータス確認、コレクションの統計情報、ロード状態の確認、 またはZilliz Cloudリソースの概要取得を行いたい場合。
原文を表示
Use when the user wants to check cluster status, collection statistics, load states, or get an overview of their Zilliz Cloud resources.
ユースケース
- ✓クラスターのステータス確認
- ✓コレクションの統計情報取得
- ✓ロード状態の確認
- ✓Zilliz Cloudリソース概要の取得
本文(日本語訳)
前提条件
- CLIがインストール済みでログイン済みであること(セットアップスキルを参照)。
- コレクションレベルのモニタリングに向けたクラスターコンテキストが設定済みであること(セットアップスキルを参照)。
コマンドリファレンス
コレクションを対象とするすべてのモニタリングコマンドは、オプションで --database <db-name> フラグを受け付けます。
省略した場合は、現在のコンテキストに設定されたデータベースが使用されます。
クラスターステータス
# 現在のコンテキストを確認
zilliz context current
# クラスターの詳細(ステータス、プラン、リージョン、エンドポイント)
zilliz cluster describe --cluster-id <cluster-id>
コレクション概要
すべてのコレクションをその統計情報とともに一覧表示します:
# コレクションの一覧表示
zilliz collection list
zilliz collection list --database <db-name>
# 各コレクションの統計情報とロード状態を取得
zilliz collection get-stats --name <collection-name>
zilliz collection get-load-state --name <collection-name>
クラスターに複数のデータベースが存在する場合は、まず zilliz database list を実行して各データベースを列挙し、
続けて各データベースに対して zilliz collection list --database <db-name> を実行してください。
データベース概要
zilliz database list
全クラスター
zilliz cluster list --all
時系列メトリクス
クラスター全体の時系列(CUサイジング、ストレージ、サーバーレスVCU、スロークエリ)を確認するには、
zilliz cluster metrics を使用します:
zilliz cluster metrics --cluster-id <cluster-id> -m CU_COMPUTATION --period 1h
コレクション単位の時系列(QPS、レイテンシ、エンティティ数、ハイブリッド検索エイリアス)を確認するには、
zilliz collection metrics を使用します。
メトリクススコープのルールとエイリアスの完全な一覧については、コレクションスキルを参照してください:
zilliz collection metrics -c <collection-name> -m SEARCH_QPS --period 1h
両コマンドはデフォルトでインラインのBrailleラインチャートを描画します
(各メトリクスが1ブロックで表示され、min / max / avg / last のサマリーが付きます)。
ピボットテーブル形式で出力するには -o table(または --output table)を明示的に指定し、
スクリプト向けに生データを取得するには -o json または --query を使用してください。
結果の表示
ユーザーがステータスの概要を求めた場合は、情報を収集してサマリーテーブルとして提示します:
クラスター情報:
- クラスターID、名前、ステータス(RUNNING / SUSPENDED など)
- プランタイプ、リージョン、作成日時
コレクションサマリー: 以下の列を持つテーブルとして提示します:
| コレクション | 行数 | ロード状態 |
|---|
collection list を実行した後、各コレクションに対して get-stats と get-load-state を実行して情報を収集してください。
ガイダンス
- ステータスを提示する際は
--output jsonを使用して機械可読なデータを取得し、ユーザー向けに読みやすいサマリー形式に整形してください。 - クラスターがサスペンド状態の場合は、その旨を目立つ形で明示し、データプレーン操作が利用できないことをユーザーに通知してください。
- 複数のクラスターが存在する場合は、まずすべてのクラスターのサマリーテーブルを表示してから、選択されたクラスターの詳細に掘り下げてください。
原文(English)を表示
Prerequisites
- CLI installed and logged in (see setup skill).
- Cluster context set for collection-level monitoring (see setup skill).
Commands Reference
All monitoring commands that target collections accept an optional --database <db-name> flag. If omitted, the database from the current context is used.
Cluster Status
# Current context
zilliz context current
# Cluster details (status, plan, region, endpoints)
zilliz cluster describe --cluster-id <cluster-id>
Collection Overview
List all collections with their stats:
# List collections
zilliz collection list
zilliz collection list --database <db-name>
# For each collection, get stats and load state:
zilliz collection get-stats --name <collection-name>
zilliz collection get-load-state --name <collection-name>
If the cluster has multiple databases, iterate through each database by running zilliz database list first, then zilliz collection list --database <db-name> for each.
Database Overview
zilliz database list
All Clusters
zilliz cluster list --all
Time-series Metrics
For cluster-wide time series (CU sizing, storage, serverless VCU, slow queries) use zilliz cluster metrics:
zilliz cluster metrics --cluster-id <cluster-id> -m CU_COMPUTATION --period 1h
For per-collection time series (QPS, latency, entity counts, hybrid-search aliases) use zilliz collection metrics -- see the collection skill for metric scope rules and the full alias list:
zilliz collection metrics -c <collection-name> -m SEARCH_QPS --period 1h
Both commands render an inline Braille line chart by default (one block per metric with a min / max / avg / last summary). Pass an explicit -o table (or --output table) for the pivot-table layout, or use -o json / --query to get raw data for scripting.
Presenting Results
When the user asks for a status overview, collect and present information as a summary table:
Cluster Info:
- Cluster ID, name, status (RUNNING/SUSPENDED/etc.)
- Plan type, region, create time
Collections Summary: Present as a table with columns:
| Collection | Rows | Load State |
|---|
Gather this by running collection list, then get-stats and get-load-state for each collection.
Guidance
- When presenting status, use
--output jsonto get machine-readable data, then format it into a readable summary for the user. - If the cluster is suspended, note this prominently and inform the user that data-plane operations are unavailable.
- For multiple clusters, show a summary table of all clusters first, then drill into the selected one.
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。