skilld
All skills
microsoft avatar

/azure-diagnostics

@ae5e585
by microsoftmicrosoft/skills3.1k stars
351

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe triage. WHEN: debug production issues, troubleshoot app service, app service high CPU, app service deployment failure, troubleshoot container apps, troubleshoot functions, troubleshoot AKS, VM RDP, Linux SSH, VM black screen, can't connect to VM, reset VM password, NSG or firewall blocking, kubectl cannot connect, kube-system/CoreDNS failures, pod pending, crashloop, node not ready, upgrade failures, analyze logs, KQL, insights, image pull failures, cold start issues, health probe failures, resource health, root cause of errors, troubleshoot event hubs, troubleshoot service bus, messaging SDK error, AMQP connection failure, message lock lost, service bus dead letter.

Ask your Agent

Use this Skill: https://skilld.dev/gh/microsoft/skills/azure-diagnostics

This session only. Nothing lands on disk.

troubleshootingmessagingazure-servicebus-js.md

≈623 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Azure Service Bus SDK — JavaScript

Package: @azure/service-bus | README | Full Troubleshooting Guide

Common Errors

Error Code Cause Fix
ServiceTimeout Service didn't respond; or no unlocked sessions Transient — auto-retried. Verify state if persists
MessageLockLost Processing exceeded lock duration or link detached Reduce processing time, ensure autolock renewal works
SessionLockLost Session lock expired or link detached Re-accept session, keep renewing lock
QuotaExceeded Too many concurrent receives Reduce receivers or use batch receives
MessageSizeExceeded Message or batch > max size Reduce payload. Premium supports individual messages up to 100MB. Batch limit is computed from max message size on the client, so batches can also be impacted
UnauthorizedAccess Bad credentials Verify connection string, SAS, or RBAC roles

ServiceBusError fields: code, retryable, name, info, address.

Enable Logging

# All SDK logs
export AZURE_LOG_LEVEL=verbose

# Or granular control
export DEBUG=azure*,rhea*

# Errors only
export DEBUG=azure:service-bus:error,azure:core-amqp:error,rhea-promise:error,rhea:events,rhea:frames,rhea:io,rhea:flow

Log to file:

node app.js > out.log 2>debug.log

Key Issues

  • Socket exhaustion: Treat ServiceBusClient as singleton. Each creates a new AMQP connection. Always call close().
  • Lock lost before expiry: Can happen on link detach (transient network issue or 10-min idle timeout). Not always due to processing time.
  • Batch receive returns fewer messages: After first message arrives, receiver waits only 1s for additional messages. maxWaitTimeInMs controls wait for the first message only.
  • Autolock renewal not working: Ensure system clock is accurate. Autolock relies on system time.
  • Batch size limits: Batch limit is artificially computed on the client from the max message size sent by the service. Send large messages individually if batch creation fails.
  • WebSockets: Pass webSocketOptions to ServiceBusClient constructor for port 443 connectivity.
  • Distributed tracing: Experimental OpenTelemetry support via @azure/opentelemetry-instrumentation-azure-sdk.

Source: SKILL.md on GitHub

Third-party checks

1 warning15d4 checks · Risk SAFE
  • Gen Agent Trust Hub15d

    This skill is designed for Azure diagnostics and troubleshooting, providing a comprehensive set of guides and scripts that utilize standard tools like the Azure CLI and kubectl. It includes some security considerations, such as the ingestion of logs which provides a surface for indirect prompt injection, and the use of privileged debug pods for advanced diagnostics. These are used within the skill's intended functionality and are accompanied by appropriate guidance for user approval.

  • Socket15d

    No alerts

  • Snyk15d

    Risk: LOW · No issues

  • Runlayer7mo

    4/4 files flagged

Provenance

Signed by skilld at ae5e585. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last month

Capability

metadata
{
  "author": "Microsoft",
  "version": "1.2.6"
}

Topics

README badge

README badge for microsoft/skills/azure-diagnostics