Seminar DatoCMS: Performance, Caching und API-Limits

Performance wird von der Query bis zur sichtbaren Seite gemessen. Das Seminar verbindet Request-Inventur, GraphQL-Komplexität, Pagination, Cache-Hierarchien, Cache Tags, Revalidierung, Rate Limits, Asset-Optimierung, Monitoring, Lasttests und degradierbare Fehlerpfade.

Inhaltsübersicht

Kapitelinhaltsverzeichnis

• Lernziele und Einsatzbereiche
• Vorbereitung und Arbeitsweise
• Seminarinhalte
• Praktische Übungen und Anwendung

Lernziele und Einsatzbereiche

Kapitelinhaltsverzeichnis

• Kompetenzziele
• Typische Einsatzszenarien
• Abgrenzung und Schwerpunkt

Kompetenzziele

Die Inhalte sind auf unmittelbar anwendbare, prüfbare Kompetenzen ausgerichtet.

• Ein reproduzierbares Performance- und Request-Baselineprofil erstellen.
• Queries, Pagination und Antwortgrößen anhand messbarer Budgets optimieren.
• CDN-, Anwendungs- und Framework-Caches mit gezielter Revalidierung verbinden.
• API-Limits, Lastspitzen und Fehlerfälle mit Monitoring und Fallbacks beherrschen.

Typische Einsatzszenarien

Das Seminar eignet sich insbesondere für die folgenden Projekt- und Betriebssituationen.

• Optimierung langsamer Inhaltsseiten.
• Reduzierung unnötiger API-Aufrufe und Vollbuilds.
• Kapazitätsplanung für stark frequentierte oder mehrsprachige Anwendungen.

Abgrenzung und Schwerpunkt

Die fachliche Tiefe wird durch folgende Grenzen bewusst fokussiert.

• Keine allgemeine Browser- oder Netzwerkperformance-Schulung.
• Planwerte und Limits werden für die konkrete Schulungsumgebung verifiziert.
• Ein Lasttest wird kontrolliert und nicht gegen unbeteiligte Produktionssysteme ausgeführt.

Vorbereitung und Arbeitsweise

Kapitelinhaltsverzeichnis

• Zielgruppen
• Vorkenntnisse und Schulungsumgebung
• Didaktisches Vorgehen
• Qualitäts- und Abnahmekriterien

Zielgruppen

Frontend- und Full-Stack-Entwicklung, Softwarearchitektur, DevOps, Plattformbetrieb und technische Qualitätssicherung.

Vorkenntnisse und Schulungsumgebung

Erfahrung mit GraphQL-Abfragen, Web-Performance, Logging und mindestens einem modernen Frontend-Framework. Ein messbares Testfrontend ist erforderlich.

1. Schritt 1: Zugänge, Rollen und Schulungsprojekt vor Seminarbeginn kontrollieren.
2. Schritt 2: Beispieldaten, Assets, Quellmaterial oder Codebasis entsprechend dem Seminarthema bereitstellen.
3. Schritt 3: Ausgangszustand dokumentieren, damit Übungen wiederholt und Abweichungen eindeutig bewertet werden können.

Didaktisches Vorgehen

Kurze Fachblöcke werden unmittelbar mit Demonstrationen, geführten Arbeitsschritten, eigenständigen Laborphasen und kontrollierten Fehlerfällen verbunden.

1. Schritt 1: Ausgangsproblem und gewünschtes Sollverhalten präzisieren.
2. Schritt 2: Konfiguration oder Implementierung in kleinen, überprüfbaren Schritten ausführen.
3. Schritt 3: Normalfall, Grenzfall und mindestens einen Fehlerfall testen.
4. Schritt 4: Nachweis, Betriebsregel oder Checkliste aus dem Übungsergebnis ableiten.

Qualitäts- und Abnahmekriterien

• Konfigurationen und Arbeitsschritte sind reproduzierbar dokumentiert.
• Berechtigungen, Datenstände und Environments sind eindeutig voneinander getrennt.
• Positive und negative Testfälle besitzen ein erwartetes und nachvollziehbares Ergebnis.
• Fehlerzustände führen zu einer kontrollierten Diagnose und einem definierten Wiederanlauf.

Seminarinhalte

Kapitelinhaltsverzeichnis

• Messmodell und Baseline
• Request-Inventur und N-plus-eins-Muster
• Query-Komplexität und Feldauswahl
• Filter, Pagination und Datenmengen
• Cache-Hierarchie und Cache-Schlüssel
• Cache Tags und Revalidierung
• API-Limits und Rate-Limit-Verhalten
• Asset- und Medienperformance
• Monitoring und Kapazitätsplanung
• Degradation und Fehlerpfade

Messmodell und Baseline

Laufzeit, Requestzahl, Antwortgröße, Cache-Status und Fehlerquote werden mit einem festen Szenario erfasst.

1. Schritt 1: Repräsentative Seiten und Nutzungspfade auswählen.
2. Schritt 2: Messpunkte in Frontend, Server und API definieren.
3. Schritt 3: Baseline mehrfach erfassen und Streuung dokumentieren.

Request-Inventur und N-plus-eins-Muster

Versteckte Mehrfachabfragen und redundante Queries werden anhand einer vollständigen Requestliste sichtbar.

1. Schritt 1: Requests pro Seitenaufruf und Build erfassen.
2. Schritt 2: Doppelte oder komponentenweise wiederholte Abfragen gruppieren.
3. Schritt 3: Zusammenführung, Vorladen oder Datenübergabe als Korrektur planen.

Query-Komplexität und Feldauswahl

Abfragen werden auf fachlich benötigte Felder und vertretbare Beziehungstiefe begrenzt.

1. Schritt 1: Komplexität und Antwortgröße einer breiten Query messen.
2. Schritt 2: Tiefe Beziehungen und ungenutzte Felder entfernen.
3. Schritt 3: Optimierte Query gegen Funktions- und Datenanforderungen testen.

Filter, Pagination und Datenmengen

Listen und Archive werden mit stabiler Sortierung und kontrollierten Seitengrößen ausgeliefert.

1. Schritt 1: Maximale und typische Ergebnismengen bestimmen.
2. Schritt 2: Filter und Pagination mit Variablen implementieren.
3. Schritt 3: Erste, mittlere, letzte und leere Seite testen.

Cache-Hierarchie und Cache-Schlüssel

CDN-, Server-, Framework- und Browsercache werden als zusammenhängende Schichten mit eindeutigen Schlüsseln betrachtet.

1. Schritt 1: Cache-Schichten und Eigentümer dokumentieren.
2. Schritt 2: Schlüssel nach Query, Variablen, Locale und Environment prüfen.
3. Schritt 3: Cache-Hit, Miss und veralteten Eintrag gezielt reproduzieren.

Cache Tags und Revalidierung

Inhaltsänderungen aktualisieren möglichst nur abhängige Seiten und Datenbereiche.

1. Schritt 1: Records, Queries und Seitenabhängigkeiten erfassen.
2. Schritt 2: Cache-Tag- oder Pfadstrategie implementieren.
3. Schritt 3: Einzeländerung, Mehrfachänderung und Löschung testen.

API-Limits und Rate-Limit-Verhalten

Kontingente, Burst-Grenzen und uncached Requests werden in Betriebsgrenzen übersetzt.

1. Schritt 1: Relevante Limits und aktuelle Nutzung im Projekt erfassen.
2. Schritt 2: Warn- und Eskalationsschwellen definieren.
3. Schritt 3: Begrenzten Lasttest mit Retry-After- und Backoff-Verhalten ausführen.

Asset- und Medienperformance

Bildgrößen, Formate, Fokus, Lazy Loading und Videoausgabe werden in das Seitenbudget einbezogen.

1. Schritt 1: Medienanteil der Baseline messen.
2. Schritt 2: Responsive Varianten und Ladeprioritäten anpassen.
3. Schritt 3: Visuelle Qualität und Ladezeit nach der Optimierung vergleichen.

Monitoring und Kapazitätsplanung

Technische Kennzahlen werden mit Nutzungswachstum, Veröffentlichungsereignissen und Deployments korreliert.

1. Schritt 1: Dashboardsignale und Logfelder festlegen.
2. Schritt 2: Schwellenwerte mit normalem und Spitzenbetrieb kalibrieren.
3. Schritt 3: Kapazitätsannahmen und nächsten Reviewtermin dokumentieren.

Degradation und Fehlerpfade

Bei API- oder Cacheproblemen bleibt die Anwendung kontrolliert nutzbar und diagnostizierbar.

1. Schritt 1: Kritische und optionale Inhaltsbereiche klassifizieren.
2. Schritt 2: Stale-Cache-, Ersatzinhalt- oder Fehlerseitenstrategie implementieren.
3. Schritt 3: Timeout, Rate Limit und Teilausfall simulieren.

Praktische Übungen und Anwendung

Kapitelinhaltsverzeichnis

• Query-Budget für eine Inhaltsseite
• Gezielte Revalidierung
• Kontrollierter Limit-Test
• Stale-Cache-Fallback
• Prüf- und Abnahmekriterien

Query-Budget für eine Inhaltsseite

Szenario: Eine Seite lädt zu viele Felder und verschachtelte Beziehungen.

1. Schritt 1: Baseline und Budget erfassen.
2. Schritt 2: Überflüssige Felder und Beziehungen markieren.
3. Schritt 3: Query und Datenübergabe optimieren.
4. Schritt 4: Vorher-Nachher-Messung dokumentieren.

Prüfkriterium: Die optimierte Query erfüllt ein festgelegtes Budget für Komplexität, Antwortgröße und Requestzahl bei unveränderter fachlicher Ausgabe.

Gezielte Revalidierung

Szenario: Eine Autorenänderung betrifft mehrere Artikelteaser, aber nicht die gesamte Website.

1. Schritt 1: Abhängigkeiten und Cache-Schlüssel analysieren.
2. Schritt 2: Tag- oder Pfadzuordnung implementieren.
3. Schritt 3: Änderung, Löschung und Doppelereignis testen.
4. Schritt 4: Aktualisierungsumfang und Zeit messen.

Prüfkriterium: Nur abhängige Seiten werden aktualisiert; Cache-Schlüssel berücksichtigen Locale und Environment.

Kontrollierter Limit-Test

Szenario: Ein Testclient erzeugt uncached Requests bis zur definierten Schutzschwelle.

1. Schritt 1: Sichere Testgrenze und Zeitfenster festlegen.
2. Schritt 2: Messclient mit begrenzter Parallelität ausführen.
3. Schritt 3: Antwortstatus und Backoff protokollieren.
4. Schritt 4: Alarm- und Kapazitätsgrenzen anpassen.

Prüfkriterium: Client erkennt Begrenzung, verlangsamt sich kontrolliert und erzeugt keine unendliche Retry-Schleife.

Stale-Cache-Fallback

Szenario: Die API ist vorübergehend nicht erreichbar, während eine zuletzt gültige Seite im Cache liegt.

1. Schritt 1: Fallbackregeln und maximale Alterung festlegen.
2. Schritt 2: API-Ausfall simulieren.
3. Schritt 3: Seitenverhalten und Logs prüfen.
4. Schritt 4: Wiederherstellung und Cache-Aktualisierung testen.

Prüfkriterium: Die Anwendung liefert den freigegebenen Altstand mit Kennzeichnung oder definiertem Verhalten und protokolliert die Störung.

Prüf- und Abnahmekriterien

Die Übungen werden nicht allein nach sichtbarer Funktion, sondern nach Reproduzierbarkeit, Sicherheit, Datenqualität und Betriebsfähigkeit bewertet.

• Der Ausgangszustand, die Änderung und der geprüfte Zielzustand sind dokumentiert.
• Mindestens ein Negativ- oder Störungstest wurde kontrolliert durchgeführt.
• Geheimnisse, produktive Daten und unbeteiligte Systeme wurden nicht in die Übungen einbezogen.
• Offene Punkte besitzen Priorität, verantwortliche Stelle und nächsten Prüftermin.