Azure Observability Workflows
Published by composio-community in opencode-skills
What this skill does
Workflow for implementing observability systems on Microsoft Azure using logging, monitoring, tracing, telemetry, metrics, dashboards, and production-grade cloud diagnostics.
Add Azure Observability Workflows to your agent
Review the source and files first. When you are ready, copy the prompt instruction or use the CLI command supported by your environment.
Install with a prompt
Paste this into a compatible coding agent:
add this skill "azure-observability-workflows" from https://github.com/composio-community/opencode-skillsInstall with the CLI
Run this command in a controlled environment after reviewing the repository:
npx skills add https://github.com/composio-community/opencode-skills --skill azure-observability-workflowsSkill instructions
Azure Observability Workflows
Overview
This skill enables Claude to design and implement observability systems for applications running on Microsoft Azure.
The workflow focuses on:
- distributed tracing
- centralized logging
- metrics collection
- cloud monitoring
- telemetry pipelines
- incident diagnostics
- alerting systems
- production visibility
The goal is to make cloud systems:
- observable
- debuggable
- measurable
- reliable
- production-ready
Instead of reacting to failures after they happen, observability systems should proactively surface:
- bottlenecks
- errors
- degraded performance
- unusual system behavior
- infrastructure instability
This workflow prioritizes operational visibility and debugging quality across distributed systems.
Setup
Before starting:
-
Create an Azure account: https://azure.microsoft.com
-
Install Azure CLI:
az login
- Enable Azure monitoring services.
Recommended Azure services:
- Azure Monitor
- Application Insights
- Log Analytics
- Azure Dashboard
- Azure Alerts
Recommended tools:
- VS Code
- Azure Portal
- Grafana
- OpenTelemetry
- Docker
- Kubernetes (optional)
Optional:
- Prometheus
- Jaeger
- Azure Managed Grafana
- Distributed tracing systems
Inputs Required
- Application architecture
- Cloud infrastructure
- Deployment environment
- Service dependencies
- Monitoring objectives
Optional:
- Existing telemetry systems
- Logging pipelines
- Kubernetes clusters
- Incident history
When to Use This Skill
Use this skill when:
- deploying production applications
- debugging distributed systems
- monitoring cloud infrastructure
- tracking application performance
- diagnosing incidents
- implementing SRE workflows
- scaling microservices
- improving operational reliability
When NOT to Use
Do NOT use this skill for:
- disposable prototypes
- tiny local-only applications
- systems with no production requirements
- workflows without operational monitoring needs
Example Use Case
Build observability infrastructure for a distributed Azure microservices platform.
Claude should:
- Configure telemetry pipelines
- Enable distributed tracing
- Centralize logs
- Create monitoring dashboards
- Configure alerts
- Track infrastructure health
- Diagnose failures proactively
Final result should:
- improve debugging speed
- surface production issues quickly
- increase operational visibility
- support scalable cloud monitoring
- improve reliability and uptime
Core Observability Principles
1. Logs Alone Are Not Enough
Modern observability requires:
- logs
- metrics
- traces
- telemetry
- distributed context
Claude should combine:
- application logs
- infrastructure metrics
- request traces
- dependency monitoring
Good observability systems provide:
- visibility
- diagnostics
- operational understanding
2. Distributed Systems Require Distributed Tracing
Microservices introduce:
- request chains
- async communication
- hidden bottlenecks
- cross-service failures
Claude should implement:
- trace correlation
- request IDs
- distributed spans
- dependency tracking
Distributed tracing improves:
- debugging speed
- bottleneck detection
- root-cause analysis
3. Centralize Monitoring
Observability data should remain centralized.
Recommended systems:
- Azure Monitor
- Application Insights
- Log Analytics
- Grafana dashboards
Centralization improves:
- debugging
- incident response
- operational visibility
Avoid:
- fragmented logging systems
- isolated metrics
- disconnected dashboards
4. Monitor What Matters
Not all metrics are equally valuable.
Claude should prioritize:
- latency
- error rates
- throughput
- resource utilization
- request failures
- dependency health
Avoid:
- noisy dashboards
- vanity metrics
- excessive telemetry without purpose
Good monitoring improves:
- reliability
- scaling decisions
- incident detection
5. Alerts Should Be Actionable
Bad alerting systems create:
- alert fatigue
- ignored notifications
- operational chaos
Claude should configure alerts for:
- real incidents
- meaningful thresholds
- actionable failures
- production-impacting issues
Good alerts improve:
- operational response
- uptime
- debugging speed
Workflow
1. Analyze System Architecture
Start by identifying:
- services
- APIs
- databases
- queues
- infrastructure dependencies
Determine:
- critical workflows
- failure points
- performance bottlenecks
- observability gaps
Understand:
- request flow
- service boundaries
- scaling behavior
2. Configure Telemetry Collection
Enable:
- application logging
- infrastructure metrics
- distributed traces
- dependency monitoring
Use:
- Application Insights
- Azure Monitor
- OpenTelemetry
Validate:
- telemetry consistency
- trace propagation
- correlation IDs
3. Centralize Logs & Metrics
Route:
- logs
- traces
- metrics
- diagnostics
into centralized systems.
Recommended:
- Log Analytics
- Azure Monitor
- Grafana
Ensure:
- searchable logs
- structured telemetry
- consistent formatting
4. Implement Distributed Tracing
Track:
- requests
- service dependencies
- API calls
- async workflows
Use:
- trace IDs
- span relationships
- request correlation
Distributed tracing improves:
- debugging
- latency analysis
- dependency visibility
5. Create Dashboards
Build dashboards for:
- infrastructure health
- application performance
- error tracking
- queue processing
- API latency
- service dependencies
Dashboards should remain:
- readable
- actionable
- operationally useful
Avoid:
- cluttered dashboards
- excessive graphs
- irrelevant metrics
6. Configure Alerts
Create alerts for:
- service downtime
- latency spikes
- high failure rates
- queue backlogs
- resource exhaustion
Alerts should:
- reduce noise
- remain actionable
- trigger appropriate escalation
7. Validate Production Observability
Before deployment validate:
- logs are searchable
- traces propagate correctly
- metrics update consistently
- alerts trigger correctly
- dashboards remain readable
Ensure:
- incidents can be diagnosed quickly
- telemetry remains reliable
- systems stay observable under load
Output Expectations
The final output should include:
- centralized observability systems
- distributed tracing pipelines
- actionable monitoring dashboards
- production telemetry systems
- scalable diagnostics infrastructure
- cloud-native operational visibility
The workflow itself should remain:
- scalable
- observable
- production-focused
- debugging-friendly
- operationally reliable
Execution Strategy (for AI agents)
The agent should:
- Treat observability as foundational infrastructure
- Centralize telemetry aggressively
- Implement distributed tracing consistently
- Prioritize actionable monitoring
- Reduce alert noise proactively
- Optimize for operational visibility and debugging quality
The workflow should optimize for:
- reliability
- debugging speed
- operational clarity
- incident response quality
- cloud scalability
Best Practices
- Use structured logging consistently
- Implement distributed tracing early
- Centralize metrics and logs
- Monitor latency and error rates closely
- Keep dashboards actionable
- Avoid alert fatigue
- Validate observability under production load
Notes
- Distributed tracing dramatically improves debugging in microservices
- Observability quality strongly affects operational reliability
- Actionable dashboards outperform noisy telemetry systems
- Good alerting reduces operational burnout significantly
- Observability systems should evolve continuously with infrastructure growth
Files included
- SKILL.md

