Agentskillz Logo

microsoft/azure-skills / azure-diagnostics

azure-diagnostics

Установки
554,288
Автор
microsoft/azure-skills
Источник
github.com/microsoft/azure-skills

Скилл для системной диагностики и устранения проблем Azure в продакшене: от App Service, Functions и AKS до виртуальных машин и очередей сообщений. Использует AppLens, Azure Monitor и проверку ресурсов, чтобы быстро находить первопричины сбоев, анализировать логи и предлагать шаги по восстановлению.

Установить скилл

npx skills add https://github.com/microsoft/azure-skills --skill azure-diagnostics

Аудит безопасности

Gen Agent Trust Hub

pass

This diagnostic skill provides comprehensive troubleshooting guidance for Azure services, including AKS, App Service, and messaging platforms. It follows Microsoft security best practices, emphasizing managed identities and systematic investigation through official tooling.

Audited: 5/19/2026, 10:13:24 PM

Socket

pass

No alerts

Audited: 5/19/2026, 10:16:16 PM

Snyk

warn

Risk: MEDIUM · 1 issue

Audited: 5/19/2026, 10:13:05 PM

ZeroLeaks

warn

1 finding · Score: 69/100

Audited: 4/15/2026, 10:03:08 PM

Промпт скилла

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
  • Troubleshoot App Service issues (high CPU, deployment failures, crashes, slow responses, TLS/custom domains)
  • Respond to prompts like "troubleshoot app service", "app service high CPU", or "app service deployment failure"
  • Troubleshoot Azure Function Apps (invocation failures, timeouts, binding errors)
  • Find the App Insights or Log Analytics workspace linked to a Function App
  • Troubleshoot AKS clusters, nodes, pods, ingress, or Kubernetes networking issues
  • Troubleshoot Azure VM connectivity issues (RDP/SSH failures, port 3389/22 timeouts, NSG or firewall blocking, credential resets)
  • Troubleshoot Azure Messaging SDK issues (Event Hubs, Service Bus connection failures, AMQP errors, message lock issues)

Rules

  1. Start with systematic diagnosis flow
  2. Use AppLens (MCP) for AI-powered diagnostics when available
  3. Check resource health before deep-diving into logs
  4. Select appropriate troubleshooting guide based on service type
  5. Document findings and attempted remediation steps
  6. Route AKS incidents to the dedicated AKS troubleshooting document

Quick Diagnosis Flow

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

Troubleshooting Guides by Service

ServiceCommon IssuesReference
Container AppsImage pull failures, cold starts, health probes, port mismatchescontainer-apps/
App ServiceHigh CPU, deployment failures, crashes, slow responses, TLS/custom domainsapp-service/
Function AppsApp details, invocation failures, timeouts, binding errors, cold starts, missing app settingsfunctions/
AKSCluster access, nodes, kube-system, scheduling, crash loops, ingress, DNS, upgradesAKS Troubleshooting
ComputeVM RDP/SSH connectivity, NSG/firewall blocks, credential resets, VM agent/tooling issuesVM Connectivity Troubleshooting
MessagingEvent Hubs & Service Bus SDK errors, AMQP failures, message lock, connectivityMessaging Troubleshooting

Routing

  • Keep Container Apps and Function Apps diagnostics in this parent skill.
  • Route active AKS incidents, AKS-specific intake, evidence gathering, and remediation guidance to AKS Troubleshooting.
  • Route Azure VM RDP/SSH connectivity, NSG/firewall, credential reset, and VM agent troubleshooting to VM Connectivity Troubleshooting.
  • Route Azure Messaging SDK troubleshooting (Event Hubs, Service Bus) to Messaging Troubleshooting.

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
# Function App logs (query App Insights traces)
az monitor app-insights query --apps APP-INSIGHTS -g RG \
  --analytics-query "traces | where timestamp > ago(1h) | order by timestamp desc | take 50"

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

Все файлы скилла

Другие скиллы автора

azure-prepare

553,704 установок

microsoft/azure-skills

Скилл готовит проекты к развёртыванию в Azure: анализирует кодовую базу, выбирает подходящий сценарий (Bicep, Terraform или AZD) и создаёт всю необходимую инфраструктуру — план развёртывания, конфигурационные файлы и Dockerfile. Автоматизирует подготовительный этап, чтобы последующая валидация и деплой прошли без ошибок.

azure-ai

553,621 установок

microsoft/azure-skills

Скилл для работы с сервисами Azure AI: поиск (включая векторный и гибридный), распознавание и синтез речи, транскрибация, OCR и документы. Помогает быстро выполнять задачи через MCP-инструменты или подсказывает нужные SDK-примеры для Python, TypeScript и .NET. Ускоряет интеграцию с Azure AI Search, Speech, OpenAI и Document Intelligence.

azure-deploy

553,594 установок

microsoft/azure-skills

Навык автоматизирует развертывание уже подготовленных приложений в Azure с помощью azd, terraform и az deployment. Он проверяет готовность плана, выполняет деплой, обрабатывает ошибки и подтверждает успешный запуск, возвращая ссылки на ресурсы. Полезен для надежного и повторяемого деплоя без ручных шагов.

azure-validate

553,079 установок

microsoft/azure-skills

Проверяет готовность Azure-окружения к развертыванию: конфигурацию, Bicep/Terraform-шаблоны, роли RBAC и разрешения managed identity. Позволяет выявить проблемы до деплоя, сэкономить время и избежать сбоев.

azure-storage

552,529 установок

microsoft/azure-skills

Скилл для работы с Azure Storage: управление блоб-хранилищем, файловыми ресурсами, очередями и таблицами. Помогает выбирать уровни доступа (hot/cool/cold/archive) и варианты избыточности, а также выполнять операции через CLI или MCP. Полезен для загрузки, скачивания и перечисления объектов в облаке Azure.

entra-app-registration

552,269 установок

microsoft/azure-skills

Скилл помогает регистрировать приложения в Microsoft Entra ID, настраивать OAuth 2.0 и подключать MSAL для аутентификации пользователей и сервисов. Охватывает создание app registration, настройку API-разрешений, клиентских секретов и сертификатов, а также лучшие практики безопасности. Удобен для быстрой настройки аутентификации в веб-, мобильных и фоновых приложениях.

appinsights-instrumentation

552,016 установок

microsoft/azure-skills

Скилл предоставляет руководство по инструментированию веб-приложений с помощью Azure Application Insights: описывает паттерны телеметрии, настройку SDK и конфигурацию. Помогает разработчикам добавлять мониторинг в приложения, а также разграничивает случаи, когда следует использовать azure-prepare для внесения изменений в проект.

azure-resource-lookup

551,937 установок

microsoft/azure-skills

Находит и перечисляет ресурсы Azure любого типа по подпискам и группам ресурсов через Azure Resource Graph. Помогает отвечать на вопросы «что у меня есть», искать ресурсы по тегам, обнаруживать осиротевшие диски и неиспользуемые IP-адреса. Используется, когда нет выделенного MCP-инструмента для нужного типа ресурсов.

azure-resource-visualizer

551,932 установок

microsoft/azure-skills

Анализирует группы ресурсов Azure и создает подробные диаграммы архитектуры в формате Mermaid. Помогает визуализировать взаимосвязи между ресурсами, группировать их по слоям и документировать инфраструктуру. Полезен для понимания структуры облачных решений и создания наглядной документации.

azure-compliance

551,896 установок

microsoft/azure-skills

Проводит аудит безопасности и соответствия Azure: оценивает ресурсы по лучшим практикам, находит неверно настроенные и потерянные ресурсы, а также проверяет ключи, секреты и сертификаты Key Vault на истечение срока действия. Помогает выявлять критические риски и планировать их устранение.

azure-aigateway

551,722 установок

microsoft/azure-skills

Настраивает Azure API Management как AI-шлюз для управления моделями, MCP-инструментами и агентами. Включает семантическое кэширование, лимиты токенов, контроль безопасности, балансировку нагрузки и мониторинг. Помогает централизованно управлять доступом к AI-сервисам и снижать расходы.

azure-kusto

551,647 установок

microsoft/azure-skills

Помогает работать с Azure Data Explorer (Kusto): выполнять KQL-запросы, исследовать схему таблиц, анализировать логи, телеметрию и временные ряды. Полезен для поиска аномалий, агре

azure-messaging

541,378 установок

microsoft/azure-skills

Навык для диагностики и устранения неполадок в Azure Messaging SDK (Event Hubs, Service Bus). Помогает решать проблемы с подключением, аутентификацией, обработкой сообщений и конфигурацией. Использует инструменты MCP для проверки состояния ресурсов, поиска документации и анализа ошибок.

azure-compute

495,407 установок

microsoft/azure-skills

Помогает подбирать, сравнивать и создавать виртуальные машины и масштабируемые наборы в Azure, а также оценивать их стоимость. Разбирается в сценариях резервирования мощности, автомасштабирования и управления машинами, направляя запрос к нужному рабочему процессу.

azure-rbac

486,709 установок

microsoft/azure-skills

Помогает подобрать роль Azure RBAC с минимальными правами для идентичности, сгенерировать команды CLI и код Bicep для её назначения. Также подскажет, какие разрешения нужны, чтобы выдать доступ другому пользователю или сервису.

azure-cloud-migrate

485,404 установок

microsoft/azure-skills

Помогает оценить и перенести существующие облачные нагрузки в Azure: конвертирует код и конфигурацию, формирует отчёт о миграции. Поддерживает переезд AWS Lambda, Elastic Beanstalk, Heroku, Google App Engine, Kubernetes, Cloud Run и Spring Boot в Azure Functions, App Service и Container Apps.

azure-hosted-copilot-sdk

438,545 установок

microsoft/azure-skills

Скилл автоматизирует сборку, развертывание и доработку приложений на GitHub Copilot SDK в Azure: определяет наличие SDK в коде, создаёт инфраструктуру, настраивает модели (включая BYOM) и запускает деплой. Полезен, когда нужно быстро подготовить или модифицировать Copilot-приложение без ручной настройки Azure.

azure-quotas

421,637 установок

microsoft/azure-skills

Помогает проверять и управлять квотами Azure: лимитами ресурсов, текущим использованием и доступной ёмкостью в регионах. Позволяет планировать развёртывание, сравнивать регионы по доступности квот, запрашивать увеличение лимитов и избегать ошибок превышения. Использует Azure CLI для точных данных.

azure-upgrade

413,773 установок

microsoft/azure-skills

Навык для оценки и автоматизации обновления Azure-ресурсов: планов, SKU, тарифов, а также модернизации Azure SDK в коде. Поддерживает сценарии: обновление Azure Functions (Consumption→Flex), миграцию App Service на Container Apps, обновление Java SDK (com.microsoft.azure→com.azure) и миграцию Azure Cache

azure-enterprise-infra-planner

388,208 установок

microsoft/azure-skills

Навык проектирует корпоративную инфраструктуру Azure: сети, безопасность, identity, мультирегиональные сценарии. Генерирует код Bicep или Terraform, проверяет его на соответствие лучшим практикам и безопасность, затем разворачивает с подтверждением. Помогает архитекторам и инженерам быстро создавать надёжные облачные решения.

azure-kubernetes

381,128 установок

microsoft/azure-skills

Навык помогает планировать и создавать кластеры Azure Kubernetes Service (AKS): выбирать SKU, проектировать сеть, настраивать безопасность, наблюдаемость, обновления и оптимизацию затрат. Различает решения Day-0 (сеть, API-сервер) и Day-1 (автомасштабирование, VPA, Spot-пулы), предоставляет чек-листы и сценарии для глубокой настройки.

azure-cost

356,363 установок

microsoft/azure-skills

Навык для управления затратами в Azure: позволяет запрашивать исторические данные о расходах, прогнозировать будущие затраты и получать рекомендации по оптимизации. Помогает анализировать затраты по подпискам, группам ресурсов и другим областям, а также выявлять возможности для сокращения расходов.

airunway-aks-setup

300,339 установок

microsoft/azure-skills

Скилл помогает развернуть AI Runway на кластере AKS: проверяет готовность кластера, устанавливает контроллер, выбирает провайдера инференса и запускает модель. Пошагово проводит от начальной настройки до первого развертывания, с проверкой статуса на каждом этапе.