Zum Hauptinhalt springen
Version: Weekly Build

Codesphere Log Browser

Der Log Browser ist ein integriertes Observability-Tool, das entwickelt wurde, um das Debugging von Workloads in Codesphere zu vereinfachen. Er bietet eine einheitliche Ansicht der Logs deiner Anwendungsdienste und der Pipeline-Ausführungslogs (z. B. historische Build-Step-Ausgaben). Durch die Zentralisierung dieser Datenströme hilft dir der Log Browser dabei, schnell von der Erkennung eines Problems zur Identifikation der Ursache zu gelangen.

Reactive Services

Diese Log-Erfassung gilt derzeit für Codesphere Reactive Services. Andere Runtime-Typen können über andere Logging-Mechanismen verfügen.

So aktivierst du den Log Browser​

Der Log Browser ist standardmäßig nicht aktiviert. Um loszulegen, muss Monitoring zunächst sowohl in der Resource Group als auch in der jeweiligen Landscape aktiviert werden. Eine detaillierte Anleitung findest du in unserem Artikel Monitoring aktivieren.

info

Nur Resource-Group-Admins können die Monitoring-Plattform aktivieren.

Architekturübersicht​

Log Browser Architektur

Entsprechende barrierefreie Textbeschreibung

Verwendung des Log Browsers​

Datenaufbewahrung und Speicherung​

  • Aufbewahrungszeitraum: Logs werden 14 Tage lang aufbewahrt. Nach Ablauf dieses Zeitraums werden die Daten automatisch gelöscht.
  • Speicherlimits: Die Log-Speicherung unterliegt einem Speicherkontingent. Bei Überschreitung werden die ältesten Logs automatisch überschrieben.
warnung

Das Deaktivieren von Monitoring auf Ebene der Resource Group löst eine sofortige, dauerhafte Löschung aller historischen Logs dieser Gruppe aus. Diese Aktion kann nicht rückgängig gemacht werden.

Filtern und Analyse​

  1. Öffne innerhalb des Workspace den Log Browser über die Schaltfläche in der linken Seitenleiste. Log-Browser-Schaltfläche im Workspace
    Leerer Log-Browser-Bildschirm

    Keine Daten sichtbar?

    Dies tritt normalerweise auf, wenn keine Anfragen deinen Kriterien entsprechen. Passe deine Filter an oder wähle einen anderen Zeitraum aus.

  2. Filtere nach Service-Name, Replica-ID, Ausführungsschritt oder Schweregrad. Log-Browser-Filter

  3. Suche & erweiterte Syntax Verwende die Suchleiste, um mit folgenden Operatoren bestimmte Einträge zu finden: Log-Browser-Suche

OperatorSyntaxBeschreibung
Platzhalterauth-*Findet jede beliebige Zeichenfolge (z. B. auth-service, auth-error).
Exakte Phrasen"Database failed"Findet diese spezifische Phrase in genau dieser Reihenfolge.
SchlüsselwörterERRORIsoliert Logs anhand des einfachen Textinhalts.
  1. Attribut-Filterschaltflächen Erweitere einen Log-Eintrag und verwende die Lupensymbole:
  • Plus (+): Fügt das Attribut (z. B. Service-Name) zu den aktiven Filtern hinzu.
  • Minus (-): Schließt dieses Attribut aus deiner Ansicht aus. Log-Browser-Filterschaltflächen

  1. Zeitfilterung: Verwende die Zeitauswahl, um bestimmte historische Zeiträume zu untersuchen. Log-Browser-Zeitfilter

  2. Geteilter Bildschirm: Zeige Log Browser und Request Browser für ein tiefgehendes Debugging nebeneinander an. (Hinweis: Sowohl Log- als auch Trace-Erfassung müssen aktiv sein.) Log-Browser geteilter Bildschirm

Fehlerbehebung & häufige Fehler​

Fehler/MeldungUrsacheLösung/Beispiel
Logs sind leerApp gibt nichts an stdout/stderr aus oder falscher Run-Befehl.Verwende console.log() (Node) oder print() (Python). Überprüfe ci.yml.
Keine Anfragen entsprechenFilterkriterien sind zu restriktiv.Passe Filter oder Zeitraum an.
Verwirrung bei der ZeitzoneLogs sind mit UTC-Zeitstempeln versehen.Passe die lokale Wahrnehmung an oder nutze einen Viewer mit Zeitzonenumrechnung.

Wie Codesphere Logs erfasst​

Codesphere verwendet OpenTelemetry (OTel), ein branchenübliches Standard-Framework, zur Verarbeitung von Daten.
Es folgt einem einheitlichen Format: Metadaten (Replica-IDs, Service-Namen) werden automatisch angehängt.

Häufig gestellte Fragen​

  1. Wie lange werden Logs aufbewahrt? Logs werden 14 Tage lang aufbewahrt. Warnung: Das Deaktivieren von Monitoring auf Ebene der Resource Group löscht alle Logs sofort und dauerhaft.

  2. Wie werden Logs erfasst? Logs werden aus den stdout/stderr-Streams der Ausführungsschritte jedes Services erfasst. Diese Daten werden anschließend zur Speicherung und Analyse an die Observability-Plattform übertragen.

  3. Können Logs exportiert werden? Derzeit können Logs nicht direkt als Datei (CSV/TXT) exportiert werden. Für eine langfristige Auditierung empfehlen wir manuelles Kopieren.

    Hast du einen Feature-Wunsch?

    Hilf uns, die Zukunft von Codesphere mitzugestalten. Du kannst neue Funktionen vorschlagen oder über die Community-Roadmap abstimmen unter feedback.codesphere.com.

  4. Warum sehe ich keine Daten in der Tabelle? Um eine exakte 1:1-Zuordnung zwischen Traces und Logs sicherzustellen, sollte deine Anwendung OpenTelemetry-Standards nutzen. Wird OpenTelemetry nicht erkannt, greift das System auf eine Zeitstempel-Korrelation zurück. Diese ist in der Regel zuverlässig, kann aber gelegentlich nahegelegene Logs anstelle der exakten, für die Anfrage verantwortlichen Zeile anzeigen.

  5. Warum kann ich die Log-Erfassung nicht aktivieren? Du benötigst wahrscheinlich Admin-Berechtigungen für die Resource Group. Wende dich an deinen Admin, um Monitoring zu aktivieren.