Azure Architektur Leitfaden

Azure Data Platform Diagramm erstellen

Ein gutes Azure-Diagramm ersetzt 50 Confluence-Seiten. Dieser Leitfaden zeigt, wie du Diagramme baust, die Architektur erklären, Onboarding beschleunigen und Stakeholder ausrichten—ohne dass Dokumentation zum Vollzeitjob wird.

18 Min. LesezeitFür Data Engineers & Architekten100% Azure Beispiele

1. Warum Azure-Diagramme wichtig sind

Azure bietet über 200 Services, deine Plattform nutzt leicht ein Dutzend. Ohne klares Diagramm dauern Onboarding und Troubleshooting ewig. Ein gutes Diagramm wird zur Source of Truth.

Die Komplexität von Azure sichtbar machen

Typisch: 15-20 Services wie Data Factory, Synapse, Databricks, ADLS Gen2, Event Hubs, Purview, Key Vault. Ohne Dokumentation verstehen nur 2-3 Personen alles—und werden zum Engpass.

Ein gutes Azure-Diagramm bringt drei Vorteile:

Schnelleres Onboarding

Neue Kolleg:innen verstehen den Weg von Datenquelle bis Power BI in Stunden, nicht Wochen.

Bessere Incident Response

Fällt Synapse aus, siehst du sofort die Downstream-Auswirkungen. Keine Rätselraten.

Security & Compliance

Auditoren wollen Flüsse sehen. Ein Diagramm mit Encryption und Zugriffskontrolle beantwortet Fragen schneller als 50 Seiten Text.

Aus der Praxis

Ein Team verlor die einzige Person, die die Azure-Architektur kannte. Drei Wochen Rekonstruktion aus Logs und Pipelines folgten. Ein aktuelles Diagramm hätte das verhindert.

2. Wichtige Azure-Services aufnehmen

Zeige den Datenfluss: Ingestion → Storage → Processing → Serving → Consumption. Diese Services zählen am meisten.

Ingestion-Layer

Wie Daten reinkommen

  • Azure Data Factory: Batch ETL/ELT
  • Azure Event Hubs: Realtime-Ingestion
  • Azure IoT Hub: IoT-Daten
  • Logic Apps: Low-Code Integrationen

Storage-Layer

Wo Daten liegen

  • ADLS Gen2: Analytik-Data-Lake
  • Azure Blob Storage: Unstrukturierte Daten
  • Azure SQL Database: Operative Stores
  • Cosmos DB: Globales NoSQL

Processing-Layer

Wo Daten transformiert werden

  • Azure Databricks: Spark-Processing
  • Azure Synapse Analytics: DWH + Lakehouse
  • Azure Stream Analytics: Realtime-Processing
  • HDInsight: Hadoop-Stack

Serving & Consumption

Wie Daten genutzt werden

  • Power BI: BI und Visualisierung
  • Azure API Management: Daten-APIs
  • Azure Analysis Services: OLAP
  • Custom Apps: Web/Mobile

Nicht vergessen: Security & Governance

Azure Purview

Discovery, Katalog, Lineage

Azure Key Vault

Secrets, Keys, Zertifikate

Azure Active Directory

Identitäten & Zugriff

Pro Tipp

Zeige, was für die Zielgruppe zählt

Für Executives: Fokus auf Quellen, Processing, Consumption—VNets weglassen. Für Security: Key Vault, Managed Identity, Private Endpoints hervorheben. Eine Plattform, mehrere Sichten.

3. Häufige Azure-Architektur-Muster

Die meisten Plattformen folgen einem dieser Muster. Erkenne deins, um das Diagramm logisch zu strukturieren.

Muster 1: Modernes Data Warehouse

Batch-Flüsse aus Enterprise-Systemen → Bereinigung/Modellierung in Synapse → Serving in Power BI.

Fluss:

On-Prem DB → Azure Data Factory → ADLS Gen2 (raw) → Synapse SQL Pools (curated) → Power BI

Ideal für: Klassische BI, Finanzreporting, operative Dashboards

Muster 2: Realtime-Analytics

Streaming-Daten aus IoT/Apps → Realtime-Processing → Live-Dashboards und Alerts.

Fluss:

IoT Hub / Event Hubs → Stream Analytics → Synapse / Cosmos DB → Power BI Live / APIs

Ideal für: IoT-Monitoring, Fraud-Detection, Realtime-Kunden-Analytics

Muster 3: Lakehouse (Medallion)

Raw → Bronze → Silver → Gold auf ADLS Gen2, transformiert mit Databricks und Delta Lake.

Fluss:

Mehrere Quellen → ADF → ADLS (Bronze) → Databricks → ADLS (Silver/Gold) → Power BI / ML

Ideal für: ML-Workloads, Advanced Analytics, Kombination aus Batch + Streaming

Muster 4: Hybrid & Multi-Cloud

Daten verteilt auf On-Prem, Azure und andere Clouds. Integration via Azure Arc und Data Factory.

Fluss:

On-Prem + AWS S3 → ADF (hybrid IR) → ADLS Gen2 → Synapse → Power BI

Ideal für: Migration, Multi-Cloud-Strategien

MusterAzure-ServicesDiagramm-Fokus
Modernes DWADF, Synapse, ADLS Gen2Batch-Pipelines, SCD-Handling
RealtimeEvent Hubs, Stream AnalyticsStreaming-Pfade, Latenzen
LakehouseDatabricks, Delta Lake, ADLSBronze/Silver/Gold-Layer
HybridADF hybrid IR, Arc, VPNOn-Prem-Verbindungen, Security

4. Visuelle Best Practices

Ein Diagramm muss in Sekunden verständlich sein. Diese Prinzipien machen Azure-Architekturen auf Anhieb lesbar.

Offizielle Azure-Icons nutzen

Microsoft liefert Icon-Sets. Konsistente Icons bedeuten sofortiges Wiedererkennen. Niemand soll raten, ob das blaue Rechteck Storage oder DB ist.

Fluss von links nach rechts

Quellen links, Consumption rechts. Folgt der Leselogik und schafft eine klare Geschichte.

Nach Layer/Funktion gruppieren

Container oder Swimlanes für Layer. Ingestion, Processing, Serving—visuelle Hierarchie zählt.

Farbcodierung für Zweck

Blau für Quellen, Grün für Processing, Orange für Consumption. Oder nach Domäne: Finance (blau), Marketing (grün), Ops (orange).

Verbindungen klar beschriften

Nicht nur Pfeile. Beschrifte: 'Batch täglich (Parquet)', 'Realtime (JSON)', 'API (REST)'. Format und Frequenz zählen.

Security-Grenzen zeigen

VNets, Private Endpoints, Managed Identity sichtbar machen. Security erkennt Isolation auf einen Blick.

✓ Gutes Beispiel

  • • Data Factory Icon mit Label "ADF - Kunden-Pipeline"
  • • Pfeil "Batch stündlich (Parquet, ~50GB)"
  • • ADLS Gen2 Container "adls://kunden/raw"
  • • Farbcodes pro Domäne (blau = Kunden)
  • • Sichtbarer VNet-Perimeter

✗ Schwaches Beispiel

  • • Generische Rechtecke, keine Azure-Icons
  • • Pfeile ohne Labels
  • • Vage Namen wie "DB1" und "Storage"
  • • Zufällige Farben ohne Bedeutung
  • • Keine Security/Netzwerk-Sicht

Pro Tipp

Die 5-Sekunden-Regel

Nach 5 Sekunden muss klar sein: Wo kommen die Daten her? Wohin gehen sie? Wenn nicht, vereinfache oder verbessere die visuelle Hierarchie.

5. Datenflüsse klar zeigen

Der Datenfluss ist das Herz des Diagramms. So machst du ihn verständlich.

Pfeilstile nach Typ

Durchgezogen = Batch
Gestrichelt = Streaming
Gepunktet = API Calls

Was auf Pfeilen stehen sollte

  • Frequenz: Realtime, stündlich, täglich, on-demand
  • Format: Parquet, JSON, CSV, Avro
  • Volumen: ~100GB/Tag, ~1M Events/Min
  • Protokoll: HTTPS, SFTP, REST API, ODBC

Beispiel: Pipeline komplett beschriften

┌────────────────┐     Täglich Batch        ┌─────────────────┐     Stündlich      ┌──────────────┐
│   Salesforce   │────(CSV, 2GB/Tag)─────>│  Azure Data     │───(Parquet)────>│  ADLS Gen2   │
│   (CRM-Daten)  │    per HTTPS            │    Factory      │                 │  /raw/sales/ │
└────────────────┘                         └─────────────────┘                 └──────────────┘
                                                                                     │
                                                                                     │ Spark Job
                                                                                     │ (nachts)
                                                                                     ▼
┌────────────────┐                         ┌─────────────────┐                 ┌──────────────┐
│    Power BI    │<──────────────────────  │ Synapse SQL Pool│<────────────────│  ADLS Gen2   │
│  (Dashboards)  │                        │  (dim_customer) │   Delta Format  │ /curated/    │
└────────────────┘     DirectQuery         └─────────────────┘                 └──────────────┘

Komplexe Flüsse handhaben

Mehrere Pipelines

Nutze Farben für parallele Flüsse. Blau für Kunden, Grün für Produkt, Orange für Transaktionen.

Fan-out

Eine Quelle, mehrere Ziele? Jede Pfeilbeschriftung mit Zweck: "für Analytics", "für ML Training", "für Archiv".

Fehlerpfade

Zeige, wohin fehlerhafte Records gehen. Rote gestrichelte Pfeile zum Quarantäne-Bucket. Wichtig fürs Debugging.

Abhängigkeiten

Wartet Pipeline B auf A, markiere Reihenfolge (1, 2, 3) oder nutze gepunktete Pfeile.

6. Tools für Azure-Diagramme

ToolAm besten fürAzure-IconsKollaborationPreis
Microsoft VisioEnterprise-Standard✓ Native StencilsSharePoint$5-15/Nutzer/Monat
LucidchartCloud-Kollaboration✓ BibliothekRealtime$7.95-9/Nutzer/Monat
draw.io (diagrams.net)Kostenlos, Open-Source✓ ImportDatei-basiertGratis
DatadefKI, data-spezifisch✓ IntegriertCloud + GitGratis
MiroWorkshopsManueller ImportStark$8-16/Nutzer/Monat
Azure Architecture CenterReferenzarchitekturen✓ VorlagenN/A (Vorlagen)Gratis

Nimm Visio wenn:

  • • Du im Microsoft-Stack bist
  • • Offline-Editing brauchst
  • • Vorhandene Visio-Templates nutzt
  • • SharePoint-Integration wichtig ist

Nimm Lucidchart wenn:

  • • Realtime-Kollaboration nötig ist
  • • Verteilte/Remote-Teams
  • • Cloud-native mit Versionsverlauf
  • • Confluence/Jira-Integration

Nimm draw.io wenn:

  • • Budget = 0
  • • Diagramme in Git speichern willst
  • • Open-Source bevorzugst
  • • Wenige Features reichen

Nimm Datadef wenn:

  • • KI aus Text generieren soll
  • • Data-spezifische Vorlagen brauchst
  • • Integrierte Dokumentation (Wiki) willst
  • • Datenkatalog aufbauen möchtest

Aus der Praxis

Das Tool ist weniger wichtig als Konsistenz. Wähle eins und nutze es für alle Diagramme. Visio + Lucidchart + PowerPoint gleichzeitig erzeugen Dokumentations-Chaos.

7. Häufige Fehler vermeiden

Zu viel Detail

Packe nicht alle Resource Groups, Subnets und NSGs in ein Diagramm. Nutze Layer: hohe Architektur, separate Netzwerk-/Security-Ansicht.

Kein Owner oder Datum

Jedes Diagramm braucht Owner, Update-Datum, Link zu mehr Infos. Veraltete Diagramme sind wertlos.

Kein Versioning

Architektur ändert sich. Halte History. Git oder integriertes Versioning verhindert Rätselraten.

Vage Labels

"Storage Account 1" sagt nichts. Nutze klare Namen: "ADLS Gen2 - Kunden Raw (adls://prod-raw)".

Zielgruppe ignorieren

Nicht dasselbe Diagramm für Executives und Engineers. Detailgrad anpassen.

Keine Flussrichtung

Pfeile ohne Richtung sind nutzlos. Nutze gerichtete Pfeile; bidirektional nur, wenn nötig und klar.

Security weglassen

Ohne VNet, Private Endpoints, Managed Identity stellt Security viele Fragen. Zeige sie gleich mit.

Nur statische Diagramme

Denke an lebende Doku. Tools wie Datadef oder Purview können Teile aus Metadaten generieren.

Größter Fehler: Nicht updaten

Häufigster Grund für nutzlose Diagramme: niemand pflegt sie. Mach es Teil der Definition of Done. Neue Pipeline? Update. Neuer Service? Update. Behandle es wie Code-Doku—nicht optional.

8. Häufige Fragen (FAQ)

Was gehört in ein Azure-Datenplattform-Diagramm?

Quellen (On-Prem, SaaS, IoT), Ingestion (Azure Data Factory, Event Hubs), Storage (ADLS Gen2, Blob Storage), Processing (Azure Databricks, Synapse Analytics), Serving (Synapse SQL, Azure SQL Database), Consumption (Power BI, APIs) sowie Governance/Security (Purview, Key Vault).

Wie stelle ich Datenflüsse dar?

Nutze gerichtete Pfeile. Beschrifte Format (JSON, Parquet, CSV) und Frequenz (Realtime, stündlich, täglich). Unterscheide Batch/Streaming per Linienstil. Farbcodierung nach Domäne oder Kritikalität hilft.

Welche Tools für Azure-Diagramme?

Visio (native Stencils), Lucidchart (Cloud-Kollab), draw.io (kostenlos), Datadef (KI, data-spezifisch) und Azure Architecture Center Vorlagen. Wähle nach Kollaboration, Budget, Git.

Muss Sicherheit/Netzwerk rein?

Ja, aber passend. In der Architektur-Ansicht zeige VNets, Private Endpoints, Managed Identity, Purview, Key Vault. Für mehr Tiefe: separates Netzwerk-/Security-Diagramm. Zeige Verschlüsselung und Auth.

Wie oft aktualisieren?

Nach jedem Architektur-Change: neue Services, angepasste Pipelines, geänderte Flüsse. Teil der Definition of Done. Mindestens quartalsweise prüfen. Owner benennen.

Unterschied logische vs. physische Diagramme?

Logische Diagramme zeigen Komponenten und Flüsse (was die Plattform tut). Physische zeigen Ressourcen, Regionen, SKUs, Konfigurationen (wie implementiert). Nutze logische für Kommunikation, physische für Implementierung/Debugging.

Erstelle dein Azure-Diagramm in Minuten

Kein Whiteboard-Start. Generiere mit KI ein vollständiges Azure-Datenplattform-Diagramm aus Text. Danach per Drag-and-Drop anpassen.