翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# `managing-amazon-msk` スキルを使用してベストプラクティスを分析する
<a name="bestpractices-msk-skill"></a>

`managing-amazon-msk` スキルは、GitHub の エージェント[AWS ツールキットの エージェントスキルウェブサイト](https://github.com/aws/agent-toolkit-for-aws)にあるオープンソース[のエージェントスキル](https://agentskills.io/home)で、Amazon MSK プロビジョンドクラスターを運用するためのドメインの専門知識を提供します。このスキルを MCP 互換 AI コーディングエージェント (Kiro、、 など) CursorにインストールするとClaude Code、このスキルにより、AI エージェントはクラスターとクライアントをベストプラクティスに照らして評価し、運用上の問題を診断し、標準ブローカーと Express ブローカーとKafkaクライアントに推奨される設定を実装するのに役立ちます。このスキルは、汎用 AI モデルが頻繁に誤適用または省略される MSK 固有の運用知識をエンコードします。

## 機能
<a name="bestpractices-msk-skill-capabilities"></a>

このスキルは、次の分野を対象としており、それぞれがこのガイドに記載されているベストプラクティスにマッピングされています。


|  | ベストプラクティス領域 | スキルが役立つこと | 
| --- | --- | --- | 
| 1 | [標準 ブローカーのベストプラクティス](bestpractices.md) (標準) | ブローカーごとのパーティション数の評価、インスタンスサイズの推奨、m5.4xl\+ num.io.threads num.network.threads および m7g.4xl\+ インスタンスの評価とチューニング | 
| 2 | [Express ブローカー の ベストプラクティス](bestpractices-express.md) (Express) | ブローカーごとのスループット制限に基づいて必要なブローカー数を計算し、ターゲットの入出力に Express インスタンスタイプを推奨し、Express クォータに対してパーティション数を評価する | 
| 3 | [CPU 使用率をモニタリングする](bestpractices.md#bestpractices-monitor-cpu) | ブローカーリソースの飽和度を診断し、ブローカー側とクライアント側の根本原因と設定ミスを区別し、スケーリングが必要なタイミングを判断します。 | 
| 4 | [ディスク容量のモニタリング](bestpractices.md#bestpractices-monitor-disk-space) | 標準ブローカーのストレージ使用状況を評価し、高成長トピックを特定し、EBS の拡張または保持の調整を推奨します。Express の場合、ストレージ使用率 (ストレージはフルマネージド) をモニタリングしてコストを最適化する | 
| 5 | [Amazon MSK プロビジョニングされたクラスターに接続する](client-access.md) | プロデューサー/コンシューマー設定の監査、認証の設定、高可用性と耐障害性のための調整 | 
| 6 | [高可用性クラスターの構築](bestpractices.md#ensure-high-availability) | スタンダードブローカーの高可用性設定とマルチ AZ 配置、およびクライアントフェイルオーバー設定を検証する | 
| 7 | [Amazon MSK プロビジョニングされたクラスターをモニタリングする](monitoring.md) | Amazon MSK のオブザーバビリティとオペレーションに不可欠な主要メトリクスの CloudWatch ダッシュボードとアラームを作成する | 
| 8 | [Amazon MSK の主な特徴および概念](operations.md) | 更新に対するクラスターの準備状況を評価し、Standard と Express 間のパッチ適用動作を理解し、ブローカーの再起動がクライアントに与える影響を理解する | 

## 仕組み
<a name="bestpractices-msk-skill-how-it-works"></a>

AI コーディングエージェントに「MSK クラスター CPU が高いのはなぜですか？」などの Amazon MSK について質問するとき または「Help me set up monitoring for my Express cluster」 — スキルがアクティブ化され、エージェントに以下が提供されます。
+ **診断ワークフロー** — 最も可能性の高い根本原因を最初にチェックする構造化されたトラブルシューティングステップ (CPU の問題に対してブローカースケーリングを推奨`linger.ms`する前に検証するなど）。
+ **Broker-type-awareガイダンス** — このスキルは、クラスターが Standard ブローカーと Express ブローカーのどちらを使用しているかを判断し、そのブローカータイプに正しいメトリクス、しきい値、レコメンデーションを適用します。
+ **AWS CLI コマンド** — クラスターの説明、ストレージの拡張、設定の作成、CloudWatch メトリクスのクエリを行うための Ready-to-run コマンド。 CloudWatch 
+ **ベストプラクティスの検証** — 文書化された推奨事項に照らしてクラスター設定をチェックし、偏差にフラグを立てます。

## インストール
<a name="bestpractices-msk-skill-installation"></a>

### オプション 1: AWS CLI
<a name="bestpractices-msk-skill-install-cli"></a>

CLI AWS バージョン 2.35.0 以降が必要です。

```
# Interactive setup (installs default skills + configures AWS MCP Server)
aws configure agent-toolkit

# Or install the skill individually
aws agent-toolkit add-skill --skill-name managing-amazon-msk
```

CLI の詳細なドキュメントについては、「 [CLI AWS を使用したスキルの管理](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/aws-cli.html)」を参照してください。

### オプション 2: AWS MCP サーバー
<a name="bestpractices-msk-skill-install-mcp"></a>

AI コーディングエージェントを AWS MCP サーバーに接続します。これにより、サンドボックス化された AWS API 実行機能とともにスキルが提供されます。

```
{
  "mcpServers": {
    "aws-mcp": {
      "command": "uvx",
      "args": [
        "mcp-proxy-for-aws==1.6.2",
        "https://aws-mcp.us-east-1.api.aws/mcp",
        "--metadata", "AWS_REGION=us-east-1"
      ]
    }
  }
}
```

詳細なセットアップ手順については、[AWS 「MCP サーバーのセットアップ](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/getting-started-aws-mcp-server.html)」を参照してください。

## ユースケースと例
<a name="bestpractices-msk-skill-use-cases"></a>

### 標準ブローカーのベストプラクティスを評価する
<a name="bestpractices-msk-skill-uc-standard"></a>

**プロンプト:** 「ブローカーあたり 2,500 個のパーティションを持つ kafka.m5.2xlarge ブローカーを使用する MSK Standard クラスターがあります。ベストプラクティスに従っているか？」

スキル:
+ m5[.2xlarge のブローカーあたり 2,000 パーティションの推奨制限に対してパーティション](bestpractices.md#partitions-per-broker)数を確認します。
+ 推奨数を超え、更新オペレーションをサポートする最大 3,000 個に近づいていることを警告します。
+ パーティションを減らすか、m5.4xlarge (ブローカーあたり 4,000 パーティションをサポート) にアップグレードすることをお勧めします。
+ `num.io.threads` と `num.network.threads`の設定を確認し、サイズが小さい場合はチューニングをお勧めします。

### Express ブローカーのパフォーマンスを診断する
<a name="bestpractices-msk-skill-uc-express"></a>

**プロンプト:**「Express クラスターには 3 つの express.m7g.large ブローカーがあり、スロットリングが表示されています。何が問題ですか？」

スキル:
+ [ブローカーごとに 15.6 MBps の進入と 31.2 MBps の進入](limits.md#msk-express-quota)`express.m7g.large`をサポートする を特定します。
+ 現在のスループットについて質問するか、CloudWatch クエリを実行して `BytesInPerSec`と を確認します`BytesOutPerSec`。
+ スループットがブローカーごとの制限を超える場合は、 にスケーリング`express.m7g.xlarge`するか、ブローカーを追加することをお勧めします。
+ `ProduceThrottleTime` および `FetchThrottleTime`メトリクスを確認します。

### クライアント設定の監査
<a name="bestpractices-msk-skill-uc-client"></a>

**プロンプト:**「Kafka プロデューサーの設定で MSK のベストプラクティスを確認する」

スキル:
+ 、`linger.ms`、`acks`、 `batch.size`などの重要な設定で`buffer.memory`、パフォーマンスと耐久性に関する考慮事項を確認してください。
+ シナリオのレコメンデーションを提供して、設定の調整、パフォーマンスの向上、高可用性の確保を行います。

### モニタリングとアラームの設定
<a name="bestpractices-msk-skill-uc-monitoring"></a>

**プロンプト:**「ベストプラクティスに従って MSK クラスターの CloudWatch モニタリングを設定する」

スキル:
+ CPU 使用率 (`CpuUser + CpuSystem`)、 などの重要なメトリクスのアラームを作成して`RequestHandlerAvgIdlePercent`、ブローカーの飽和度をモニタリングします。
+ 標準の場合: `KafkaDataLogsDiskUsed > 85%`アラームと`UnderReplicatedPartitions > 0`アラームを追加します。
+ Express の場合: コスト最適化`StorageUsed`のモニタリングを追加します。
+ ブローカーごと、トピックごと、コンシューマーper-consumer-groupダッシュボードを設定します。

## ソースコードと寄稿
<a name="bestpractices-msk-skill-source"></a>

`managing-amazon-msk` スキルはオープンソースです。ソースコードを確認したり、改善を提案したり、新機能を提供したりできます。
+ **GitHub:** GitHub の [aws/agent-toolkit-for-aws](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/analytics-skills/managing-amazon-msk) 

追加のベストプラクティスシナリオ、新しいユースケース、または修正に関するフィードバックは、GitHub の問題またはプルリクエストを通じて歓迎されます。