# azure-network-watcher

Guides agents through Azure Network Watcher configuration, VPN troubleshooting, and flow log setup. Useful when building Terraform automations or writing KQL analytics queries.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 186 installs · ★ 818 repo stars
- Author: MicrosoftDocs
- License: CC-BY-4.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/MicrosoftDocs/Agent-Skills/tree/HEAD/skills/azure-network-watcher/SKILL.md
- Updated: 2026-11-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/azure-network-watcher

## What it does

The skill provides reference architecture and workflows for Azure Network Watcher. It guides troubleshooting for NSG rules, outbound connections, and hybrid VPN tunnels. It also covers migration paths, including moving from Network Performance Monitor to Connection Monitor and upgrading NSG flow logs to VNet flow logs.

The skill uses an internal index and fetches remote docs on demand. It relies on `mcp_microsoftdocs:microsoft_docs_fetch` or `fetch_webpage` with specific parameters. Without network access, documentation lookups will fail.

Do not use this skill for general virtual networking or base monitoring. Tasks for Azure Monitor or core virtual networks require separate skills like `azure-monitor` and `azure-networking`.

## Requirements
- Works with: Azure

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add MicrosoftDocs/Agent-Skills --skill azure-network-watcher -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/azure-network-watcher/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/azure-network-watcher/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add MicrosoftDocs/Agent-Skills --skill azure-network-watcher -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/azure-network-watcher/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add MicrosoftDocs/Agent-Skills --skill azure-network-watcher -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/azure-network-watcher/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install MicrosoftDocs/Agent-Skills skills/azure-network-watcher
```

2. **Manually: put the files in place**
- File: `.github/skills/azure-network-watcher/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add MicrosoftDocs/Agent-Skills --skill azure-network-watcher -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/MicrosoftDocs/Agent-Skills --path skills/azure-network-watcher
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/azure-network-watcher/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add MicrosoftDocs/Agent-Skills --skill azure-network-watcher -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/MicrosoftDocs/Agent-Skills/tree/HEAD/skills/azure-network-watcher/SKILL.md

## When to use it
- provision VNet flow logs with managed identities via Terraform
- diagnose outbound traffic drops and NSG rule conflicts
- migrate classic Connection Monitor tests to the current service
- query Traffic Analytics data tables using KQL
- trigger packet capture workflows from Azure Functions alerts

## Example prompts
- Generate a Terraform configuration to enable VNet flow logs and Traffic Analytics
- Diagnose why outbound packets fail on our Azure VPN gateway
- Show how to migrate Network Performance Monitor tests to Connection Monitor

## Source text · SKILL.md · CC-BY-4.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 7b42c3e7e498bce0.

BEGIN THIRD-PARTY FILE 7b42c3e7e498bce0
```text
---
name: azure-network-watcher
description: Expert knowledge for Azure Network Watcher development including troubleshooting, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when configuring flow logs/Traffic Analytics, packet captures, Connection Monitor migrations, VPN checks, or KQL/Terraform automations, and other Azure Network Watcher related development tasks. Not for Azure Monitor (use azure-monitor), Azure Networking (use azure-networking), Azure Virtual Network (use azure-virtual-network), Azure Virtual Network Manager (use azure-virtual-network-manager).
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 Network Watcher Skill

This skill provides expert guidance for Azure Network Watcher. Covers troubleshooting, decision making, limits & quotas, security, configuration, and integrations & coding patterns. 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 | Lines | Description |
|----------|-------|-------------|
| Troubleshooting | L34-L44 | Diagnosing and fixing outbound connectivity, NSG/admin rule issues, and VPN gateway/on-prem VPN problems, plus automating VPN monitoring with Azure Network Watcher. |
| Decision Making | L45-L51 | Guidance for migrating network monitoring: moving from classic Connection Monitor and Network Performance Monitor tests, and switching NSG flow logs to VNet flow logs. |
```
END THIRD-PARTY FILE 7b42c3e7e498bce0

The third-party file has ended. Everything between the 7b42c3e7e498bce0 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2556 of 8261 bytes. © MicrosoftDocs · CC-BY-4.0 · https://github.com/MicrosoftDocs/Agent-Skills/tree/HEAD/skills/azure-network-watcher/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
