azure-signalr-service について
Azure SignalR Service を扱うエージェント向けのガイダンススキルです。ローカルの参照情報とリモートドキュメント取得を組み合わせ、設定、設計、セキュリティ、デプロイ、問題調査を扱います。
主な機能
- 01接続とメッセージのトラブルシューティング
- 02サービスモードと高可用性設計
- 03容量、性能、スケーリングの指針
- 04IDとネットワークセキュリティの設定
- 05SDK、REST API、デプロイの参考情報
活用シーン
- 01接続やメッセージ配信の障害調査
- 02マルチリージョンまたはシャーディング構成の設計
- 03容量計画とインスタンスのスケーリング
- 04認証、監視、アップストリームエンドポイントの設定
MCP 対応
mcp_microsoftdocs:microsoft_docs_fetch でリモートドキュメントを取得できます。代替手段として fetch_webpage も利用できます。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-signalr-serviceインストール後、Claude Code で/azure-signalr-serviceを入力して読み込まれたか確認します。
詳細
Azure SignalR Service スキル
このスキルでは、Azure SignalR Service に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイを扱います。ローカルのクイックリファレンスコンテンツと、リモートのドキュメント取得機能を組み合わせています。
このスキルの使い方
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-L45 | SignalR の問題の診断と修正:接続やメッセージ配信の問題、ライブトレースと Azure Monitor のログ、よくあるエラーパターン、安定した運用のためのベストプラクティス。 |
| ベストプラクティス | L46-L51 | SignalR アプリサーバーの安全なシャットダウン、クライアントの切断や再接続の検出、処理、復旧など、クライアントのライフサイクルイベントの管理に関するガイダンス。 |
| 意思決定 | L52-L56 | 適切な SignalR Service モード(Default/Serverless/Classic)の選択、高可用性と回復性を実現するための可用性ゾーンとゾーン冗長性の構成に関するガイダンス。 |
| アーキテクチャと設計パターン | L57-L63 | SignalR のスケーリングとシャーディング、回復性に優れたマルチリージョントポロジの設計、Azure SignalR を使用する高可用性・高スループットの ASP.NET Core SignalR アプリの設計パターン。 |
| 制限とクォータ | L64-L70 | メッセージと接続の課金ルール、容量計画、スループット制限、クォータとパフォーマンスの制約内で Azure SignalR インスタンスをスケーリングする方法。 |
| セキュリティ | L71-L92 | Azure SignalR のセキュリティ保護:Entra ID/マネージド ID による認証、キーとローテーション、ネットワーク/プライベートエンドポイント/NSG、WAF、Key Vault へのアクセス、RBAC、テナント間のアクセス、Azure Policy への準拠。 |
| 構成 | L93-L104 | SignalR アプリの構成:接続文字列、アップストリームエンドポイント、カスタムドメイン、監視/メトリック、ネゴシエーションエンドポイント、Functions バインディング、ローカルエミュレーターの使用。 |
| 統合とコーディングパターン | L105-L120 | SignalR とサーバーやゲートウェイを統合するためのパターンと API:SDK の使用、クライアント管理、REST データプレーンのバージョン、Event Grid、API Management、Application Gateway を介したイベントの連携。 |
| デプロイ | L121-L131 | CLI、ARM/Bicep テンプレート、自動スケールの設定、リージョンの移動、エンドツーエンドの Web アプリのデプロイ(GitHub 認証を含む)による Azure SignalR のデプロイと管理。 |
トラブルシューティング
| トピック | URL |
|---|---|
| Azure Monitor リソースログを使用した SignalR のトラブルシューティング | https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-diagnostic-logs |
| Azure SignalR Service の一般的な問題のトラブルシューティング | https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-troubleshoot-guide |
| 診断に Azure SignalR のライブトレースツールを使用する | https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-troubleshoot-live-trace |
| SignalR の接続とメッセージ配信のトラブルシューティング | https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-troubleshoot-method |
| Azure SignalR Service のトラブルシューティングと効果的な使用方法 | https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-resource-faq |
ベストプラクティス
| トピック | URL |
|---|---|
| Azure SignalR アプリサーバーを正常にシャットダウンする | https://learn.microsoft.com/en-us/azure/azure-signalr/server-graceful-shutdown |
| Azure SignalR でクライアントの切断と再接続を処理する | https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-concept-client-disconnections |
意思決定
| トピック | URL |
|---|---|
| 適切な Azure SignalR Service モードを選択する | https://learn.microsoft.com/en-us/azure/azure-signalr/concept-service-mode |
アーキテクチャと設計パターン
| トピック | URL |
|---|---|
| 回復性の高いマルチリージョン Azure SignalR トポロジを設計する | https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-concept-disaster-recovery |
| Azure SignalR を使用して ASP.NET Core SignalR アプリをスケーリングする | https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-concept-scale-aspnet-core |
| 複数のインスタンスとシャーディングを使用して Azure SignalR をスケーリングする | https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-scale-multi-instances |
制限とクォータ
| トピック | URL |
|---|---|
| SignalR の課金におけるメッセージ数と接続数のカウントについて理解する | https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-concept-messages-and-connections |
| Azure SignalR のパフォーマンスと容量を計画する | https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-concept-performance |
| Azure SignalR インスタンスをスケーリングし、スケーリングの制約について理解する | https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-scale-signalr |
セキュリティ
構成
| トピック | URL |
|---|---|
| アプリで Azure SignalR Service の接続文字列を構成する | https://learn.microsoft.com/en-us/azure/azure-signalr/concept-connection-string |
| Azure SignalR でアップストリームエンドポイントとプロトコルを構成する | https://learn.microsoft.com/en-us/azure/azure-signalr/concept-upstream |
| Azure SignalR Service のカスタムドメインを構成する | https://learn.microsoft.com/en-us/azure/azure-signalr/howto-custom-domain |
| Azure Monitor で Azure SignalR の監視を構成する | https://learn.microsoft.com/en-us/azure/azure-signalr/monitor-signalr |
| Azure SignalR の監視メトリックとログのリファレンス | https://learn.microsoft.com/en-us/azure/azure-signalr/monitor-signalr-reference |
| Azure SignalR のクライアントネゴシエーションエンドポイントをカスタマイズする | https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-concept-client-negotiation |
| SignalR バインドを使用して Azure Functions アプリを開発・構成する | https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-concept-serverless-development-config |
| サーバーレス開発に Azure SignalR Local Emulator を使用する | https://learn.microsoft.com/en-us/azure/azure-signalr/signalr-howto-emulator |