View a markdown version of this page

managing-amazon-msk スキルを使用してベストプラクティスを分析する - Amazon Managed Streaming for Apache Kafka

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

managing-amazon-msk スキルを使用してベストプラクティスを分析する

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

機能

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

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

仕組み

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

  • ベストプラクティスの検証 — 文書化された推奨事項に照らしてクラスター設定をチェックし、偏差にフラグを立てます。

インストール

オプション 1: AWS CLI

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 を使用したスキルの管理」を参照してください。

オプション 2: AWS MCP サーバー

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 サーバーのセットアップ」を参照してください。

ユースケースと例

標準ブローカーのベストプラクティスを評価する

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

スキル:

  • m5.2xlarge のブローカーあたり 2,000 パーティションの推奨制限に対してパーティション数を確認します。

  • 推奨数を超え、更新オペレーションをサポートする最大 3,000 個に近づいていることを警告します。

  • パーティションを減らすか、m5.4xlarge (ブローカーあたり 4,000 パーティションをサポート) にアップグレードすることをお勧めします。

  • num.io.threadsnum.network.threadsの設定を確認し、サイズが小さい場合はチューニングをお勧めします。

Express ブローカーのパフォーマンスを診断する

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

スキル:

  • ブローカーごとに 15.6 MBps の進入と 31.2 MBps の進入express.m7g.largeをサポートする を特定します。

  • 現在のスループットについて質問するか、CloudWatch クエリを実行して BytesInPerSecと を確認しますBytesOutPerSec

  • スループットがブローカーごとの制限を超える場合は、 にスケーリングexpress.m7g.xlargeするか、ブローカーを追加することをお勧めします。

  • ProduceThrottleTime および FetchThrottleTimeメトリクスを確認します。

クライアント設定の監査

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

スキル:

  • linger.msacksbatch.sizeなどの重要な設定でbuffer.memory、パフォーマンスと耐久性に関する考慮事項を確認してください。

  • シナリオのレコメンデーションを提供して、設定の調整、パフォーマンスの向上、高可用性の確保を行います。

モニタリングとアラームの設定

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

スキル:

  • CPU 使用率 (CpuUser + CpuSystem)、 などの重要なメトリクスのアラームを作成してRequestHandlerAvgIdlePercent、ブローカーの飽和度をモニタリングします。

  • 標準の場合: KafkaDataLogsDiskUsed > 85%アラームとUnderReplicatedPartitions > 0アラームを追加します。

  • Express の場合: コスト最適化StorageUsedのモニタリングを追加します。

  • ブローカーごと、トピックごと、コンシューマーper-consumer-groupダッシュボードを設定します。

ソースコードと寄稿

managing-amazon-msk スキルはオープンソースです。ソースコードを確認したり、改善を提案したり、新機能を提供したりできます。

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