💬 コミュニケーションコミュニティ

azure-diagnostics

Azure環境で発生したコンテナアプリの問題を、ログ分析やヘルスチェックなどを通じて切り分け、イメージ取得失敗や起動遅延、ヘルスプローブのエラーといった原因を特定・解決するSkill。

📜 元の英語説明(参考)

Debug and troubleshoot production issues on Azure. Covers Container Apps diagnostics, log analysis with KQL, health checks, and common issue resolution for image pulls, cold starts, and health probes. USE FOR: debug production issues, troubleshoot container apps, analyze logs with KQL, fix image pull failures, resolve cold start issues, investigate health probe failures, check resource health, view application logs, find root cause of errors DO NOT USE FOR: deploying applications (use azure-deploy), creating new resources (use azure-prepare), setting up monitoring (use azure-observability), cost optimization (use azure-cost-optimization)

🇯🇵 日本人クリエイター向け解説

一言でいうと

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux

mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o azure-diagnostics.zip https://jpskill.com/download/19663.zip && unzip -o azure-diagnostics.zip && rm azure-diagnostics.zip

🪟 Windows (PowerShell)

$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/19663.zip -OutFile "$d\azure-diagnostics.zip"; Expand-Archive "$d\azure-diagnostics.zip" -DestinationPath $d -Force; ri "$d\azure-diagnostics.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)

1. 下の青いボタンを押して azure-diagnostics.zip をダウンロード
2. ZIPファイルをダブルクリックで解凍 → azure-diagnostics フォルダができる
3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
4. Claude Code を再起動

⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
- · macOS / Linux: ~/.claude/skills/
- · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →

最終更新: 2026-05-18
取得日時: 2026-05-18
同梱ファイル: 4

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

[スキル名] azure-diagnostics

Azure Diagnostics

権威あるガイダンス — 必須のコンプライアンス

このドキュメントは、Azure の本番環境における問題のデバッグとトラブルシューティングに関する公式情報源です。これらの指示に従って、一般的な Azure サービスの問題を体系的に診断し、解決してください。

トリガー

ユーザーが以下を望む場合に、このスキルをアクティブ化します。

本番環境の問題をデバッグまたはトラブルシューティングする
Azure サービスのエラーを診断する
アプリケーションのログまたはメトリックを分析する
イメージプル、コールドスタート、またはヘルスプローブの問題を修正する
Azure リソースが失敗する理由を調査する
アプリケーションエラーの根本原因を見つける

ルール

体系的な診断フローから開始します
利用可能な場合は、AI を活用した診断のために AppLens (MCP) を使用します
ログを深く掘り下げる前に、リソースの正常性を確認します
サービスタイプに基づいて適切なトラブルシューティングガイドを選択します
発見事項と試行した修復手順を文書化します

クイック診断フロー

症状を特定する - 何が失敗していますか？
リソースの正常性を確認する - Azure は正常ですか？
ログを確認する - ログは何を示していますか？
メトリックを分析する - パフォーマンスパターンはありますか？
最近の変更を調査する - 何が変更されましたか？

サービス別のトラブルシューティングガイド

サービス	一般的な問題	参照
Container Apps	イメージプル失敗、コールドスタート、ヘルスプローブ、ポートの不一致	container-apps/

クイックリファレンス

一般的な診断コマンド

# Check resource health
az resource show --ids RESOURCE_ID

# View activity log
az monitor activity-log list -g RG --max-events 20

# Container Apps logs
az containerapp logs show --name APP -g RG --follow

AppLens (MCP ツール)

AI を活用した診断には、以下を使用します。

mcp_azure_mcp_applens
  intent: "diagnose issues with <resource-name>"
  command: "diagnose"
  parameters:
    resourceId: "<resource-id>"

Provides:
- Automated issue detection
- Root cause analysis
- Remediation recommendations

Azure Monitor (MCP ツール)

ログとメトリックのクエリには、以下を使用します。

mcp_azure_mcp_monitor
  intent: "query logs for <resource-name>"
  command: "logs_query"
  parameters:
    workspaceId: "<workspace-id>"
    query: "<KQL-query>"

一般的な診断クエリについては、kql-queries.md を参照してください。

Azure リソースの正常性を確認する

MCP の使用

mcp_azure_mcp_resourcehealth
  intent: "check health status of <resource-name>"
  command: "get"
  parameters:
    resourceId: "<resource-id>"

CLI の使用

# Check specific resource health
az resource show --ids RESOURCE_ID

# Check recent activity
az monitor activity-log list -g RG --max-events 20

参照

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Azure Diagnostics

AUTHORITATIVE GUIDANCE — MANDATORY COMPLIANCE

This document is the official source for debugging and troubleshooting Azure production issues. Follow these instructions to diagnose and resolve common Azure service problems systematically.

Triggers

Activate this skill when user wants to:

Debug or troubleshoot production issues
Diagnose errors in Azure services
Analyze application logs or metrics
Fix image pull, cold start, or health probe issues
Investigate why Azure resources are failing
Find root cause of application errors

Rules

Start with systematic diagnosis flow
Use AppLens (MCP) for AI-powered diagnostics when available
Check resource health before deep-diving into logs
Select appropriate troubleshooting guide based on service type
Document findings and attempted remediation steps

Quick Diagnosis Flow

Identify symptoms - What's failing?
Check resource health - Is Azure healthy?
Review logs - What do logs show?
Analyze metrics - Performance patterns?
Investigate recent changes - What changed?

Troubleshooting Guides by Service

Service	Common Issues	Reference
Container Apps	Image pull failures, cold starts, health probes, port mismatches	container-apps/

Quick Reference

Common Diagnostic Commands

# Check resource health
az resource show --ids RESOURCE_ID

# View activity log
az monitor activity-log list -g RG --max-events 20

# Container Apps logs
az containerapp logs show --name APP -g RG --follow

AppLens (MCP Tools)

For AI-powered diagnostics, use:

mcp_azure_mcp_applens
  intent: "diagnose issues with <resource-name>"
  command: "diagnose"
  parameters:
    resourceId: "<resource-id>"

Provides:
- Automated issue detection
- Root cause analysis
- Remediation recommendations

Azure Monitor (MCP Tools)

For querying logs and metrics:

mcp_azure_mcp_monitor
  intent: "query logs for <resource-name>"
  command: "logs_query"
  parameters:
    workspaceId: "<workspace-id>"
    query: "<KQL-query>"

See kql-queries.md for common diagnostic queries.

Check Azure Resource Health

Using MCP

mcp_azure_mcp_resourcehealth
  intent: "check health status of <resource-name>"
  command: "get"
  parameters:
    resourceId: "<resource-id>"

Using CLI

# Check specific resource health
az resource show --ids RESOURCE_ID

# Check recent activity
az monitor activity-log list -g RG --max-events 20

References

同梱ファイル

※ ZIPに含まれるファイル一覧。`SKILL.md` 本体に加え、参考資料・サンプル・スクリプトが入っている場合があります。

📄 SKILL.md (3,502 bytes)
📎 references/azure-resource-graph.md (3,002 bytes)
📎 references/container-apps/README.md (2,875 bytes)
📎 references/kql-queries.md (1,342 bytes)