Skip to content

README.de.md

Latest commit

 

History

History
171 lines (127 loc) · 5.89 KB

README.de.md

File metadata and controls

171 lines (127 loc) · 5.89 KB
Raw

ServerStory

ServerStory wertet die Besuchsliste deiner Website lokal im Browser aus. Das Tool zeigt Seitenaufrufe, grobe Besucher-Schätzungen, Käufe und optional den Vergleich mit Google Analytics. Die Logdatei wird nicht hochgeladen.

ServerStory: Logdatei auswählen, auswerten, Ergebnis ansehen

Nutzung

  1. Die ServerStory-ZIP-Datei aus den GitHub-Releases herunterladen, nicht den GitHub-Code-ZIP.
  2. START_HIER.html im Browser öffnen.
  3. Die Server-Logdatei auswählen (.log, .txt, .gz).
  4. Optional Google-Analytics-Seitenaufrufe und Kaufzahlen eintragen.
  5. Datei kurz prüfen oder Jetzt auswerten klicken.

ServerStory startet standardmäßig auf Englisch. Oben rechts kann die Sprache jederzeit zwischen DE und EN umgeschaltet werden; die Auswahl bleibt lokal im Browser gespeichert.

Die ZIP-Datei enthält auf der obersten Ebene nur START_HIER.html und den Ordner serverstory-app/. Zum Start reicht ein Doppelklick auf START_HIER.html.

Moderne Browser können gzip-komprimierte Logs direkt verarbeiten. Sehr große Dateien werden gestreamt; bei internen Schutzgrenzen markiert ServerStory die betroffenen Befunde als eingeschränkt.

Unterstützte Logdaten

ServerStory erkennt aktuell unter anderem:

  • Apache/Nginx Combined Logs
  • IIS/W3C Logs
  • CloudFront W3C/Standard-nahe Logs
  • Cloudflare Logpush-nahe JSON Logs
  • Fastly-nahe JSON Logs
  • Akamai-nahe JSON Logs
  • alte ITA-HTTP-Archivlogs ohne User-Agent

Die Kurzprüfung klassifiziert Dateien vor der Analyse als Access Log, Legacy-Access-Log oder als wahrscheinliches Nicht-Access-Log, zum Beispiel Analytics CSV, Error Log, WAF-/Security-Log oder Monitoring-Log.

Belastbarkeit

ServerStory soll keine falsche Sicherheit erzeugen. Deshalb bewertet das Tool jede wichtige Zahl einzeln: gut nutzbar, nur mit Vorsicht nutzbar oder mit diesen Daten nicht verlässlich bestimmbar. Sichtbare Ampeln und der Copy-Report verwenden dieselbe Entscheidungslogik.

Typische Gründe für eingeschränkte Befunde:

  • mehrere Hosts oder Subdomains in einer Datei
  • Proxy/CDN verdeckt echte Besucheradressen
  • Origin-Logs enthalten keine CDN-Cache-Hits
  • fehlendes oder unplausibles X-Forwarded-For
  • viele nicht erkannte Zeilen
  • unsortierte Logs
  • altes Format ohne User-Agent
  • falsche Google-Analytics-Metrik, falscher Zeitraum oder falsche Seitenauswahl
  • Conversion-Seite ohne Order-ID oder Reload-Risiko

Seitenaufrufe sind meist am belastbarsten, sofern die Datei lesbar ist und alle relevanten Aufrufe in der Logdatei landen. Besucher bleiben eine Schätzung, weil Serverlogs keine Personen-ID enthalten. Google-Analytics-Vergleiche sind nur sinnvoll, wenn Zeitraum, Website, Seitenpfade und Metrik wirklich zusammenpassen.

Copy-Report

Der Copy-Report exportiert ein versioniertes JSON-Protokoll serverstory.analysis.v1. Es enthält neben den Zahlen auch technische Prüfhinweise, zum Beispiel:

  • quality
  • evidence
  • evidenceFailures
  • claimMatrix
  • auditProtocol
  • exportCompleteness
  • ga4Validation
  • parser
  • accuracyNotes

Das Schema ist in docs/report-schema-v1.md beschrieben. Bekannte Genauigkeitsgrenzen stehen in docs/accuracy-limits.md.

Datenschutz

Die Auswertung läuft ausschließlich lokal im Browser. ServerStory sendet keine Logs an einen Server. Im UI und im Report werden aggregierte Befunde ausgegeben, keine Nutzerlisten.

Echte Logs können trotzdem personenbezogene Daten enthalten. Lege sie nicht ins Repo. Der Ordner serverstory-logs/ ist für lokale Dateien vorgesehen und per .gitignore ausgeschlossen.

Anonymisierte Snippets lassen sich so erzeugen:

node scripts/sanitize-log.js serverstory-logs/original.log serverstory-logs/anonymized.log

Der Sanitizer ersetzt IPs und Hosts durch Dokumentationswerte, maskiert E-Mails und entfernt riskante Query-Parameter wie email, name, user, token oder session. Vor dem Commit trotzdem manuell prüfen.

Entwicklung

Die Source of Truth liegt in src/:

  • src/modules/: Quellmodule für Parser, Aggregator, Diagnose-, Report-, Worker- und Render-Logik
  • src/app.js: aus src/modules/ gebündeltes Browser-Script für Tests und Build
  • src/styles.css: Styling
  • src/index.template.html: HTML-Template mit Platzhaltern

Der Build bündelt zuerst src/modules/ nach src/app.js und erzeugt daraus die portable Einzeldatei index.html:

npm run build

Das vollständige Qualitätsgate:

npm run verify

verify baut index.html aus src/ und prüft danach per Git-Diff, ob das Artefakt zum Quellstand passt. Wenn index.html und src/ auseinanderlaufen, schlägt der Lauf fehl.

Wichtige Einzelbefehle:

npm test              # Parser-, Diagnose-, Report-, Snapshot- und Render-Tests
npm run test:e2e      # Browserflow mit Upload, Preflight, Report, Demo, XFF, Hostfilter, .gz
npm run test:sanitize # Log-Sanitizer prüfen
npm run audit:repo    # Repo-Hygiene gegen echte Logs/Archive/PII
npm run test:realworld # optional, wenn Real-World-Logs lokal im Cache liegen
npm run test:access-realworld # optional, wenn echte Combined-Access-Logs lokal liegen
npm run test:local-logs # optionaler Corpus unter ~/test-logs oder SERVERSTORY_LOCAL_LOG_DIR

Optionale Real-World-Fixtures:

npm run download:realworld -- epa,nasa
npm run download:access -- secrepo,elastic,lukaszog
npm run test:realworld
npm run test:access-realworld
npm run test:local-logs

Die heruntergeladenen Dateien liegen unter tests/realworld-cache/ bzw. tests/access-cache/ und werden nicht committet.

Interne Designentscheidungen, No-False-Confidence-Regeln und weitere Roadmap-Notizen stehen in docs/design-rationale.md.

Release

Release-Schritte stehen in docs/release-checklist.md. Die Download-ZIP wird mit npm run build:release erzeugt und mit npm run audit:release geprüft.

Lizenz

MIT - siehe LICENSE.