Tasks
Der Bereich Tasks (Aufgaben) zeigt automatisierte oder manuell angestoßene Prozesse innerhalb des Systems an – beispielsweise das Erstellen einer VM, das Ausrollen einer Veranstaltung oder das Senden von E-Mails.
Hier kannst du laufende Tasks überwachen, Fehler erkennen und abgeschlossene Prozesse nachvollziehen.
Unterschied zwischen Tasks und SubTasks
Ein Task repräsentiert einen übergeordneten Prozess, wie z. B. das „Erstellen einer VM“ oder das „Versenden einer E-Mail“.
Ein SubTask ist hingegen ein einzelner Arbeitsschritt innerhalb dieses Prozesses – beispielsweise das Klonen einer VM-Vorlage oder das Aktualisieren einer Datenbank.
Mehrere SubTasks können gemeinsam zu einem Task gehören und bilden zusammen den vollständigen Ablauf.
- Tasks dienen der Übersicht und Nachverfolgung des gesamten Prozesses.
- SubTasks ermöglichen eine detaillierte Analyse einzelner Schritte, inklusive Fehlerbehandlung und Wiederholungen.
- Bei einem Fehlschlag eines SubTasks kann dieser einzeln erneut ausgeführt werden, ohne den gesamten Task neu zu starten.
Wo finde ich den Bereich?
Über das Hauptmenü: System → Tasks
Alternativ erreichbar über: Über Benachrichtigungen oder die Detailansicht von Objekten verlinkt
Funktionen im Überblick
- Anzeige aller laufenden, geplanten und abgeschlossenen Tasks im System
- Filterung nach Status, Benutzer oder Zeitraum
- Einsicht in Fehlerprotokolle und Systemmeldungen
- Überwachung des Fortschritts einzelner Prozesse
- Automatische Aktualisierung laufender Tasks
Wichtige Felder im Überblick
- Task
- SubTask
| Feldname | Beschreibung |
|---|---|
Aktualisiert am | (Standardfeld) Zeitpunkt, zu dem der Task abgeschlossen oder zuletzt aktualisiert wurde. |
Erstellt am | (Standardfeld) Zeitpunkt, zu dem der Task erstellt wurde. |
Erstellt von | (Standardfeld) Benutzer, der den Task erstellt hat. |
ID | Eindeutige Kennung des Tasks. Wird automatisch vergeben und dient der Nachverfolgung einzelner Prozesse. |
Name | Bezeichnung oder Typ des Tasks, z. B. „VM erstellen“ oder „E-Mail senden“. Erleichtert die Identifizierung im Taskprotokoll. |
Status | Aktueller Status des Tasks, z. B. *running*, *queued*, *failed* oder *success*. |
Veranstaltung | (Optional) Zugewiesene Veranstaltung, durch die dieser Task ausgelöst wurde. |
| Feldname | Beschreibung |
|---|---|
Aktion | Aktion, die im Rahmen des SubTasks ausgeführt wird. |
Aktualisiert am | (Standardfeld) Zeitpunkt, zu dem der SubTask abgeschlossen oder zuletzt aktualisiert wurde. |
Antwort Code | Antwortcode des SubTasks nach Abschluss der Aktion, z. B. HTTP-Statuscode oder systemspezifischer Rückgabewert. |
Antwort Meldung | Ausgabe- oder Fehlermeldung, die während der Ausführung des SubTasks generiert wurde. Dient der Nachvollziehbarkeit und Fehleranalyse. |
Erstellt am | (Standardfeld) Zeitpunkt, zu dem der SubTask erstellt wurde. |
Erstellt von | (Standardfeld) Benutzer, der den SubTask erstellt hat. |
ID | Eindeutige Kennung des SubTasks. Wird automatisch vergeben und dient der Nachverfolgung einzelner Prozesse. |
Job ID | Interne Referenz-ID des Hintergrundjobs (RQ-Job), mit dem der SubTask verknüpft ist. |
Name | Bezeichnung oder Typ des SubTasks, z. B. „VM erstellen“ oder „E-Mail senden“. Erleichtert die Identifizierung im Taskprotokoll. |
Objekt ID | Eindeutige Kennung (UUID) des Objekts, auf das sich der SubTask bezieht. |
Objekt Typ | Typ des Objekts, auf das sich der SubTask bezieht, z. B. **vm**, **template**, **event** oder **mail**. |
Status | Aktueller Status des SubTasks, z. B. *running*, *queued*, *failed* oder *success*. |
Übergeordneter Task | Eindeutige Kennung des übergeordneten Tasks, zu dem dieser SubTask gehört. |
Versuch | Zähler, der angibt, wie oft der SubTask bereits ausgeführt wurde. Wird bei jedem Wiederholungsversuch automatisch erhöht. |
Anzeigen eines Tasks / SubTasks
- Öffne im Hauptmenü den Bereich System → Tasks.
- Suche in der Liste nach dem gewünschten Task.
- Klicke auf den gewünschten Task, um die Details anzuzeigen.
- Im Detailbereich siehst du den Status, die Beschreibung und die zugehörigen SubTasks.
Wiederholen eines SubTasks
- Öffne im Hauptmenü den Bereich System → Tasks.
- Suche in der Liste nach dem gewünschten Task und öffne diesen.
- Wechsle in den Tab SubTasks und öffne den gewünschten SubTask.
- Klicke auf Wiederholen.
- Bestätige den Vorgang im angezeigten Dialog.
- Der SubTask wird nun erneut ausgeführt.
Aktuell können nur SubTasks wiederholt werden, die nicht älter als 24 Stunden sind.
Wenn aufgrund eines fehlgeschlagenen SubTasks nachgelagerte Tasks nicht ausgeführt werden konnten, führt das erfolgreiche Wiederholen des SubTasks zur Ausführung dieser abhängigen Tasks.
Beispiel oder Anwendungsfall
Eine Administratorin startet die Erstellung mehrerer virtueller Maschinen. Im Bereich System → Tasks sieht sie, dass der Task „VM erstellen“ läuft und bereits ein Teil abgeschlossen ist. Bei einem Fehler könnte sie das Protokoll öffnen, um den Grund (z. B. unzureichende Ressourcen) direkt zu identifizieren und zu beheben.
Hinweise / Besonderheiten
- Tasks werden vom System automatisch erstellt, wenn ein Prozess gestartet wird.
- Bei Systemfehlern wird der Status auf failed gesetzt; die Details findest du im Taskprotokoll.
- Tasks mit dem Status queued warten auf verfügbare Ressourcen oder abhängige Prozesse.
- Abgeschlossene Tasks bleiben für eine begrenzte Zeit einsehbar und werden danach automatisch gelöscht.
- Die Anzeige aktualisiert sich regelmäßig, solange der Bereich geöffnet ist.
Beziehungen zu anderen Objekten
Viele Objekte in OpenVLE stehen in Beziehung zu anderen Elementen innerhalb des Systems. Die folgende Übersicht zeigt, welche Verknüpfungen bestehen und ob diese bestimmte Automatisierungen auslösen.
| Objekt | Beschreibung | Automatisches Verhalten |
|---|---|---|
| E-Mails | Einer E-Mail können beliebig viele Tasks zugewiesen werden. | Tasks werden bei bestimmten Aktionen der E-Mail automatisch erstellt. |
| SubTasks | Einem SubTask kann genau ein Task zugewiesen werden | Tasks & SubTasks werden bei bestimmten Aktionen automatisch erstellt. |
| Tasks | Einem Task können beliebig viele SubTasks zugewiesen werden. | Tasks & SubTasks werden bei bestimmten Aktionen automatisch erstellt. |
| Veranstaltungen | Einer Veranstaltung können beliebig viele Tasks zugewiesen werden. | Tasks werden bei bestimmten Aktionen der Veranstaltung automatisch erstellt. |
| Verbindungen | Einer Verbindung können beliebig viele Tasks zugewiesen werden. | Tasks werden bei bestimmten Aktionen der Verbindung automatisch erstellt. |
| VM-Vorlagen | Einer VM-Vorlage können beliebig viele Tasks zugewiesen werden. | Tasks werden bei bestimmten Aktionen der VM-Vorlage automatisch erstellt. |
| VMs | Einer VM können beliebig viele Tasks zugewiesen werden. | Tasks werden bei bestimmten Aktionen der VM automatisch erstellt. |
Erforderliche Berechtigungen
Die für Aktionen benötigten Berechtigungen können über Rollen oder individuell vergeben werden. Fehlen Ihnen bestimmte Rechte, sind die entsprechenden Funktionen in der Benutzeroberfläche ausgeblendet oder deaktiviert.
| Aktion | Benötigte Berechtigung | Pfad | Weitere Informationen |
|---|---|---|---|
| Tasks anzeigen | tasks_read | / | |
| Subtasks anzeigen | sub_tasks_read | / |