skills.rest
stephschofield
stephschofieldCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

azure-diagnostics

Diagnose Azure Container Apps and Function Apps issues using KQL log queries and health checks.

Updated Jan 23, 2026
Search Tags:#troubleshooting#azure#log analysis#diagnostics#kql#container apps#function apps
One-click install
npx skills add https://github.com/stephschofield/beth --skill azure-diagnostics-stephschofield
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: azure-diagnostics
Source: https://github.com/stephschofield/beth/tree/main/.github/skills/azure-diagnostics
Command: npx skills add https://github.com/stephschofield/beth --skill azure-diagnostics-stephschofield

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Production issues on Azure—image pull failures, cold starts, health probe failures, and function invocation errors—are hard to root-cause without a systematic diagnostic process and the right log queries. ## Core Features & Use Cases - Systematic Diagnosis Flow: Guides you through symptom identification, resource health checks, log review, and metric analysis before remediation. - Service-Specific Troubleshooting: Provides targeted guides for Container Apps (image pulls, port mismatches, probes) and Function Apps (invocation failures, missing app settings, App Insights linkage). - KQL Query Library: Supplies ready-to-use Kusto queries for errors, failed requests, slow requests, and dependency failures in Application Insights and Log Analytics. - Use Case: Your Function App stops logging after a deployment. Use this Skill to locate the linked App Insights resource via Azure Resource Graph, query traces with KQL, and correlate errors with recent deployment history. ## Quick Start Ask the agent to diagnose why your Azure Function App is failing and have it check resource health and query recent error logs.

Frequently Asked Questions about azure-diagnostics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot Azure Function App invocation failures?▼

Start by checking resource health, then query the linked App Insights traces table with KQL for recent errors. Verify the APPLICATIONINSIGHTS_CONNECTION_STRING app setting matches the App Insights instance and correlate failures with recent deployments.

How do I find the App Insights linked to a Function App?▼

Use an Azure Resource Graph query joining microsoft.web/sites with microsoft.insights/components on resource group to get the instrumentation key and workspace ID. A CLI fallback reads the APPLICATIONINSIGHTS_CONNECTION_STRING app setting and looks up the component.

Why does my Azure Container App keep restarting?▼

Restarts usually indicate a failing health probe or port mismatch. Check the ingress targetPort matches the port your app listens on, verify the /health endpoint returns 200, and inspect system logs with az containerapp logs show --type system.

How do I fix image pull failures in Azure Container Apps?▼

Check the registry configuration with az containerapp show, then set ACR credentials using az containerapp registry set --identity system. If ACR Tasks is disabled on free subscriptions, build the image locally with Docker and push it manually.

Can I query Function App logs without a Log Analytics workspace?▼

Yes, classic App Insights without a linked workspace still supports traces, requests, and exceptions tables via az monitor app-insights query. The FunctionAppLogs table is unavailable in that case; az webapp log tail can stream live logs as a last resort.

When should I not use this diagnostics skill?▼

Do not use it for deploying applications, creating new Azure resources, or cost optimization. It is scoped to debugging and troubleshooting existing production resources, not provisioning or deployment workflows.

Related Skills

Explore More Software Engineering Skills→
microsoftmicrosoft
3.0k

appinsights-instrumentation

Guides instrumentation of web applications with Azure Application Insights telemetry.

Official
Intermediate
koyebkoyeb
4

deploy

Automate Koyeb service and app deployments using the Koyeb CLI.

Official
Intermediate
mahmoud20138mahmoud20138
10

azure-observability

Monitor Azure resources and applications using Azure Monitor, Application Insights, and Log Analytics.

Community
Intermediate
sohamdasohamda

azure-diagnostics

Diagnose and troubleshoot Azure Container Apps and Function Apps using KQL queries and health checks.

Community
Advanced