huawei-cloud-ces-ecs-monitoring

Huawei Cloud ECS 監視スキル

Cloud Eye Service（CES）を使用して ECS インスタンスのメトリクスを照会・分析する、Huawei Cloud の専門的な監視アシスタントです。体系化されたワークフローに従って、包括的な監視情報を提供します。

1. 概要

機能概要

Huawei Cloud ECS 監視スキルは、Cloud Eye Service（CES）を使用して、Elastic Cloud Server インスタンスの包括的な監視機能とメトリクス照会機能を提供します。CPU、メモリ、ディスク、ネットワーク、システムメトリクスのリアルタイム監視、履歴データの照会、一般的なメトリクスの分析に対応しています。

アーキテクチャ図

User Request → Huawei Cloud CLI (hcloud) → Cloud Eye Service (CES) → ECS Instance
                    ↓
                IAM Permission Verification
                    ↓
                Monitoring Data Return

適用シナリオ

• ECS インスタンスの CPU、メモリ、ディスク、ネットワークの使用率を監視する
• パフォーマンス分析のために履歴メトリクスを照会する
• 基本的な監視ダッシュボードを設定する
• パフォーマンスのボトルネックをトラブルシューティングする
• リソース使用率の傾向を分析する
• システムメトリクスとカスタムメトリクスを確認する

ユーザーシナリオの例

1. 基本的な監視の依頼：「ECS インスタンスのパフォーマンスを確認してください」
2. 特定のメトリクスの照会：「インスタンス ecs-server-01 の CPU とメモリの使用率を表示してください」
3. 履歴データの分析：「過去 7 日間のディスク IO の傾向を表示してください」
4. トラブルシューティング：「ECS インスタンスの動作が遅いので、すべてのメトリクスを確認してください」

2. 前提条件

CLI のインストールと確認

操作を開始する前に、Huawei Cloud CLI（hcloud）をインストールして確認する必要があります。

インストールの確認：

hcloud --version

インストールされていない場合は、詳細なインストールガイドに従ってください： インストール手順の詳細については、references/cli-installation-guide.md を参照してください。

• macOS
• Linux
• Windows

設定方法

Huawei Cloud の認証情報を設定します。

hcloud configure init

対話形式のプロンプトに従って、次の項目を設定します。

• Access Key ID
• Secret Access Key
• リージョン
• Project ID（任意）

セキュリティルール

[MUST] コアワークフローの開始時（CLI を呼び出す前）に、必ず次の操作を行ってください。

hcloud configure list

セキュリティルール：

• 絶対に AK/SK の値を読み取ったり、エコーしたり、表示したりしないでください（例：echo $HUAWEICLOUD_ACCESS_KEY は禁止です）
• 絶対に 会話中やコマンドラインで、ユーザーに AK/SK を直接入力するよう求めないでください
• 認証情報の状態の確認には、hcloud configure list のみを使用してください

有効な設定がない場合は、ここで停止してください：

1. Huawei Cloud Console から認証情報を取得します
2. このセッションの外部で認証情報を設定します（ターミナルで hcloud configure init を実行）
3. hcloud configure list で有効な設定が表示されたら、戻って再実行します

IAM 権限の要件

このスキルには、次の最小限の IAM 権限が必要です。

• ecs:cloudServers:list - ECS インスタンスの一覧表示
• ecs:cloudServers:get - ECS インスタンスの詳細取得
• ces:metrics:list - 利用可能なメトリクスの一覧表示
• ces:metricData:get - メトリクスデータの取得

追加の任意の権限（例：ces:alarms:list、ces:alarmTemplates:list）および詳細なポリシー設定については、references/iam-policies.md を参照してください。

権限エラーへの対処

操作中に権限エラー（例：「Access denied」、「Insufficient permissions」）が発生した場合は、必要な権限の一覧、JSON ポリシーテンプレート、IAM コンソールの設定手順など、完全な対処手順について references/iam-policies.md を参照してください。

3. KooCLI コマンド形式の標準

[MUST] CLI コマンドを実行する前に、コマンド形式の標準について references/related-commands.md を読んでください。

主なルール：

• 適切なコマンド構造を使用します：hcloud <service> <command> <parameters>
• 常にリージョンを指定します：--cli-region=<region-id>
• ECS コマンドには ecs サービスを使用します
• CES コマンドには ces サービスを使用します
• 複雑なパラメーターには適切な JSON 形式を使用します

[MUST] コマンド形式 - すべての hcloud CLI コマンドは、Huawei Cloud CLI の標準に従う必要があります。

4. コアワークフロー／プロセス

ステップ 1：利用可能な ECS インスタンスの一覧表示

まず、現在のリージョンにあるすべての ECS インスタンスを一覧表示し、ユーザーが対象のインスタンスを特定できるようにします。

hcloud ECS NovaListServers --cli-region=<region-id> --limit=50

ステップ 2：一般的な監視メトリクスを照会する

ユーザーの要件に基づいて、関連する監視メトリクスを照会します。具体的なメトリクスが指定されていない場合は、一般的なメトリクスを表示します。

一般的な ECS メトリクス（デフォルト表示）- SYS.ECS 名前空間：

1. CPU 使用率（cpu_util）
2. メモリ使用率（mem_util）
3. ディスク読み取り／書き込みレート（disk_read_bytes_rate、disk_write_bytes_rate）
4. ネットワーク受信／送信レート（network_incoming_bytes_rate_inband、network_outgoing_bytes_rate_inband）
5. ディスク使用率（disk_util_inband）

注：上記は SYS.ECS（基本監視）メトリクスで、エージェントなしで利用できます。 Telescope エージェントが必要な OS レベルの監視（AGT.ECS 名前空間）については、 cpu_usage、mem_usedPercent、disk_usedPercent、load_average1 などを含む完全なメトリクス一覧が記載された references/ces-metrics-reference.md を参照してください。

その他の関連メトリクスは references/ces-metrics-reference.md に記載されています。

名前空間の選択とフォールバック戦略：

ECS メトリクスを照会する際は、次の名前空間選択ロジックに従ってください。

1. デフォルト：最初に SYS.ECS メトリクスを照会します（エージェント不要、すべてのインスタンスで利用可能）。
2. AGT.ECS へのフォールバック：個々の SYS.ECS メトリクスの照会でデータが返されない場合は、対応するメトリクスを AGT.ECS 名前空間から取得します（例：cpu_util → cpu_usage）。完全なフォールバック対応表については、references/ces-metrics-reference.md を参照してください。
3. AGT.ECS 専用メトリクス：一部のメトリクスは AGT.ECS 名前空間にのみ存在します（例：load_average1、net_tcp_total、disk_readTime、disk_inodesUsedPercent）。これらは --metrics.N.namespace="AGT.ECS" および --period=60 を指定して直接照会してください。

SYS.ECS メトリクスの照会でデータが返されない一般的な理由：

• インスタンスイメージに UVP VMTools がインストールされていない（mem_util、disk_util_inband、network_*_inband に影響します）
• インスタンスが最近作成され、メトリクスがまだ生成されていない（5～10 分待ってください）
• インスタンスが ACTIVE 状態ではない

コマンド例 - SYS.ECS の照会：

hcloud CES BatchListMetricData \
  --metrics.1.namespace="SYS.ECS" \
  --metrics.1.metric_name="cpu_util" \
  --metrics.1.dimensions.1.name="instance_id" \
  --metrics.1.dimensions.1.value="<instance-id>" \
  --from=$(date -d '-1 hour' +%s)000 \
  --to=$(date +%s)000 \
  --period=300 \
  --filter="average" \
  --cli-region=<region-id>

コマンド例 - AGT.ECS の照会（SYS.ECS にデータがない場合、または AGT.ECS 専用メトリクスの場合）：

hcloud CES BatchListMetricData \
  --metrics.1.namespace="AGT.ECS" \
  --metrics.1.metric_name="cpu_usage" \
  --metrics.1.dimensions.1.name="instance_id" \
  --metrics.1.dimensions.1.value="<instance-id>" \
  --from=$(date -d '-1 hour' +%s)000 \
  --to=$(date +%s)000 \
  --period=60 \
  --filter="average" \
  --cli-region=<region-id>

その他の関連コマンドは references/related-commands.md に記載されています。

ステップ 3：メトリクスを分析して比較する

返された監視データに基づいて、次の操作を行います。

• 現在の値を推奨しきい値と比較します
• しきい値に近づいている、または超えているメトリクスを特定します
• AGT.ECS メトリクスの場合は、監視エージェントがインストールされていることを確認します
• 関連するメトリクスを相互に照合します（例：CPU 使用率とロードアベレージ）
• [必須] データが空の場合の処理：SYS.ECS メトリクスの照会でデータポイントが返されない場合：
  1. インスタンスが ACTIVE 状態かどうかを確認します
  2. 対応する AGT.ECS メトリクスを試します（ステップ 2 のフォールバック対応を参照）
  3. AGT.ECS でもデータが返されない場合は、Telescope エージェントがインストールされているか確認します
  4. 考えられる理由（UVP VMTools がない、インスタンスが新しすぎる、エージェントがインストールされていない）をユーザーに伝えます

ステップ 4：結果を整形して提示する

監視データを明確で実行可能な形式で提示します。

• タイムスタンプとともにメトリクスの値を表示します
• 傾向と異常を特定します
• しきい値を超えている場合は推奨事項を提示します
• 最適化のための次のステップを提案します

オプションの手順：アラーム管理

ユーザーがアラームの表示または管理を必要とする場合：

# List alarms
hcloud CES ListAlarms --cli-region=<region-id>

# List alarm templates
hcloud CES ListAlarmTemplates --cli-region=<region-id>

5. コアコマンド

'../references/related-commands.md' を参照してください

6. パラメーターの説明

必須パラメーター

パラメーター	説明	値の例	デフォルト値
--cli-region	リージョン ID	cn-north-4	なし。指定が必要です
--metrics.1.namespace	メトリクス 1 の名前空間（SYS.ECS または AGT.ECS）	SYS.ECS	なし。指定が必要です
--metrics.1.metric_name	メトリクス 1 のメトリクス名	cpu_util	なし。指定が必要です
--metrics.1.dimensions.1.name	ディメンション名	instance_id	なし。指定が必要です
--metrics.1.dimensions.1.value	ディメンション値	3d65c1ac-9a9f-4c5f-a054-35184a087bb2	なし。指定が必要です

オプションパラメーター

パラメーター	説明	値の例	デフォルト値
--from	開始時刻（ミリ秒単位の Unix タイムスタンプ）	$(date -d '-1 hour' +%s)000	現在時刻 - 1 時間
--to	終了時刻（ミリ秒単位の Unix タイムスタンプ）	$(date +%s)000	現在時刻
--period	統計期間（秒）	300	300
--filter	統計方法	average	average
--project-id	プロジェクト ID	project-id	設定ファイルのプロジェクト ID

時間範囲のオプション

• 過去 1 時間（デフォルト）
• 過去 6 時間
• 過去 24 時間
• 過去 7 日間
• カスタム範囲（ユーザー指定）

注：period=60（1 分間隔）は AGT.ECS メトリクスでのみ利用できます。SYS.ECS メトリクスの最小期間は 300（5 分）です。

名前空間

• SYS.ECS - 基本モニタリング（エージェント不要、最小粒度：5 分／period=300）
• AGT.ECS - OS モニタリング（Telescope Agent が必要、最小粒度：1 分／period=60）

名前空間の詳細な説明と利用可能なメトリクスについては、references/ces-metrics-reference.md を参照してください。

filter

値の範囲：average、variance、min、max、sum をサポートします

• average：平均値
• variance：分散
• min：最小値
• max：最大値
• sum：合計値

7. 出力形式

モニタリングレポート形式

## ECS Monitoring Report
**Instance**: <instance-name> (<instance-id>)
**Region**: <region>
**Time Range**: <start-time> to <end-time>

### Key Metrics Summary
- CPU Utilization: XX.XX% (avg), XX.XX% (max), XX.XX% (min)
- Memory Utilization: XX.XX% (avg), XX.XX% (max), XX.XX% (min)
- Disk Read Rate: XX.XX MB/s (avg)
- Disk Write Rate: XX.XX MB/s (avg)
- Network Inbound: XX.XX Mbps (avg)
- Network Outbound: XX.XX Mbps (avg)

### Detailed Metrics
| Time | CPU Usage | Memory Usage | Disk Read | Disk Write | Network In | Network Out |
|------|-----------|--------------|-----------|------------|------------|-------------|
| ...  | ...       | ...          | ...       | ...        | ...        | ...         |

### Recommendations
1. [If CPU > 80%] Consider scaling up instance type or optimizing application
2. [If Memory > 85%] Consider adding memory or optimizing memory usage
3. [If Disk > 90%] Consider expanding disk or cleaning up files
4. [Network bottlenecks] Consider optimizing network configuration

8. 検証方法

スキルの検証およびテスト方法：references/verification-method.md

基本的な検証手順

1. 環境の検証：Huawei Cloud CLI がインストールされ、設定されていることを確認します
2. 権限の検証：IAM 権限が十分であることを確認します
3. 機能の検証：モニタリングの主要機能をテストします
4. エラー処理の検証：さまざまなエラー状況への対応をテストします

テストケース

• 通常のシナリオ：モニタリングデータのクエリに成功する
• 権限不足のシナリオ：権限エラーに対処する
• インスタンスが見つからないシナリオ：インスタンスの検索失敗に対処する
• ネットワークエラーのシナリオ：接続の問題に対処する

9. ベストプラクティス

メトリクスの選択ガイドライン、アラート戦略、モニタリング頻度の推奨事項、パフォーマンスの最適化、コストの最適化など、詳しいベストプラクティスについては references/best-practices.md を参照してください。

基本原則

1. 一般的なメトリクスをデフォルトにする - ユーザーが指定しない場合は、一般的なメトリクスをデフォルトで表示します
2. 実行可能な分析情報を提供する - 生データだけでなく、分析と推奨事項も提供します
3. 関連するメトリクスをまとめてクエリする - 1 回のリクエストで複数のメトリクスをクエリし、API 呼び出しの頻度を減らします

10. 参考ドキュメント

詳細については、references/ ディレクトリ内のドキュメントを参照してください。

• cli-installation-guide.md：Huawei Cloud CLI のインストールおよび設定ガイド
• ces-metrics-reference.md：ECS 用 CES メトリクスの完全な一覧
• iam-policies.md：必要な IAM 権限とポリシー
• best-practices.md：モニタリングのベストプラクティスと最適化のヒント
• troubleshooting-guide.md：一般的な問題と解決策
• verification-method.md：スキルの検証およびテスト方法
• acceptance-criteria.md：品質基準と受け入れ基準
• related-commands.md：関連コマンドのリファレンス

11. 注意事項

セキュリティに関するヒント

• 認証情報のセキュリティ：AK/SK をコード、ログ、会話に決して公開しないでください。
• 最小権限の原則：必要な IAM 権限のみを付与してください。

その他のセキュリティのベストプラクティス（キーのローテーション、IAM 条件、アカウントの分離）については、references/iam-policies.md を参照してください。

制限事項

• API 制限：Huawei Cloud API のレート制限にご注意ください。
• データ保持期間：モニタリングデータの保持期間には制限があります。

具体的な制限（データポイントの最大数、クエリ頻度、バッチ制限）については、references/ces-metrics-reference.md を参照してください。

既知の問題

1. データの遅延：モニタリングデータには 1～2 分の遅延が発生する場合があります。
2. メトリクスの利用可能性：新しく作成されたインスタンスでは、メトリクスの報告が開始されるまで数分かかる場合があります。

トラブルシューティング

よくあるエラーと詳細な解決方法については、references/troubleshooting-guide.md を参照してください。

サポートとフィードバック

• Huawei Cloud の公式ドキュメント：https://support.huaweicloud.com/usermanual-ecs/ecs_03_1001.html
• CLI のリファレンスドキュメント：https://support.huaweicloud.com/function-hcli/index.html
• 問題のフィードバック：Huawei Cloud のチケットシステムまたはテクニカルサポート窓口をご利用ください。