app-service-worker-observability

Establishes Azure App Service observability baselines for .NET worker and background-service deployments.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/leonardoacosta/skills --skill app-service-worker-observability-leonardoacosta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: app-service-worker-observability
Source: https://github.com/leonardoacosta/skills/tree/main/azure-kit/skills/app-service-worker-observability
Command: npx skills add https://github.com/leonardoacosta/skills --skill app-service-worker-observability-leonardoacosta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Worker and background-service deployments on Azure App Service often fail during startup before Application Insights initializes, leaving no logs to diagnose the failure. This Skill defines a complete, source-controlled observability baseline so failures are captured through both durable centralized telemetry and short-lived filesystem diagnostics. ## Core Features & Use Cases - Six-part observability baseline: Application Insights wiring before hosted services, diagnostic settings to a durable sink, bounded non-production filesystem logging, detailed errors, failed-request tracing, and reversible escalation controls. - Infrastructure as Code templates: Bicep examples for App Service log configuration and diagnostic settings, with platform-aware handling of Windows-only features on Linux or container deployments. - Temporary escalation contract: Source-controlled diagnostic escalation with owner, incident identifier, UTC expiry, bounded retention, and an explicit rollback to off. - Use Case: A .NET 8 BackgroundService on Windows App Service dies intermittently at startup with no Application Insights data. Use this Skill to add early host telemetry wiring, enable bounded filesystem logging in non-production, and verify the failure is captured with correlation data. ## Quick Start Ask the agent to review your App Service worker deployment and produce the application wiring and Bicep changes needed for a complete observability baseline.

Frequently Asked Questions about app-service-worker-observability

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

FAQPage Schema
How do I diagnose App Service worker startup failures before Application Insights initializes?

Enable bounded filesystem application logging in non-production so startup errors are captured independently of the telemetry pipeline. Also wire Application Insights into the host before registering hosted services, and emit a startup event right after the host is built.

How do I configure App Service diagnostic settings in Bicep?

Create a Microsoft.Insights/diagnosticSettings resource scoped to the app that sends AppServiceAppLogs, AppServiceConsoleLogs, and AppServiceHTTPLogs to a Log Analytics workspace. Confirm the categories are supported for your platform and region rather than silently dropping them.

Does failed-request tracing work on Linux App Service?

No. Detailed errors and failed-request tracing are Windows App Service capabilities. On Linux or custom containers, record that constraint and rely on console and application logs plus the durable diagnostic sink instead.

Should I use OpenTelemetry or the Application Insights Worker Service SDK?

Prefer the Azure Monitor OpenTelemetry distribution for new services. An existing service may keep the Application Insights Worker Service SDK if migrating would add unrelated risk; either way, initialize telemetry at host construction.

How do I safely enable verbose App Service logging during an incident?

Express the escalation in reviewed IaC with an incident identifier, named owner, UTC expiry, bounded retention, and a rollback change. Default the mode to off, add a CI check rejecting expired non-off modes, and verify the deployed configuration returns to normal afterward.