azure-monitor

name	azure-monitor
description	Expert knowledge for Azure Monitor development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when configuring Log Analytics, Application Insights, DCRs/agents, Prometheus/Grafana, or Azure Monitor alerts, and other Azure Monitor related development tasks. Not for Azure Network Watcher (use azure-network-watcher), Azure Service Health (use azure-service-health), Azure Defender For Cloud (use azure-defender-for-cloud), Azure Security (use azure-security).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-04-19","generator":"docs2skills/1.0.0"}

Azure Monitor Skill

This skill provides expert guidance for Azure Monitor. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

• Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
• Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category	Location	Description
Troubleshooting	L37-L86	Diagnosing and fixing Azure Monitor issues: agent/extension health, data collection and ingestion failures, alerts/ITSM, Application Insights, containers/Prometheus, workbooks, and VM performance.
Best Practices	L87-L123	Best practices for configuring, scaling, querying, and optimizing Azure Monitor (logs, metrics, alerts, autoscale, AKS/VMs, Prometheus, multicloud) for performance, reliability, and cost.
Decision Making	L124-L161	Guidance for choosing Azure Monitor options and planning migrations (agents, alerts, metrics, logs, SCOM, Prometheus, Splunk), plus cost, billing, and visualization decisions.
Architecture & Design Patterns	L162-L169	Designing Azure Monitor architectures: enterprise-wide layouts, Private Link network patterns, choosing single vs multiple workspaces, and using workspace replication for resilience.
Limits & Quotas	L170-L237	Limits, performance, and scaling behavior for Azure Monitor logs, metrics, agents, autoscale, Prometheus, Container Insights, Workbooks, and per‑resource metric definitions.
Security	L238-L293	Securing Azure Monitor: auth (Entra, RBAC, keys), network (NSP, firewalls, Private Link, TLS), ITSM/webhooks, Container/Prometheus/Grafana access, and security/audit log schemas and analysis.
Configuration	configuration.md	Configuring Azure Monitor end to end: agents, DCRs, pipelines, networking, alerts, autoscale, Application Insights, Kubernetes/Prometheus, Private Link, logs/metrics schemas, and resource‑specific metrics/logs.
Integrations & Coding Patterns	integrations.md	Integrating Azure Monitor with apps, alerts, ITSM, Prometheus/Grafana, REST/CLI, and using KQL patterns to query, export, and analyze logs/metrics across many Azure and third‑party services
Deployment	deployment.md	Deploying and migrating Azure Monitor agents/resources at scale (VMs, Arc, diagnostics, alerts, Profiler, workspaces, Grafana) using Policy, ARM, CLI, and PowerShell

Troubleshooting

Topic	URL
Troubleshoot Azure Log Analytics Linux agent issues	https://learn.microsoft.com/en-us/azure/azure-monitor/agents/agent-linux-troubleshoot
Troubleshoot Log Analytics agent for Windows	https://learn.microsoft.com/en-us/azure/azure-monitor/agents/agent-windows-troubleshoot
Monitor and troubleshoot Azure Monitor Agent health at scale	https://learn.microsoft.com/en-us/azure/azure-monitor/agents/azure-monitor-agent-health
Troubleshoot Azure Monitor agent on Linux VMs and scale sets	https://learn.microsoft.com/en-us/azure/azure-monitor/agents/azure-monitor-agent-troubleshoot-linux-vm
Fix syslog collection issues with Azure Monitor Agent on Linux	https://learn.microsoft.com/en-us/azure/azure-monitor/agents/azure-monitor-agent-troubleshoot-linux-vm-rsyslog
Troubleshoot Azure Monitor agent on Windows Arc-enabled servers	https://learn.microsoft.com/en-us/azure/azure-monitor/agents/azure-monitor-agent-troubleshoot-windows-arc
Troubleshoot Azure Monitor agent on Windows VMs and scale sets	https://learn.microsoft.com/en-us/azure/azure-monitor/agents/azure-monitor-agent-troubleshoot-windows-vm
Troubleshoot Azure Diagnostics extension issues on Azure resources	https://learn.microsoft.com/en-us/azure/azure-monitor/agents/diagnostics-extension-troubleshooting
Use AMA Linux troubleshooter to diagnose agent issues	https://learn.microsoft.com/en-us/azure/azure-monitor/agents/troubleshooter-ama-linux
Use AMA Windows troubleshooter to diagnose agent issues	https://learn.microsoft.com/en-us/azure/azure-monitor/agents/troubleshooter-ama-windows

Best Practices

Topic	URL
Apply telemetry best practices for observability agent	https://learn.microsoft.com/en-us/azure/azure-monitor/aiops/observability-agent-best-practices
Optimize Azure Monitor log alert queries for performance	https://learn.microsoft.com/en-us/azure/azure-monitor/alerts/alerts-log-query
Apply Azure Monitor alerts architectural best practices	https://learn.microsoft.com/en-us/azure/azure-monitor/alerts/best-practices-alerts
Apply autoscale best practices across Azure services	https://learn.microsoft.com/en-us/azure/azure-monitor/autoscale/autoscale-best-practices
Implement common autoscale patterns in Azure	https://learn.microsoft.com/en-us/azure/azure-monitor/autoscale/autoscale-common-scale-patterns
Avoid and mitigate autoscale flapping scenarios	https://learn.microsoft.com/en-us/azure/azure-monitor/autoscale/autoscale-flapping
Use multiple autoscale profiles for time-based scaling	https://learn.microsoft.com/en-us/azure/azure-monitor/autoscale/autoscale-multiprofile
Apply Azure Monitor best practices for AKS clusters	https://learn.microsoft.com/en-us/azure/azure-monitor/containers/best-practices-containers
Optimize Container Insights monitoring costs and configuration	https://learn.microsoft.com/en-us/azure/azure-monitor/containers/container-insights-cost
Design cost-effective alerting for AKS in Azure Monitor	https://learn.microsoft.com/en-us/azure/azure-monitor/containers/cost-effective-alerting
Apply Azure Monitor best practices for Kubernetes layers

Decision Making

Topic	URL
Plan and execute migration from Log Analytics agent to AMA	https://learn.microsoft.com/en-us/azure/azure-monitor/agents/azure-monitor-agent-migration
Plan migration from Log Analytics Agent to Azure Monitor Agent	https://learn.microsoft.com/en-us/azure/azure-monitor/agents/azure-monitor-agent-migration-helper-workbook
Plan migration from WAD/LAD diagnostics to AMA	https://learn.microsoft.com/en-us/azure/azure-monitor/agents/azure-monitor-agent-migration-wad-lad
Migrate legacy Log Analytics alert rules to ScheduledQueryRules API	https://learn.microsoft.com/en-us/azure/azure-monitor/alerts/alerts-log-api-switch
Choose the right Azure Monitor alert type	https://learn.microsoft.com/en-us/azure/azure-monitor/alerts/alerts-types
Migrate from alertsSummary API to Azure Resource Graph	https://learn.microsoft.com/en-us/azure/azure-monitor/alerts/migrate-from-alerts-summary-api
Migrate from Application Insights SDKs to OpenTelemetry	https://learn.microsoft.com/en-us/azure/azure-monitor/app/migrate-to-opentelemetry
Transition from Container Monitoring Solution to Container Insights	https://learn.microsoft.com/en-us/azure/azure-monitor/containers/container-insights-transition-solution
Choose Azure Monitor OTLP ingestion option for AKS and VMs	https://learn.microsoft.com/en-us/azure/azure-monitor/containers/opentelemetry-summary
Choose between Azure Monitor metrics export and data plane API	https://learn.microsoft.com/en-us/azure/azure-monitor/data-collection/data-plane-versus-metrics-export

Architecture & Design Patterns

Topic	URL
Design an enterprise monitoring architecture with Azure Monitor	https://learn.microsoft.com/en-us/azure/azure-monitor/fundamentals/enterprise-monitoring-architecture
Design Azure Monitor Private Link architecture	https://learn.microsoft.com/en-us/azure/azure-monitor/fundamentals/private-link-design
Design single vs multiple Log Analytics workspaces	https://learn.microsoft.com/en-us/azure/azure-monitor/logs/workspace-design
Design resilient architectures with Log Analytics workspace replication	https://learn.microsoft.com/en-us/azure/azure-monitor/logs/workspace-replication

Limits & Quotas

Topic	URL
Plan Azure Monitor Agent performance for gateway forwarding	https://learn.microsoft.com/en-us/azure/azure-monitor/agents/azure-monitor-agent-performance
Check Azure Monitor Agent platform and resource requirements	https://learn.microsoft.com/en-us/azure/azure-monitor/agents/azure-monitor-agent-requirements
Check supported operating systems for Azure Monitor Agent	https://learn.microsoft.com/en-us/azure/azure-monitor/agents/azure-monitor-agent-supported-operating-systems
Manage Azure Monitor alert instance retention and state	https://learn.microsoft.com/en-us/azure/azure-monitor/alerts/alerts-manage-alert-instances
Monitor and interpret log alert rule health in Azure Monitor	https://learn.microsoft.com/en-us/azure/azure-monitor/alerts/log-alert-rule-health
Deploy log search alert rules with ARM templates and size limits	https://learn.microsoft.com/en-us/azure/azure-monitor/alerts/resource-manager-alerts-log
Configure and understand Application Insights availability tests	https://learn.microsoft.com/en-us/azure/azure-monitor/app/availability
Configure predictive autoscale thresholds and history requirements	https://learn.microsoft.com/en-us/azure/azure-monitor/autoscale/autoscale-predictive
Enable high-scale log collection limits in Container Insights	https://learn.microsoft.com/en-us/azure/azure-monitor/containers/container-insights-high-scale
Use region mappings for Container Insights and Log Analytics	https://learn.microsoft.com/en-us/azure/azure-monitor/containers/container-insights-region-mapping

Security

Topic	URL
Secure ITSM integrations with Azure Monitor Secure Webhook	https://learn.microsoft.com/en-us/azure/azure-monitor/alerts/it-service-management-connector-secure-webhook-connections
Configure Azure for Secure Webhook ITSM integrations	https://learn.microsoft.com/en-us/azure/azure-monitor/alerts/itsm-connector-secure-webhook-connections-azure-configuration
Use Application Insights smart detection to identify security issues	https://learn.microsoft.com/en-us/azure/azure-monitor/alerts/proactive-application-security-detection-pack
Enable Microsoft Entra authentication for Application Insights ingestion	https://learn.microsoft.com/en-us/azure/azure-monitor/app/azure-ad-authentication
Configure IP address handling in Application Insights	https://learn.microsoft.com/en-us/azure/azure-monitor/app/ip-collection
Migrate Container Insights from legacy to managed identity authentication	https://learn.microsoft.com/en-us/azure/azure-monitor/containers/container-insights-authentication
Configure secure access to Live Data in Container insights	https://learn.microsoft.com/en-us/azure/azure-monitor/containers/container-insights-livedata-setup
Configure TLS and mTLS for Azure Monitor pipeline	https://learn.microsoft.com/en-us/azure/azure-monitor/data-collection/pipeline-tls
Use automated TLS certificate management for Azure Monitor pipeline	https://learn.microsoft.com/en-us/azure/azure-monitor/data-collection/pipeline-tls-automated
Configure customer-managed TLS certificates for Azure Monitor pipeline