Seminar Kroki – Performance, Monitoring und Fehleranalyse

Rendering-Dienste messbar stabil und effizient betreiben

Ein erreichbarer Port beweist noch keinen funktionierenden Diagrammdienst. Kroki muss Quellen annehmen, an den richtigen Renderer weiterleiten und innerhalb akzeptabler Zeit ein verwertbares Ergebnis liefern. Das Seminar verbindet technische Messwerte mit synthetischen Renderingprüfungen.

Zwei Tage sind notwendig, um Messkonzept, Lastprofil, Ressourcenanalyse, Fehlerklassifikation und Störungsabläufe praktisch aufzubauen. Der Schwerpunkt liegt auf nachvollziehbaren Ursachen statt auf blindem Erhöhen von Limits.

Inhaltsübersicht

• Serviceziele, SLIs und typische Lastprofile
• Logs und strukturierte Fehlerklassen
• OpenTelemetry und verteilte Ablaufverfolgung
• Synthetische Renderprüfungen
• Latenz, Fehlerquote und Ressourcenverbrauch
• Lasttests, Parallelität und Kapazitätsplanung
• Timeouts, Limits und vorgelagertes Caching
• Diagnoseabläufe, Dashboard und Störungsübungen

Zielgruppe

Das Seminar richtet sich an Plattform- und Systemadministratoren, DevOps- und SRE-Fachkräfte, technische Betriebsverantwortliche sowie Entwickler, die Kroki als gemeinsamen Dienst bereitstellen oder Integrationsprobleme untersuchen.

Voraussetzungen

Erforderlich sind Grundkenntnisse in Linux, HTTP, Containern und Monitoring. Ein vorhandener oder im Seminar bereitgestellter Kroki-Dienst wird genutzt. Kenntnisse zu Metriken und verteiltem Tracing sind hilfreich, aber nicht zwingend.

Lernstrecke Schritt für Schritt

1. Schritt 1: Serviceziele und Messgrößen definieren. Verfügbarkeit, Rendering-Erfolg, Latenz und Fehlerquote werden als überprüfbare Ziele formuliert. Diagrammtypen und Ausgabeformate erhalten repräsentative Testfälle.
2. Schritt 2: Lastprofile erfassen. Interaktive Einzelanfragen, Dokumentationsbuilds, Batch-Konvertierung und Spitzenlast werden unterschieden. Quelle, Größe, Renderer und Parallelität bilden die Messdimensionen.
3. Schritt 3: Protokolle strukturieren. Zeitpunkt, Request-Bezug, Diagrammtyp, Renderer, Dauer und Fehlerklasse werden so erfasst, dass eine Anfrage über mehrere Komponenten verfolgt werden kann.
4. Schritt 4: OpenTelemetry einordnen. Spuren, Ressourcenattribute und Kontextweitergabe werden für Gateway, Proxy und Companion-Dienste geplant. Sensible Diagramminhalte bleiben aus Telemetriedaten heraus.
5. Schritt 5: Synthetische Renderprüfungen erstellen. Kleine, stabile Referenzdiagramme prüfen nicht nur Erreichbarkeit, sondern tatsächliche Renderingfähigkeit und korrekten Medientyp.
6. Schritt 6: Latenz und Fehlerquote messen. Median, Perzentile, Zeitüberschreitungen und Fehlerraten werden nach Diagrammtyp getrennt ausgewertet. Durchschnittswerte allein gelten nicht als belastbar.
7. Schritt 7: Ressourcenprofile untersuchen. CPU, Arbeitsspeicher, Prozesse und Startkosten werden für Gateway und Companion-Dienste verglichen. Engpässe werden einer konkreten Komponente zugeordnet.
8. Schritt 8: Lasttests realistisch aufbauen. Anfragemix, Aufwärmphase, Parallelität und Testdauer bilden den tatsächlichen Betrieb ab. Schutzgrenzen verhindern eine unbeabsichtigte Überlastung fremder Systeme.
9. Schritt 9: Timeouts und Größenlimits festlegen. Client, Proxy, Gateway und Renderer erhalten abgestimmte Grenzen. Zu kurze und zu lange Werte werden anhand kontrollierter Fehlerfälle bewertet.
10. Schritt 10: Caching sinnvoll einsetzen. Unveränderte Quellen können über Quellhash, Clientcache oder Reverse Proxy wiederverwendet werden. Sicherheits- und Mandantengrenzen bleiben erhalten.
11. Schritt 11: Fehler nach Schicht diagnostizieren. DNS, TLS, Proxy, Gateway, Companion, Syntax, Ressourcen und Ausgabeformat werden in einer festen Reihenfolge geprüft.
12. Schritt 12: Ein Betriebsdashboard gestalten. Erreichbarkeit, Erfolgsquote, Latenz, Ressourcen, Fehlerklassen und synthetische Checks werden zu einer übersichtlichen Betriebsansicht zusammengeführt.
13. Schritt 13: Störungsabläufe üben. Companion-Ausfall, Ressourcenknappheit, fehlerhafte Konfiguration und Lastspitze werden simuliert. Erkennung, Eingrenzung, Maßnahme und Nachkontrolle werden protokolliert.

Praxisaufgaben

• Für mehrere Diagrammtypen repräsentative synthetische Prüfungen erstellen.
• Ein Lastprofil mit interaktiven und Batch-Anfragen definieren und ausführen.
• Latenz- und Ressourcenwerte nach Renderer getrennt auswerten.
• Einen mehrstufigen Fehler anhand von Logs und Spuren lokalisieren.
• Ein Betriebsdashboard und einen kurzen Störungsleitfaden erstellen.

Kompetenzziele

• Messbare Serviceziele und repräsentative Kroki-Prüfungen definieren.
• Logs, Metriken, Spuren und synthetische Tests sinnvoll kombinieren.
• Last, Latenz und Ressourcenverbrauch nach Renderer analysieren.
• Timeouts, Limits und Caching auf Basis von Messungen konfigurieren.
• Störungen strukturiert eingrenzen, behandeln und nachkontrollieren.