Cronjobdetails

Auf der Übersicht Cronjobs siehst du, ob und wann ein Hintergrundauftrag laufen soll. Diese Seite beantwortet die Anschlussfrage: Ist er wirklich gelaufen, und was ist dabei passiert? Du findest hier Zeitplan und Befehl eines einzelnen Cronjobs im Detail, seine vollständige Ausführungshistorie mit Ergebnis und Protokollausgabe jedes Laufs, und kannst ihn hier auch unabhängig vom Zeitplan sofort manuell auslösen — praktisch, um eine gerade geänderte Konfiguration ohne Wartezeit zu testen oder einen fehlgeschlagenen Lauf erneut zu versuchen.

Anzeige und Navigation

Zeitplan, Befehl und Grunddaten im Überblick

Drei Blöcke im Kopfbereich bilden genau die Fragen ab, die du an einen Cronjob hast: Allgemeine Informationen zeigt Name, Beschreibung und den Aktiv-Status, Wann den Cron-Ausdruck roh (z. B. „13 3 * * *“) sowie darunter Menschenlesbar als ausformulierte deutsche Übersetzung (bei „13 3 * * *“ etwa „um Minute(n) 13, um Stunde(n) 3, jeden Tag des Monats, jeden Monat, jeden Tag der Woche“ — gemeint: täglich um 3:13 Uhr) und den Zeitpunkt des letzten Laufs (oder Nie), und Was den hinterlegten Befehl in einer grauen Box — den technischen Auftrag, den flinkest bei jeder Ausführung anstößt. Eine längere Beschreibung wird zunächst nur mit den ersten Wörtern angezeigt; den vollständigen Text siehst du, sobald du mit der Maus darüberfährst.

Zur Liste zurückfinden

Der Breadcrumb oben („Einstellungen / Cronjobs / ‹Name›“) führt mit einem Klick auf Cronjobs zurück zur Übersicht Cronjobs. Zusätzlich merkt sich flinkest jeden besuchten Cronjob im „Zuletzt besucht“-Panel — praktisch, wenn du beim Debuggen eines Ausfalls zwischen mehreren Cronjob-Detailseiten hin- und herspringst.

Nicht (mehr) existierender Cronjob

Ruft die Adresse eine Cronjob-ID auf, die es nicht oder nicht mehr gibt — etwa weil er zwischenzeitlich in einem anderen Fenster gelöscht wurde —, zeigt flinkest eine Fehlermeldung und navigiert automatisch zurück zur Liste Cronjobs, statt eine leere Detailseite stehen zu lassen. Kommt vom Server keine eigene Meldung (etwa bei einer abgerissenen Verbindung), lautet sie „Cronjob konnte nicht geladen werden“.

Ausführungsprotokoll

Ausführungsprotokoll ansehen

Links unter dem Kopfbereich listet das Panel Ausführungsprotokoll jeden bisherigen Lauf dieses Cronjobs — Spalten Status (grün „Erfolg“ oder rot „Fehlgeschlagen“), Ausführungszeit und Dauer —, standardmäßig nach Ausführungszeit absteigend sortiert. Ein Lauf ohne jede Dauerangabe (z. B. weil er noch nicht abgeschlossen protokolliert wurde) zeigt an dieser Stelle einen Strich.

Protokollzeile aufklappen

Ein Pfeil links an jeder Zeile klappt sie auf und zeigt Ergebnis — den rohen Ergebniswert ok oder failed — sowie, sofern der Lauf eine Ausgabe erzeugt hat, darunter Protokoll-Ausgabe mit der vollständigen Programmausgabe genau dieses einen Laufs. Ein Lauf ganz ohne Ausgabe zeigt diesen zweiten Bereich gar nicht erst an. Diese beiden Überschriften sind bewusst unterschiedlich benannt vom Panel-Titel „Ausführungsprotokoll“ darüber — damit „alle Läufe“ und „ein einzelner Lauf“ nicht wie derselbe Bereich wirken.

Fehlgeschlagene Läufe zusätzlich im Systemprotokoll. Schlägt eine Ausführung fehl, hält flinkest das zusätzlich im allgemeinen Systemprotokoll fest. Erfolgreiche Läufe tauchen dort nicht auf — die vollständige Historie, erfolgreich wie fehlgeschlagen, findest du nur hier im Ausführungsprotokoll.

Abgebrochen wegen Zeitüberschreitung. Jeder Lauf hat ein Zeitlimit (siehe „Zeitlimit und keine doppelten Läufe“ auf der Liste). Überschreitet ein Lauf es, beendet flinkest ihn; im Protokoll steht er dann als „Fehlgeschlagen“, und am Ende seiner Protokoll-Ausgabe steht ein Vermerk, nach wie vielen Sekunden er beendet wurde.

Ausführungsprotokoll sortieren und durchblättern

Über die Spaltenköpfe Status, Ausführungszeit oder Dauer sortierst du das Protokoll um — praktisch, um schnell den zuletzt fehlgeschlagenen oder einen ungewöhnlich langen Lauf zu finden. Standardmäßig zeigt eine Seite 25 Einträge; darunter blätterst du mit der üblichen Leiste (Erste/Vorherige/Nächste/Letzte Seite, wählbare Zeilenzahl 10–200). Ein Kreispfeil-Symbol im Paginator lädt das Protokoll unabhängig davon manuell neu.

Ausführungsprotokoll bleibt aktuell

Läuft der reale Hintergrund-Scheduler minütlich weiter oder führt ein zweiter Administrator den Job manuell aus, erscheint der neue Protokolleintrag automatisch, ohne dass du die Seite neu laden musst. Der Wert Letzter Lauf im Block Wann zieht dabei ebenfalls sofort nach.

Aktionen im Kopfbereich

Cronjob jetzt ausführen

Oben rechts startet Jetzt ausführen den hinterlegten Befehl sofort — unabhängig vom Zeitplan und auch dann, wenn der Cronjob gerade deaktiviert ist: Der Aktiv-Schalter steuert ausschließlich, ob der automatische Scheduler den Job berücksichtigt, nicht den manuellen Sofortlauf. So lässt sich ein frisch angelegter oder gerade deaktivierter Cronjob schon testen, bevor er scharf geschaltet wird, oder ein fehlgeschlagener Lauf (etwa der Rechnungslauf) ohne Wartezeit erneut versuchen. Eine Rückfrage „Möchten Sie diesen Cronjob jetzt wirklich ausführen?“ mit Ja, ausführen verhindert ein versehentliches Auslösen per Fehlklick.

Der Lauf geht in den Hintergrund. Nach der Bestätigung meldet flinkest „Der Cronjob läuft im Hintergrund. Das Ergebnis erscheint im Protokoll.“ — du kannst sofort weiterarbeiten, auch bei einem Job, der mehrere Minuten braucht. Ist er fertig, bekommst du eine Benachrichtigung „Cronjob erfolgreich ausgeführt“ beziehungsweise „Cronjob-Ausführung fehlgeschlagen“ mit dem Link Protokoll anzeigen; zugleich erscheint der neue Lauf oben im Ausführungsprotokoll, und Letzter Lauf zieht ohne Neuladen der Seite nach. Ein manueller Lauf hat dasselbe Zeitlimit wie ein geplanter, höchstens aber 25 Minuten.

Kein doppelter Start. Läuft derselbe Cronjob gerade schon — nach Zeitplan oder weil ihn jemand anderes gestartet hat —, wird der zweite Start nicht ausgeführt; die Benachrichtigung meldet dann „Cronjob-Ausführung fehlgeschlagen“ mit dem Hinweis „Der Cronjob läuft bereits“. Versuch es einfach etwas später noch einmal.

Bei „Hintergrundaufgaben abarbeiten“ fehlt die Schaltfläche. Dieser Cronjob arbeitet die Hintergrundaufgaben selbst ab — auch die manuellen Läufe — und lässt sich deshalb nicht von Hand starten; die Schnittstelle lehnt einen solchen Versuch mit „Dieser Cronjob läuft automatisch und kann nicht manuell gestartet werden“ ab.

Cronjob bearbeiten

Bearbeiten öffnet denselben Dialog wie auf der Liste Cronjobs — Schalter aktiv, Name, Beschreibung, Befehl und der Zeitplan-Editor mit den Reitern Minuten/Stunden/Tage im Monat/Monate/Wochentage sowie einem manuellen Ausdruck —, hier direkt im Kontext der laufenden Diagnose, ohne auf die Liste wechseln zu müssen. Speichern aktualisiert die Detailseite inline, inklusive eines neu berechneten Breadcrumbs bei einer Namensänderung; schließt du den Dialog stattdessen mit offenen Änderungen, fragt flinkest vorher nach, ob du sie wirklich verwerfen willst.

Cronjob löschen

Über das „…“-Menü im Kopfbereich (nicht als eigene Schaltfläche, da bei nur einem Zusatzpunkt eingeklappt) steht Löschen bereit. Nach der Rückfrage „Löschen von ‹Name›“ verschwindet der Cronjob endgültig — inklusive seiner gesamten Ausführungshistorie im Ausführungsprotokoll, die automatisch mitgelöscht wird — und du landest wieder auf der Übersicht Cronjobs. Schlägt das Löschen serverseitig fehl, bleibt der Cronjob bestehen und flinkest zeigt dazu eine Fehlermeldung.

Zugriff

Nur für Administratoren erreichbar

Diese Seite und jede Aktion darauf — Ansehen, Jetzt ausführen, Bearbeiten, Löschen — verlangt die Administratorrolle, dieselbe strenge Regel wie auf der Liste Cronjobs: Der gesamte Einstellungsbereich ist ohne diese Rolle nicht aufrufbar — ein direkter Aufruf landet auf der Seite „Nicht erlaubt“ (403) —, zusätzlich prüft die Schnittstelle selbst jede der Aktionen noch einmal einzeln.

Verwandte Seiten

• Cronjobs
• Systemprotokoll

Häufige Fragen

Was passiert, wenn ich einen inaktiven Cronjob über „Jetzt ausführen“ starte? Er läuft trotzdem — Jetzt ausführen berücksichtigt den Status Aktiv nicht. Der Cronjob wird dadurch nicht automatisch nach seinem Zeitplan gestartet, lässt sich aber jederzeit manuell testen.

Warum steht bei „Letzter Lauf“ „Nie“? Der Cronjob wurde noch nie ausgeführt — weder automatisch nach seinem Zeitplan noch manuell über Jetzt ausführen.

Was bedeutet der Status „Fehlgeschlagen“ im Ausführungsprotokoll? Der hinterlegte Befehl hat bei diesem Lauf einen Fehler zurückgemeldet oder wurde wegen Zeitüberschreitung beendet. Klapp die Zeile über den Pfeil links auf, um unter Protokoll-Ausgabe die vollständige Ausgabe des Befehls zu lesen, sofern eine vorhanden ist; zusätzlich steht ein fehlgeschlagener Lauf auch im allgemeinen Systemprotokoll.

Kann ich einen Cronjob deaktivieren, ohne ihn zu löschen? Ja. Öffne Bearbeiten und schalte aktiv aus. Der Zeitplan bleibt gespeichert, flinkest führt den Job dann aber nicht mehr automatisch aus — manuell über Jetzt ausführen bleibt er trotzdem jederzeit testbar.

Warum verschwinden beim Löschen auch alte Protokolleinträge? Die Ausführungshistorie eines Cronjobs hängt fest an ihm. Löschst du den Cronjob, entfernt flinkest automatisch auch alle zugehörigen Einträge im Ausführungsprotokoll — dafür gibt es keine gesonderte Rückfrage, die Löschbestätigung des Cronjobs deckt beides ab.