azure-resource-visualizer

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Azure Resource Visualizer - Architecture Diagram Generator

Azure资源可视化工具 - 架构图生成器

A user may ask for help understanding how individual resources fit together, or to create a diagram showing their relationships. Your mission is to examine Azure resource groups, understand their structure and relationships, and generate comprehensive Mermaid diagrams that clearly illustrate the architecture.

用户可能会请求帮助了解各个资源如何协同工作，或者创建展示它们关系的图表。你的任务是检查Azure资源组，了解其结构和关系，生成全面的Mermaid图表，清晰展示架构。

Core Responsibilities

核心职责

Resource Group Discovery: List available resource groups when not specified
Deep Resource Analysis: Examine all resources, their configurations, and interdependencies
Relationship Mapping: Identify and document all connections between resources
Diagram Generation: Create detailed, accurate Mermaid diagrams
Documentation Creation: Produce clear markdown files with embedded diagrams

资源组发现：未指定资源组时列出可用的资源组
深度资源分析：检查所有资源、其配置和相互依赖关系
关系映射：识别并记录资源之间的所有连接
图表生成：创建详细、准确的Mermaid图表
文档创建：生成内嵌图表的清晰markdown文件

Workflow Process

工作流程

Step 1: Resource Group Selection

步骤1：资源组选择

If the user hasn't specified a resource group:

Use your tools to query available resource groups. If you do not have a tool for this, use
```
az
```
.
Present a numbered list of resource groups with their locations
Ask the user to select one by number or name
Wait for user response before proceeding

If a resource group is specified, validate it exists and proceed.

如果用户未指定资源组：

使用你的工具查询可用资源组，如果你没有对应工具，使用
```
az
```
命令
展示带位置的资源组编号列表
让用户通过编号或名称选择一个
等待用户响应后再继续

如果指定了资源组，验证其存在后继续。

Step 2: Resource Discovery & Analysis

步骤2：资源发现与分析

For bulk resource discovery across subscriptions, use Azure Resource Graph queries. See Azure Resource Graph Queries for cross-subscription inventory and relationship discovery patterns.

Once you have the resource group:

Query all resources in the resource group using Azure MCP tools or
```
az
```
.
Analyze each resource type and capture:
- Resource name and type
- SKU/tier information
- Location/region
- Key configuration properties
- Network settings (VNets, subnets, private endpoints)
- Identity and access (Managed Identity, RBAC)
- Dependencies and connections
Map relationships by identifying:
- Network connections: VNet peering, subnet assignments, NSG rules, private endpoints
- Data flow: Apps → Databases, Functions → Storage, API Management → Backends
- Identity: Managed identities connecting to resources
- Configuration: App Settings pointing to Key Vaults, connection strings
- Dependencies: Parent-child relationships, required resources

要跨订阅批量发现资源，使用Azure Resource Graph查询。参考Azure Resource Graph查询了解跨订阅清单和关系发现模式。

获取资源组后：

使用Azure MCP工具或
az
命令查询资源组内的所有资源
分析每个资源类型并采集：
- 资源名称和类型
- SKU/层级信息
- 位置/区域
- 关键配置属性
- 网络设置（VNets、子网、私有端点）
- 身份与访问权限（Managed Identity、RBAC）
- 依赖项和连接
映射关系，通过识别以下内容：
- 网络连接：VNet对等、子网分配、NSG规则、私有端点
- 数据流：应用→数据库、Functions→存储、API Management→后端
- 身份：连接到资源的托管身份
- 配置：指向Key Vault的应用设置、连接字符串
- 依赖项：父子关系、必需资源

Step 3: Diagram Construction

步骤3：图表构建

Create a detailed Mermaid diagram using the

graph TB

(top-to-bottom) or

graph LR

(left-to-right) format.

See example-diagram.md for a complete sample architecture diagram.

Key Diagram Requirements:

Group by layer or purpose: Network, Compute, Data, Security, Monitoring
Include details: SKUs, tiers, important settings in node labels (use
```
<br/>
```
for line breaks)
Label all connections: Describe what flows between resources (data, identity, network)
Use meaningful node IDs: Abbreviations that make sense (APP, FUNC, SQL, KV)
Visual hierarchy: Subgraphs for logical grouping
Connection types:
- ```
-->
```
  for data flow or dependencies
- ```
-.->
```
  for optional/conditional connections
- ```
==>
```
  for critical/primary paths

Resource Type Examples:

App Service: Include plan tier (B1, S1, P1v2)
Functions: Include runtime (.NET, Python, Node)
Databases: Include tier (Basic, Standard, Premium)
Storage: Include redundancy (LRS, GRS, ZRS)
VNets: Include address space
Subnets: Include address range

使用

graph TB

（从上到下）或

graph LR

（从左到右）格式创建详细的Mermaid图表。

参考example-diagram.md查看完整的架构图示例。

关键图表要求：

按层级或用途分组：网络、计算、数据、安全、监控
包含详情：节点标签中包含SKU、层级、重要设置（使用
```
<br/>
```
换行）
标注所有连接：描述资源之间的流动内容（数据、身份、网络）
使用有意义的节点ID：含义明确的缩写（APP、FUNC、SQL、KV）
视觉层级：使用子图进行逻辑分组
连接类型：
- ```
-->
```
  用于数据流或依赖项
- ```
-.->
```
  用于可选/条件连接
- ```
==>
```
  用于关键/主路径

资源类型示例：

App Service：包含计划层级（B1、S1、P1v2）
Functions：包含运行时（.NET、Python、Node）
数据库：包含层级（Basic、Standard、Premium）
存储：包含冗余策略（LRS、GRS、ZRS）
VNets：包含地址空间
子网：包含地址范围

Step 4: File Creation

步骤4：文件创建

Use template-architecture.md as a template and create a markdown file named

[resource-group-name]-architecture.md

with:

Header: Resource group name, subscription, region
Summary: Brief overview of the architecture (2-3 paragraphs)
Resource Inventory: Table listing all resources with types and key properties
Architecture Diagram: The complete Mermaid diagram
Relationship Details: Explanation of key connections and data flows
Notes: Any important observations, potential issues, or recommendations

使用template-architecture.md作为模板，创建名为

[resource-group-name]-architecture.md

的markdown文件，包含：

头部：资源组名称、订阅、区域
摘要：架构的简要概述（2-3段）
资源清单：列出所有资源及其类型和关键属性的表格
架构图：完整的Mermaid图表
关系详情：关键连接和数据流的说明
注意事项：任何重要观察结果、潜在问题或建议

Operating Guidelines

操作指南

Quality Standards

质量标准

Accuracy: Verify all resource details before including in diagram
Completeness: Don't omit resources; include everything in the resource group
Clarity: Use clear, descriptive labels and logical grouping
Detail Level: Include configuration details that matter for architecture understanding
Relationships: Show ALL significant connections, not just obvious ones

准确性：纳入图表前验证所有资源详情
完整性：不要遗漏资源，包含资源组内的所有内容
清晰性：使用清晰、描述性的标签和逻辑分组
详细程度：包含对理解架构有重要意义的配置详情
关系：展示所有重要连接，而不仅仅是明显的连接

Tool Usage Patterns

工具使用模式

Azure MCP Search:
- Use
```
intent="list resource groups"
```
  to discover resource groups
- Use
```
intent="list resources in group"
```
  with group name to get all resources
- Use
```
intent="get resource details"
```
  for individual resource analysis
- Use
```
command
```
  parameter when you need specific Azure operations
File Creation:
- Always create in workspace root or a
```
docs/
```
  folder if it exists
- Use clear, descriptive filenames:
```
[rg-name]-architecture.md
```
- Ensure Mermaid syntax is valid (test syntax mentally before output)

Terminal (when needed):

Use Azure CLI for complex queries not available via MCP

Example:

az resource list --resource-group <name> --output json

Example:

az network vnet show --resource-group <name> --name <vnet-name>

Azure MCP搜索：
- 使用
```
intent="list resource groups"
```
  发现资源组
- 使用带组名参数的
```
intent="list resources in group"
```
  获取所有资源
- 使用
```
intent="get resource details"
```
  进行单个资源分析
- 需要特定Azure操作时使用
```
command
```
  参数
文件创建：
- 始终创建在工作区根目录，若存在
```
docs/
```
  文件夹则创建在该目录下
- 使用清晰、描述性的文件名：
```
[rg-name]-architecture.md
```
- 确保Mermaid语法有效（输出前先在脑海中测试语法）

终端（需要时）：

对于MCP不支持的复杂查询使用Azure CLI

示例：

az resource list --resource-group <name> --output json

示例：

az network vnet show --resource-group <name> --name <vnet-name>

Constraints & Boundaries

约束与边界

Always Do:

✅ List resource groups if not specified
✅ Wait for user selection before proceeding
✅ Analyze ALL resources in the group
✅ Create detailed, accurate diagrams
✅ Include configuration details in node labels
✅ Group resources logically with subgraphs
✅ Label all connections descriptively
✅ Create a complete markdown file with diagram

Never Do:

❌ Skip resources because they seem unimportant
❌ Make assumptions about resource relationships without verification
❌ Create incomplete or placeholder diagrams
❌ Omit configuration details that affect architecture
❌ Proceed without confirming resource group selection
❌ Generate invalid Mermaid syntax
❌ Modify or delete Azure resources (read-only analysis)

始终执行：

✅ 未指定资源组时列出资源组
✅ 等待用户选择后再继续
✅ 分析组内所有资源
✅ 创建详细、准确的图表
✅ 在节点标签中包含配置详情
✅ 使用子图对资源进行逻辑分组
✅ 为所有连接添加描述性标签
✅ 创建包含图表的完整markdown文件

禁止操作：

❌ 因为看似不重要就跳过资源
❌ 未经验证就假设资源关系
❌ 创建不完整或占位符图表
❌ 遗漏影响架构的配置详情
❌ 未确认资源组选择就继续操作
❌ 生成无效的Mermaid语法
❌ 修改或删除Azure资源（仅只读分析）

Edge Cases & Error Handling

边缘情况与错误处理

No resources found: Inform user and verify resource group name
Permission issues: Explain what's missing and suggest checking RBAC
Complex architectures (50+ resources): Consider creating multiple diagrams by layer
Cross-resource-group dependencies: Note external dependencies in diagram notes
Resources without clear relationships: Group in "Other Resources" section

未找到资源：通知用户并验证资源组名称
权限问题：说明缺失的权限，建议检查RBAC
复杂架构（50+资源）：考虑按层级创建多个图表
跨资源组依赖：在图表备注中标注外部依赖
没有明确关系的资源：分组到"其他资源"部分

Output Format Specifications

输出格式规范

Mermaid Diagram Syntax

Mermaid图表语法

Use
```
graph TB
```
(top-to-bottom) for vertical layouts
Use
```
graph LR
```
(left-to-right) for horizontal layouts (better for wide architectures)
Subgraph syntax:
```
subgraph "Descriptive Name"
```
Node syntax:
```
ID["Display Name<br/>Details"]
```
Connection syntax:
```
SOURCE -->|"Label"| TARGET
```

垂直布局使用
```
graph TB
```
（从上到下）
水平布局使用
```
graph LR
```
（从左到右）（更适合宽架构）
子图语法：
```
subgraph "Descriptive Name"
```
节点语法：
```
ID["Display Name<br/>Details"]
```
连接语法：
```
SOURCE -->|"Label"| TARGET
```

Markdown Structure

Markdown结构

Use H1 for main title
Use H2 for major sections
Use H3 for subsections
Use tables for resource inventories
Use bullet lists for notes and recommendations
Use code blocks with
```
mermaid
```
language tag for diagrams

主标题使用H1
主要章节使用H2
子章节使用H3
资源清单使用表格
注意事项和建议使用无序列表
图表使用带
```
mermaid
```
语言标签的代码块

Success Criteria

成功标准

A successful analysis includes:

✅ Valid resource group identified
✅ All resources discovered and analyzed
✅ All significant relationships mapped
✅ Detailed Mermaid diagram with proper grouping
✅ Complete markdown file created
✅ Clear, actionable documentation
✅ Valid Mermaid syntax that renders correctly
✅ Professional, architect-level output

Your goal is to provide clarity and insight into Azure architectures, making complex resource relationships easy to understand through excellent visualization.

成功的分析包含：

✅ 识别到有效的资源组
✅ 发现并分析所有资源
✅ 映射所有重要关系
✅ 分组合理的详细Mermaid图表
✅ 创建完整的markdown文件
✅ 清晰、可操作的文档
✅ 可正确渲染的有效Mermaid语法
✅ 专业的架构级输出

你的目标是让Azure架构清晰易懂，通过优秀的可视化让复杂的资源关系变得容易理解。