Produktionsrealität (Living Diagram)

The Reality panel compares production with your model

Reality verwandelt Ihr C4-Diagramm in eine lebendige Ansicht dessen, was tatsächlich läuft. Verbinden Sie schreibgeschützte Produktionsquellen — Kubernetes, Datadog, New Relic — und Archyl erkennt Ihre echten Services und deren Abhängigkeiten und gleicht sie mit Ihrem kuratierten Modell ab. Ihr Diagramm ist nicht länger eine Momentaufnahme, sondern spiegelt die Produktion wider.

Reality ist schreibgeschützt und nicht-destruktiv: Das Scannen verändert niemals Ihre Infrastruktur und bearbeitet niemals eigenmächtig Ihr C4-Modell. Alles Erkannte ist ein Vorschlag, den Sie genehmigen.

Funktionsweise

Reality hält drei Ebenen sauber voneinander getrennt:

  • Model (Modell) — Ihre kuratierte C4-Architektur (die Absicht). Nur Sie ändern sie.
  • Reality (Realität) — ein kontinuierlich aktualisiertes Abbild dessen, was in der Produktion beobachtet wird (die Fakten).
  • Binding (Verknüpfung) — die Verbindung zwischen beiden, die Sie bestätigen.

Scanner schreiben ausschließlich in die Reality- und Binding-Ebenen. Eine erkannte Ressource in Ihr Modell zu übernehmen, ist immer ein expliziter Klick.

Schritt 1 — Eine Quelle in Ihrer Organisation verbinden

Zugangsdaten leben im Marketplace Ihrer Organisation, sodass Sie jede Quelle einmal konfigurieren und jedes Projekt sie nutzen kann.

Gehen Sie zu Organization → Marketplace und verbinden Sie eine der folgenden:

Kubernetes

Eine schreibgeschützte Verbindung zur API Ihres Clusters.

  • API Server URL — z. B. https://10.0.0.1:6443
  • Read-only ServiceAccount Token — erstellen Sie einen ServiceAccount, der an die integrierte view-ClusterRole gebunden ist, und generieren Sie anschließend ein Token
  • Skip TLS Verification — setzen Sie dies nur für selbstsignierte Dev-Cluster auf true

Archyl schreibt niemals in Ihren Cluster — es ruft ausschließlich Lese-Endpunkte auf (describe/list).

Datadog

  • API Key und Application Key (mit APM-Leserechten)
  • Site — datadoghq.com, datadoghq.eu, us5.datadoghq.com, … (muss zur Region Ihres Kontos passen)

Datadog liest seine APM Service Map, einschließlich abgeleiteter externer Abhängigkeiten (Datenbanken, Queues, Drittanbieter-Services).

New Relic

  • User API Key (NRAK-…) — wird verwendet, um Entitäten und Beziehungen zu lesen
  • Account ID (optional)
  • Region — US oder EU (muss zu Ihrem Konto passen)

New Relic liest APM-Anwendungen und OpenTelemetry-Services sowie deren CALLS-Beziehungen.

Schritt 2 — Die Quelle zu einem Projekt hinzufügen

Öffnen Sie ein Projektdiagramm und klicken Sie in der Symbolleiste (oben rechts) auf Reality. Das Reality-Panel öffnet sich auf der rechten Seite.

  1. Klicken Sie auf Add source.
  2. Wählen Sie eine Ihrer verbundenen Integrationen aus.
  3. Fügen Sie den Projekt-scope (Geltungsbereich) hinzu — einen Kubernetes-namespace oder eine Datadog-/New-Relic-environment (z. B. production). Lassen Sie das Feld leer, um alles einzubeziehen.
  4. Klicken Sie auf Add & scan.

Ein Projekt kann beliebig viele Quellen haben — Kubernetes und Datadog, nur eine oder mehrere.

Schritt 3 — Scannen

Jede Quelle wird unabhängig gescannt. Verwenden Sie das refresh-Symbol (Aktualisieren) an einer Quelle, um sie erneut zu scannen. Die Erkennung ist idempotent: Ein erneuter Scan aktualisiert das bereits Vorhandene, statt es zu duplizieren, und alles, was aus der Produktion verschwunden ist, wird markiert (niemals gelöscht).

Observability-Quellen können verzögert sein: Services erscheinen in der Regel innerhalb von Minuten, doch relationships (Beziehungen) werden aus der Trace-Analyse berechnet und benötigen unter Umständen 10–30 Minuten anhaltenden Traffic, um sich zu füllen.

Schritt 4 — Ressourcen abgleichen

Der Resources-Tab gruppiert das, was erkannt wurde:

  • Unmodeled in production (in der Produktion, aber nicht modelliert) — läuft in der Produktion, ist aber noch nicht in Ihrem Diagramm. Für jede Ressource können Sie:
    • Bind — sie mit einem vorgeschlagenen bestehenden C4-Element verknüpfen.
    • Promote — sie in ein neues C4-Element verwandeln (siehe unten).
    • Ignore — sie verwerfen (wiederherstellbar).
  • Drifted (abgewichen) — an Ihr Modell gebunden, aber ihr Produktionszustand ist abgewichen (z. B. fehlerhaft oder verschwunden).
  • In your model (in Ihrem Modell) — bestätigte Übereinstimmungen zwischen Produktion und C4.
  • Orphan (verwaist) — in Ihrem Modell, aber ohne Gegenstück in der Produktion.

Verwenden Sie das filter-Feld, um nach Name, Art oder Namespace zu suchen.

Einen Service auf die Container-Ebene übernehmen

Beim Übernehmen (Promote) wird aus einem erkannten Service ein neuer C4-container erstellt. Da Container innerhalb eines Systems leben, öffnen Sie zuerst das gewünschte System (navigieren Sie in die Container-Ebene hinein). Ist kein System geöffnet, ist Promote deaktiviert und ein Hinweis wird angezeigt. Der neue Container landet in dem System, das Sie gerade betrachten.

Schritt 5 — Verbindungen abgleichen

Der Connections-Tab listet erkannte Abhängigkeiten auf (wer wen aufruft). Eine Verbindung ist promotable (übernehmbar), sobald beide Endpunkte in Ihrem Modell sind (gebunden oder übernommen). Klicken Sie auf Promote, um sie als echte Beziehung in Ihrem Diagramm einzuzeichnen. Übernommene Verbindungen verschwinden automatisch aus der Vorschlagsliste.

Die Reality-Linse auf dem Diagramm

Solange das Reality-Panel geöffnet ist, aktiviert die Arbeitsfläche eine Live-Darstellung: C4-Elemente, die durch eine bestätigte Produktionsressource gestützt sind, zeigen oben rechts einen kleinen health dot (Gesundheitspunkt) und eine Instanzanzahl an. Dies bleibt nicht-destruktiv — es ist ein Overlay, keine Bearbeitung. Übernommene Services werden als saubere, normale Knoten dargestellt.

Sicherheit und Grenzen

  • Read-only (schreibgeschützt) — Reality schreibt niemals in Ihre Produktionssysteme und bearbeitet Ihr C4-Modell niemals automatisch. Sie genehmigen jede Änderung.
  • Per-source isolation (Isolation pro Quelle) — das Scannen einer Quelle beeinflusst niemals die Daten einer anderen.
  • Reversible (umkehrbar) — Bindungen können gelöst werden, ignorierte Elemente sind wiederherstellbar, und übernommene Elemente sind normale C4-Elemente, die Sie bearbeiten oder löschen können.
  • Trust levels (Vertrauensstufen) — Beziehungen werden nach Herkunft gekennzeichnet: observed (beobachtet, aus Telemetrie, das stärkste Signal) gegenüber config-derived (aus der Cluster-Konfiguration abgeleitet). Telemetriequellen (Datadog, New Relic, Kubernetes + ein Service Mesh) liefern den vollständigsten Abhängigkeitsgraphen.