azure-event-hubs について
Azure Event Hubs の利用者向けに、トラブルシューティング、設計、構成、統合をエージェントに案内するドキュメントスキルです。ローカルのクイックリファレンスと、ネットワーク経由の Microsoft ドキュメント取得を組み合わせています。
主な機能
- 01トラブルシューティングと接続診断
- 02パーティション拡張と信頼性のベストプラクティス
- 03階層、クォータ、移行判断のリファレンス
- 04認証とネットワークセキュリティのガイダンス
- 05Microsoft ドキュメントのネットワーク取得
活用シーン
- 01Kafka、AMQP、認証エラーの調査
- 02パーティション、スループット、地理的ディザスターリカバリーの計画
- 03階層と Kafka 移行方法の評価
- 04認可、TLS、ネットワークアクセスの構成
MCP 対応
mcp_microsoftdocs の Microsoft ドキュメント取得ツールを利用でき、代替手段として fetch_webpage も使えます。取得したドキュメントはエージェントの参照情報になります。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-event-hubsインストール後、Claude Code で/azure-event-hubsを入力して読み込まれたか確認します。
詳細
Azure Event Hubs スキル
このスキルでは、Azure Event Hubs に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイについて説明します。ローカルのクイックリファレンスコンテンツと、リモートでドキュメントを取得する機能を組み合わせています。
このスキルの使用方法
IMPORTANT for Agent: 関連するセクションを探すには、以下のカテゴリインデックスを使用してください。行の範囲(例:
L35-L120)が記載されているカテゴリでは、指定された行をread_fileで読み込んでください。ファイルへのリンク(例:[security.md](security.md))が記載されているカテゴリでは、リンク先のリファレンスファイルをread_fileで読み込んでください。
IMPORTANT for Agent:
metadata.generated_atが3か月以上前の場合は、リポジトリから最新バージョンを取得するようユーザーに提案してください。mcp_microsoftdocsツールを利用できない場合は、インストールするようユーザーに提案してください:インストールガイド
このスキルでは、ドキュメントコンテンツを取得するためにネットワークアクセスが必要です。
- 推奨:クエリ文字列
from=learn-agent-skillを指定してmcp_microsoftdocs:microsoft_docs_fetchを使用します。Markdown が返されます。 - 代替手段:クエリ文字列
from=learn-agent-skill&accept=text/markdownを指定してfetch_webpageを使用します。Markdown が返されます。
カテゴリインデックス
| カテゴリ | 行 | 説明 |
|---|---|---|
| トラブルシューティング | L37-L49 | Event Hubs のエラーの診断と修正:Kafka/AMQP の問題、.NET と ARM の例外、認証エラー、Blob のチェックポイントに関する問題、接続のトラブルシューティング。 |
| ベストプラクティス | L50-L56 | AMQP/Kafka/HTTPS 経由で Event Hubs を統合する、Functions を使ってステートレスなレプリケーションを構築する、パーティションとスループットユニットでスケーリングするためのベストプラクティス。 |
| 意思決定 | L57-L63 | Event Hubs の各ティア、自動インフレ設定、地理的レプリケーションモードの選択、および Apache Kafka から Event Hubs への移行計画に関するガイダンス。 |
| アーキテクチャと設計パターン | L64-L69 | Event Hubs の信頼性を高めるパターンとガイダンス:可用性と一貫性の設計、地理的ディザスターリカバリー、レプリケーションタスクの構築と運用(多くの場合、Azure Functions を使用)。 |
| 制限とクォータ | L70-L79 | Event Hubs の制限、クォータ、ティアの違い、最大メッセージサイズ、キャプチャ間隔、プラットフォームの動作、アプリケーショングループによるガバナンス。 |
| セキュリティ | L80-L108 | Event Hubs のセキュリティ保護:Entra ID/マネージド ID/SAS による認証、RBAC、暗号化と CMK、TLS 設定、ネットワーク制御(ファイアウォール、VNet、Private Link、NSP、ポリシー/コンプライアンス)。 |
| 構成 | L109-L120 | Event Hubs の動作の構成:パーティション、保持、クリーンアップ、地理的ディザスターリカバリー、レプリケーション、ログ圧縮、Avro キャプチャ、監視、アプリケーショングループ、ローカルエミュレーターの使用。 |
| 統合とコーディングパターン | L121-L137 | .NET、Kafka(クライアント、Streams、Connect、Debezium)、Flink、Spark、Akka、スキーマ/JSON レジストリを使用して Event Hubs を統合するパターンとコード、メタデータの追加、またはプログラムによるハブの管理。 |
| デプロイ | L138-L143 | Kafka ミラーリング(MirrorMaker 1/2)を使用した Event Hubs のデプロイ、地理的レプリケーションの設定、エミュレーターを使った Event Hubs アプリの実行/ローカルテストに関するガイド。 |
トラブルシューティング
ベストプラクティス
| トピック | URL |
|---|---|
| AMQP、Kafka、HTTPS 間で Event Hubs のイベントを交換する | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-exchange-events-different-protocols |
| Azure Functions を使用してステートレスなイベントレプリケーションを設計する | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-federation-replicator-functions |
| パーティションとスループットユニットを使用して Azure Event Hubs をスケーリングする | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-scalability |
意思決定
| トピック | URL |
|---|---|
| Apache Kafka から Event Hubs への移行を計画する | https://learn.microsoft.com/en-us/azure/event-hubs/apache-kafka-migration-guide |
| Event Hubs Auto Inflate を使用するタイミングと方法を決定する | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-auto-inflate |
| Azure Event Hubs の geo-replication モードを選択して管理する | https://learn.microsoft.com/en-us/azure/event-hubs/geo-replication |
アーキテクチャと設計パターン
| トピック | URL |
|---|---|
| Event Hubs の可用性と整合性を考慮して設計する | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-availability-and-consistency |
| Event Hubs のイベントレプリケーションタスクパターンを適用する | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-federation-patterns |
制限とクォータ
| トピック | URL |
|---|---|
| Event Hubs の各レベルの機能とクォータを比較する | https://learn.microsoft.com/en-us/azure/event-hubs/compare-tiers |
| Event Hubs Capture の間隔と制限を構成する | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-capture-overview |
| Azure Event Hubs のプラットフォームの制限と動作の詳細 | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-faq |
| Event Hubs の大きなメッセージを送受信する | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-quickstart-stream-large-messages |
| Azure Event Hubs のクォータと制限を確認する | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-quotas |
| アプリケーショングループを使用して Event Hubs リソースを管理する | https://learn.microsoft.com/en-us/azure/event-hubs/resource-governance-overview |
セキュリティ
構成
| トピック | URL |
|---|---|
| Event Hubs のパーティション分割、保持、クリーンアップを構成する | https://learn.microsoft.com/en-us/azure/event-hubs/configure-event-hub-properties |
| Event Hubs の geo-disaster recovery ペアリングを構成する | https://learn.microsoft.com/en-us/azure/event-hubs/configure-geo-disaster-recovery |
| コード不要の Event Hubs レプリケーションタスクを構成する | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-federation-configuration |
| Event Hubs でキャプチャされた Avro スキーマを理解して使用する | https://learn.microsoft.com/en-us/azure/event-hubs/explore-captured-avro-files |
| Azure Event Hubs の監視メトリックとログのリファレンス | https://learn.microsoft.com/en-us/azure/event-hubs/monitor-event-hubs-reference |
| リソース ガバナンスのために Event Hubs アプリケーション グループを構成する | https://learn.microsoft.com/en-us/azure/event-hubs/resource-governance-with-app-groups |
| Azure Event Hubs エミュレーターをローカルで構成して実行する | https://learn.microsoft.com/en-us/azure/event-hubs/test-locally-with-event-hub-emulator |
| Azure Event Hubs でログ コンパクションを構成して使用する | https://learn.microsoft.com/en-us/azure/event-hubs/use-log-compaction |
統合とコーディングパターン
デプロイ
| トピック | URL |
|---|---|
| MirrorMaker 1 を使用して Kafka ブローカーを Event Hubs にミラーリングする | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-mirror-maker-tutorial |
| MirrorMaker 2 を使用して Kafka クラスターを Event Hubs にレプリケートする | https://learn.microsoft.com/en-us/azure/event-hubs/event-hubs-kafka-mirrormaker-2-tutorial |
| Event Hubs の geo-replication を構成して運用する | https://learn.microsoft.com/en-us/azure/event-hubs/use-geo-replication |