Core Knowledge Graph¶

The Core Knowledge Graph provides a bird's-eye view of the entire Azure App Service Practical Guide. It shows how platform concepts, best practices, troubleshooting playbooks, and reference materials interconnect.

Selected: None

Connections: -

Graph Structure¶

Foundation Layer: Platform Concepts¶

The platform concepts form the foundation of the knowledge graph:

graph TD
    A[How App Service Works] --> B[Request Lifecycle]
    A --> C[Hosting Models]
    A --> D[Scaling]
    A --> E[Networking]
    B --> F[Resource Relationships]
    E --> F
    A --> G[Authentication Architecture]
    A --> H[Security Architecture]

These documents explain what App Service is and how it works. Understanding them is prerequisite to most other content.

Guidance Layer: Best Practices¶

Best practices build on platform concepts and provide operational guidance:

graph TD
    subgraph Platform
        P1[Scaling]
        P2[Networking]
        P3[Security Architecture]
    end

    subgraph Best Practices
        B1[Scaling Best Practices]
        B2[Networking Best Practices]
        B3[Security Best Practices]
        B4[Production Baseline]
        B5[Deployment Best Practices]
        B6[Reliability Best Practices]
    end

    P1 --> B1
    P2 --> B2
    P3 --> B3
    B4 --> B1
    B4 --> B2
    B4 --> B3
    B4 --> B5
    B4 --> B6

Application Layer: Troubleshooting¶

Troubleshooting content connects platform knowledge to real-world problem-solving:

graph TD
    subgraph Platform
        C1[Request Lifecycle]
        C2[Networking]
    end

    subgraph Troubleshooting Structure
        T1[Quick Diagnosis Cards]
        T2[Decision Tree]
        T3[Mental Model]
        T4[Evidence Map]
    end

    subgraph Playbooks
        P1[Intermittent 5xx]
        P2[Memory Pressure]
        P3[SNAT Exhaustion]
    end

    C1 --> T3
    C2 --> T3
    T1 --> T2
    T2 --> P1
    T2 --> P2
    T2 --> P3
    T3 --> T4

Key Relationships¶

Prerequisite Chains¶

Understanding these prerequisite chains helps you learn in the right order:

Document	Prerequisites
Request Lifecycle	How App Service Works
Scaling Best Practices	Platform Scaling
Troubleshooting Mental Model	How App Service Works, Request Lifecycle
Intermittent 5xx Playbook	Mental Model, Evidence Map

Cross-Section Links¶

Documents frequently reference across sections:

From	To	Relationship
Production Baseline	All Best Practices	Aggregates
Common Anti-Patterns	Multiple Playbooks	troubleshooting_for
Evidence Map	All KQL Queries	references
Lab Guides	Corresponding Playbooks	validated_by_lab

Using the Graph¶

Finding Learning Paths¶

Start at a concept node (blue)
Follow prerequisite edges backward to find what you need to learn first
Follow deep_dive_for edges forward to find detailed coverage

Finding Troubleshooting Paths¶

Start at the Decision Tree or Quick Diagnosis Cards
Follow edges to relevant playbooks (orange)
Check connected labs (red) for hands-on verification
Use connected KQL queries (purple) for data collection

Exploring Connections¶

Click any node to see its direct connections
Use the filter dropdown to show only specific document types
Use search to find documents by name
Click "Reset View" to return to the default layout

Data Source¶

The graph data is generated from document frontmatter by tools/build_doc_graph.py. The JSON file is located at:

docs/assets/graph/core-knowledge.json

To regenerate after adding new documents or updating relationships:

python tools/build_doc_graph.py