olares-dashboard

dashboard（概要＋アプリケーション、AI エージェント優先）

共通の入口： スイート内のルーティング、アクティブなプロフィールの選択、プラットフォームのエントリーポイント、認証の続行／停止ゲートについては、../olares-shared/SKILL.md を読み込んでください。ログイン、プロフィールの切り替え、トークンの保存、認証の復旧が実際に必要な場合にのみ、その認証リファレンスを読み込んでください。

構文を確認するには olares-cli dashboard <verb> --help を使用します。

使用する場面

• CPU、メモリー、ディスク、ネットワーク、Pod、ファン、GPU のメトリクスを読み取る。
• リソース使用量でアプリケーション／ワークロードを順位付けする。
• ダッシュボードのメトリクスを経時的に観察する、または安定した JSON エンベロープを利用する。

メンタルモデル： dashboard は「リソースの使用状況と健全性」を確認するためのものです。インベントリーとライフサイクルについては、別の場所にルーティングしてください。メトリクスから問題（リソースの逼迫、running なのに遅い／到達できないアプリ）が見つかった場合は、根本原因の診断のために ../olares-doctor/SKILL.md に引き継いでください。

クイックパス

タスク	読むもの	最初のコマンド
マシンの現在の負荷を確認する	このファイル	olares-cli dashboard overview -o json
どのアプリがリソースを使用しているかを調べる	このファイル	olares-cli dashboard applications -o json
1つのメトリクスを読み取り、意味を把握する	overview セクションの意味	olares-cli dashboard overview memory -o json
空の応答が失敗かどうかを判断する	エンベロープと空の状態	olares-cli dashboard overview gpu -o json を実行し、meta.empty_reason を読む

経時的な監視はクイックパスではありません。watch、ウィンドウ、NDJSON は独立した項目であり、メトリクスの観察を最初に行うべきではありません。

Verb インデックス

Verb	目的	該当する場合に読むもの
applications (apps)	ワークロード単位のリソーステーブル	行はアプリではなくワークロードです。そのため、1つのアプリが複数の行を占める場合があります。overview ranking とは (app, namespace) で結合します
overview	物理、ユーザー、順位付けの各セクション	overview セクションの意味；エンベロープと空の状態
`overview cpu	memory	disk
schema	提供される JSON スキーマ	CLI が実行せずに出力形式を説明する唯一の場所です。ライブ応答をサンプリングする代わりに、これを読んでください
watch／ウィンドウ指定を伴う任意のメトリクス	繰り返しのスナップショット／過去の期間	watch、ウィンドウ、NDJSON

エンベロープと機能のセマンティクス

• 自動化ではテーブルのラベルではなく、kind、raw、meta.empty_reason を基準にしてください。
• ハードウェアがない、統合がない、または機能ゲートがある場合、通常はコマンドの失敗ではなく、exit 0 の空のエンベロープになります。
• 集約 Verb（overview、overview disk|fan|gpu）は、すべてのセクションに meta.error がある場合にのみゼロ以外で終了します。一部が劣化したエンベロープでも、実データがあれば exit 0 です。どちらの場合もエンベロープは stdout に出力されるため、終了コードだけで判断せず、セクションごとのエラーを確認してください。
• インスタンス全体の停止は、すべてのセクションで HTTP 530 として示されます。Olares に到達できないため、dashboard 自体を診断する前に、オンラインであることを確認してください。
• ファンのメトリクスが意味を持つのは Olares One のみです。デバイスゲートで利用不可と判定されたら、確認を続けないでください。
• 非管理者プロフィールで GPU のサイドバーが非表示になっていても、データが返されている場合は参考情報です。vgpu_unavailable は一時的な証拠であり、そのデバイスに GPU がないことの証明ではありません。

監視と診断

• 監視ではスナップショットが繰り返し出力されます。JSON モードは NDJSON です。Ctrl-C で終了するのは監視のみであり、ワークロードは終了しません。
• 監視は、反復処理の失敗が続くと中断します。一時的なメトリクス収集の失敗と、実際のリソース逼迫を区別してください。
• ユーザーの質問に応じて、相対時間または絶対時間のいずれかの期間を選択してください。両方を組み合わせないでください。
• ダッシュボードで特定できるのはリソース逼迫の箇所です。ポッドのスケジューリング、クラッシュ、イメージの取得、イングレスの失敗については説明できません。これらは olares-doctor に振り分けてください。

安全性とエスカレーション

• ダッシュボードは読み取り専用ですが、ユーザーをまたぐメトリクスの参照にはプラットフォーム管理者権限が必要です。承認なしにプロファイルを切り替えたり、対象ユーザーの範囲を広げたりしないでください。
• 空の連携エンベロープを「正常」や「使用量ゼロ」として報告しないでください。空である理由をそのまま保持してください。
• 上流のメトリクスエラーが、上限を定めた再試行後も続く場合は、影響を受けるセクションと期間を含めて停止し、エスカレーションしてください。