Codesphere Log Browser
Der Log Browser ist ein integriertes Observability-Tool, das die Fehlersuche bei Workloads in Codesphere vereinfacht. Er bietet eine einheitliche Ansicht der Logs deiner Anwendungsservices und der Ausführungslogs der Pipeline (z. B. historische Build-Step-Ausgaben). Durch die Zentralisierung dieser Streams hilft 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 abweichende Logging-Mechanismen verwenden.
Aktivierung des Log Browsers
Der Log Browser ist standardmäßig nicht aktiviert. Um zu starten, muss Monitoring zunächst sowohl für die Resources Group (Team) als auch für die einzelne Landscape aktiviert werden. Detaillierte Anweisungen findest du in unserem Artikel Aktivierung von Monitoring.
info
Nur Admins der Resource Group (Team) können die Monitoring-Plattform aktivieren.
Architektureller Überblick
Entsprechende barrierefreie Textbeschreibung
Verwendung des Log Browsers
Datenspeicherung und Aufbewahrung
- Aufbewahrungszeitraum: Logs werden 14 Tage aufbewahrt. Nach diesem Zeitraum werden die Daten automatisch gelöscht.
- Speicherlimits: Für die Log-Speicherung gilt ein Speicherkontingent. Wird dieses überschritten, werden die ältesten Logs automatisch überschrieben.
warnung
Das Deaktivieren von Monitoring auf Ebene der Resource Group (Team) löst eine sofortige, endgültige Löschung aller historischen Logs dieser Gruppe aus. Dieser Vorgang kann nicht rückgängig gemacht werden.
Filtern und Analysieren
-
Öffne innerhalb des Workspaces den Log Browser über die Schaltfläche in der linken Seitenleiste.
Keine Daten zu sehen?
Das tritt normalerweise auf, wenn keine Anfragen deinen Kriterien entsprechen. Passe deine Filter an oder wähle einen anderen Zeitraum.
-
Filtere nach Servicename, Replica-ID, Ausführungsschritt oder Schweregrad.
-
Suche & erweiterte Syntax Verwende die Suchleiste, um bestimmte Einträge mit folgenden Operatoren zu finden:
| Operator | Syntax | Beschreibung |
|---|---|---|
| Platzhalter | auth-* | Findet beliebige Zeichenfolgen (z. B. auth-service, auth-error). |
| Exakte Phrasen | "Database failed" | Findet diese spezifische Phrase in genau dieser Reihenfolge. |
| Schlüsselwörter | ERROR | Isoliert Logs anhand einfachen Textinhalts. |
- Attribut-Filterschaltflächen Erweitere einen Log-Eintrag und verwende die Lupensymbole:
- Plus (+): Fügt das Attribut (z. B. Servicename) zu den aktiven Filtern hinzu.
- Minus (-): Schließt dieses Attribut aus deiner Ansicht aus.
-
Zeitfilterung: Verwende die Zeitauswahl, um bestimmte historische Zeiträume zu untersuchen.
-
Geteilter Bildschirm: Zeige Log Browser und Request Browser für eine tiefgehende Fehlersuche nebeneinander an. (Hinweis: Sowohl die Log- als auch die Trace-Erfassung müssen aktiv sein.)
Fehlerbehebung & häufige Fehler
| Fehler/Meldung | Ursache | Lösung/Beispiel |
|---|---|---|
| Logs sind leer | App gibt nichts an stdout/stderr aus oder falscher Run-Befehl. | Verwende console.log() (Node) oder print() (Python). Überprüfe ci.yml. |
| Keine Anfragen entsprechen | Filterkriterien sind zu restriktiv. | Passe Filter oder Zeitraum an. |
| Zeitzonenverwirrung | Logs sind mit Zeitstempeln in UTC versehen. | Passe die lokale Wahrnehmung an oder verwende einen Viewer mit Zeitzonenumrechnung. |
Wie Codesphere Logs erfasst
Codesphere verwendet OpenTelemetry (OTel), ein Standard-Framework der Branche, zur Datenverarbeitung.
Es folgt einem einheitlichen Format: Metadaten (Replica-IDs, Servicenamen) werden automatisch angehängt.
Häufig gestellte Fragen
-
Wie lange werden Logs aufbewahrt? Logs werden 14 Tage aufbewahrt. Warnung: Das Deaktivieren von Monitoring auf Team-Ebene löscht alle Logs sofort und endgültig.
-
Wie werden Logs erfasst? Logs werden aus den stdout/stderr-Streams der jeweiligen Ausführungsschritte jedes Services erfasst. Diese Daten werden dann zur Speicherung und Analyse an die Observability-Plattform übertragen.
-
Können Logs exportiert werden? Derzeit können Logs nicht direkt als Datei (CSV/TXT) exportiert werden. Für eine langfristige Auditierung empfehlen wir das manuelle Kopieren.
Hast du einen Feature-Wunsch?
Hilf uns, die Zukunft von Codesphere zu gestalten. Du kannst neue Features vorschlagen oder über die Community-Roadmap abstimmen unter feedback.codesphere.com.
-
Warum sehe ich keine Daten in der Tabelle? Um eine exakte 1:1-Zuordnung zwischen Traces und Logs zu gewährleisten, sollte deine Anwendung OpenTelemetry-Standards nutzen. Wird OpenTelemetry nicht erkannt, greift das System auf die Zuordnung über Zeitstempel zurück. Diese ist in der Regel zuverlässig, kann jedoch gelegentlich benachbarte Logs anstatt der exakten, für die Anfrage verantwortlichen Zeile anzeigen.
-
Warum kann ich die Log-Erfassung nicht aktivieren? Wahrscheinlich benötigst du Admin-Berechtigungen für die Resource Group (Team). Wende dich an deinen Admin, um Monitoring zu aktivieren.