/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 handling Log Analytics/AMA, App Insights, alerts/autoscale, Container Insights/Prometheus, or Workbooks, and other Azure Monitor related development tasks. Not for Azure Managed Grafana (use azure-managed-grafana), Azure Network Watcher (use azure-network-watcher), Azure Service Health (use azure-service-health), Azure Defender For Cloud (use azure-defender-for-cloud).
compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata:
  generated_at: "2026-11-08"
  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](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)

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-L118 | Diagnosing and fixing Azure Monitor data/agent issues (AMA/Log Analytics, diagnostics, pipelines, DCR, alerts, App Insights, containers, PostgreSQL, DevCenter, Workbooks, VM perf) using logs and tools. | | Best Practices | L119-L158 | Best practices for Azure Monitor configuration, alerts, autoscale, AKS/Kubernetes/VM monitoring, logs/Prometheus/PromQL, cost optimization, and performance/reliability tuning. | | Decision Making | L159-L197 | Guidance for planning and decision-making: choosing Azure Monitor agents, data collection and alerts, cost and billing strategies, and migration paths from legacy tools (MMA, WAD/LAD, SCOM, Splunk, Prometheus, etc.). | | Architecture & Design Patterns | L198-L203 | Designing end-to-end Azure Monitor architectures, including enterprise-scale layouts, data flows, and secure network topologies using Private Link for monitoring traffic. | | Limits & Quotas | L204-L231 | Limits, quotas, and performance planning for Azure Monitor: data ingestion/retention, query timeouts, alert and autoscale limits, Container Insights/Prometheus scale, and supported regions/resources. | | Security | L232-L302 | Securing Azure Monitor and related services: auth, RBAC, TLS, network/perimeter controls, policy, private access, and auditing/logging for Databricks, MDE, healthcare, Synapse, and threat intel. | | Configuration | [configuration.md](configuration.md) | Configuring Azure Monitor: agents, data collection rules, diagnostics, alerts, autoscale, workbooks, and resource‑specific logs/metrics across Azure services and Kubernetes. | | Integrations & Coding Patterns | [integrations.md](integrations.md) | Patterns and code for integrating Azure Monitor with apps, logs, metrics, alerts, ITSM/DevOps tools, Prometheus/Grafana, OpenTelemetry, and Kusto queries across many Azure and third‑party services. | | Deployment | [deployment.md](deployment.md) | Guides for deploying Azure Monitor/AMA, migrating from legacy agents and policies, and enabling .NET profiling and Snapshot Debugger across App Service, Functions, VMs, containers, and Service Fabric. |

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 | | Fix Azure Monitor agent problems on Windows Arc servers | https://learn.microsoft.com/en-us/azure/azure-monitor/agents/azure-monitor-agent-troubleshoot-windows-arc | | Diagnose Azure Monitor agent issues on Windows VMs | https://learn.microsoft.com/en-us/azure/azure-monitor/agents/azure-monitor-agent-troubleshoot-windows-vm | | Install and troubleshoot Azure Monitor Agent on Windows clients | https://learn.microsoft.com/en-us/azure/azure-monitor/agents/azure-monitor-agent-windows-client | | Troubleshoot Azure Diagnostics extension issues on Azure resources | https://learn.microsoft.com/en-us/azure/azure-monitor/agents/diagnostics-extension-troubleshooting | | Use Azure Monitor Agent Linux troubleshooter effectively | https://learn.microsoft.com/en-us/azure/azure-monitor/agents/troubles