98801 Monitor-Objekte

Alle Verarbeitungen, welche mit einem Monitor-Objekt verbunden sind, können in diesem BC überwacht werden. Sie sehen auf einen Blick, welche Verarbeitungen gerade laufen oder bereits beendet oder nicht - wie geplant - gestartet wurden.
Das BC können Sie sowohl im Cloud-Client-Modus als auch im Classic-Client-Modus im OpaccERP Explorer über den Schnellzugriff öffnen. Im Classic-Client-Modus können Sie das BC zusätzlich mit dem Button <Monitor-Objekte> im BC 98800 System Monitor öffnen.

               
Allgemeine Informationen zu Monitor-Objekten
Applikationspool-Verarbeitungen, Agents und Services erzeugen automatisch ein Monitor-Objekt, über welches man die Verarbeitung beobachten und überwachen kann.
Es ist auch möglich, Monitor-Objekte durch F-Scripts, BOF-Scripts oder Drittanwendungen zu erzeugen, so dass sich diese Verarbeitungen ebenfalls durch Monitor-Objekte überwachen und allenfalls abbrechen und beenden lassen.
F-Scripts, BOF-Scripts und Drittanwendung müssen entsprechend codiert sein müssen, damit sie über das Monitor-Objekt beendet werden können.
Alle Monitor-Objekte, die älter als 3 Monate sind, werden automatisch gelöscht.
Monitor-Objekte können sowohl im Cloud-Client-Modus als auch im Classic-Client-Modus beobachtet werden (BC 98804 Monitor-Objekt beobachten, Aufruf mit Button <Verarbeitung beobachten...>) und, wenn das Objekt es zulässt, beendet werden.
Im Classic-Client-Modus wird die Fortschrittsvisualisierung für einen aktiven Applikationspool über einen dünnen grünen Balken direkt in den Attributen Verarbeitung, Job und Schritt angezeigt. Im Cloud-Client-Modus wird die Fortschrittsvisualisierung für einen aktiven Applikationspool neben den Attributen Verarbeitung, Job und Schritt jeweils über eine Progress Bar (oranger Balken in Bewegung) angezeigt. Eine Aktualisierung erfolgt automatisch alle 2 Sekunden.
Abgeschlossene Objekte oder Objekte ohne Rückmeldung werden im Cloud-Client-Modus mit einer statischen grauen Progress Bar und im Classic-Modus-Client mit einem grauen Balken neben den Attributen Verarbeitung, Job und Schritt angezeigt.

Filter

Alle von Ihnen getroffenen Filter-Einstellungen können Sie in einer BC-Vorlage speichern.

Status der Verarbeitung:

Hier können Sie die Anzeige der Verarbeitungen allein oder zusätzlich nach ihrem Verarbeitungsstatus filtern. Folgende Auswahlmöglichkeiten haben Sie:
  • Alle
  • Nicht gestartet (Icon: Quadrat weiss, Statuscode: 0)
  • Wird ausgeführt (Icon: Quadrat grün, Statuscode: 1)
  • keine Rückmeldung (Icon: Quadrat gelb, Statuscode: 10)
  • Normal beendet (Icon: Quadrat grün, Statuscode: 20)
  • Beendet mit Fehler (Icon: Quadrat rot, Statuscode: 21)
  • Durch Anwender gestoppt (Icon: Quadrat gelb, Statuscode: 22)
  • Durch Timeout beendet (Icon: Quadrat gelb, Statuscode: 25)
  • Beendet ohne Rückmeldung (Icon: Quadrat gelb mit Fragezeichen, Statuscode: 28)
  • Unbekannt (Icon: Quadrat weiss, Statuscode: 99)

Verarbeitung

In dieser Gruppe können Sie die Anzeige der Verarbeitungen allein oder zusätzlich auf eine bestimmte Gruppierung von Monitor-Objekten, z.B. „Opacc.Search.Agent.Indexing.1-Art“ oder „Opacc.Bus.Biz.AppPool_Process“ einschränken.

Verarbeitungs-Name:

Hier können Sie die Anzeige der Verarbeitungen allein oder zusätzlich nach dem Namen der Verarbeitung filtern.

Verarbeitungs-Start-Datum von: ... bis: ...

Hier können Sie die Anzeige der Verarbeitung auf einen von Ihnen festgelegten Zeitraum einschränken. Beim Öffnen des BC ist standardmässig ein Filter auf die letzten 3 Tage gesetzt. Folgende Komfortfilter stehen zur Auswahl:
  • Heute
  • Gestern
  • 3- Tage zurück (Default-Einstellung)
  • 1 Woche zurück
  • 2 Wochen zurück
  • Benutzerdefiniert

Monitor-Id:

Hier können Sie die Anzeige der Verarbeitungen allein oder zusätzlich auf die ID des Monitor-Objekts begrenzen.

Rechner-Name:

Hier können Sie die Anzeige der Verarbeitungen allein oder zusätzlich auf den Namen der ausführenden Maschine begrenzen.

Windows-User:

Hier können Sie die Anzeige der Verarbeitungen allein oder zusätzlich auf den Windows-Benutzer einschränken, unter dessen Namen die Verarbeitung läuft.

Buttons

Mit dem Button <Suchen> starten Sie die Suche unter Berücksichtigung der gewählten Filterkriterien.
Mit dem Button <Clear> können Sie alle Angaben in den Filter-Attributen löschen.

Resultat

In dieser Tabelle werden alle selektierten Verarbeitungen angezeigt. Folgende Attribute werden angezeigt:
Status - Status-Bezeichnung - Monitor-Id - Bezeichnung der Verarbeitung - Startzeit - Dauer - Ausführender Mandant - Rechner - Windows-Benutzer - Rechner-PID - Name des Windows-Service - Verarbeitungsstatus - Verarbeitungsstatus-Bezeichnung - Quittiert J/N - Info - Log-Meldung

Verarbeitung

In dieser Gruppe werden alle Informationen zur Verarbeitung (Verarbeitung, Job, Schritt) angezeigt.

Verarbeitung:

Hier werden der Name der Verarbeitung sowie die Startzeit der Verarbeitung und die (bisherige) Dauer der Verarbeitung angezeigt.

Job:

Hier werden der Name des Jobs angezeigt, der (aktuell) innerhalb der Verarbeitung läuft sowie dessen Startzeit und (bisherige) Dauer.

Schritt:

Hier werden der Name des aktuell ausgeführten Verarbeitungsschritts angezeigt, sowie dessen Startzeit und dessen (bisherige) Dauer.

Details

Diese Gruppe können Sie mit +/- ein- und ausblenden.
In dieser Gruppe werden Detailinformationen zur Verarbeitung angezeigt.

Monitor-Status:

Hier wird der Status des bei der Ausführung der Verarbeitung erstellten Monitor-Objekts angezeigt. Der Status bildet eine Kombination aus 'Verarbeitungs-Status', 'Log-Status' und 'Quittieren' ab.
  • Icon weiss = Unbestimmt
  • Icon weiss = Unbestimmt quittiert
  • Icon grün = Normal
  • Icon Grün = Normal quittiert
  • Icon gelb = Warnung
  • Icon gelb = Warnung quittiert
  • Icon rot = Fehler
  • Icon rot =Fehler quittiert

Verarbeitungs-Gruppe:

Hier wird die Bezeichnung der Gruppe, zu der die Verarbeitung gehört, angezeigt. Beispiel für eine Gruppe sind: „Opacc.Search.Agent.Indexing.1-Art“ oder „Opacc.Bus.Biz.AppPool_Process“.

Status seit:

Hier wird der Zeitpunkt der letzten Status-Änderung angezeigt. Im Falle des Status 'nicht gestartet' bedeutet dies den Zeitpunkt des Erstellens des Monitor-Objekts.

Mandanten-Nr:

Hier wird die Nummer des Mandanten angezeigt, in welcher die Verarbeitung ausgeführt wird.

Rechner-Name:

Hier wird der Name des Rechners angezeigt, auf welchem die Verarbeitung ausgeführt wird.

Windows-Benutzer:

Hier wird der Name des Windows-Benutzers angezeigt, unter dem die Verarbeitung ausgeführt wird.

Verarbeitungs-Status:

Hier wird der Status bzw. der Fortschritt der Verarbeitung angezeigt:
  • Nicht gestartet (Icon: Quadrat weiss, Statuscode: 0)
  • Wird ausgeführt (Icon: Quadrat grün, Statuscode: 1)
  • keine Rückmeldung (Icon: Quadrat gelb, Statuscode: 10)
  • Normal beendet (Icon: Quadrat grün, Statuscode: 20)
  • Beendet mit Fehler (Icon: Quadrat rot, Statuscode: 21)
  • Durch Anwender gestoppt (Icon: Quadrat gelb, Statuscode: 22)
  • Durch Timeout beendet (Icon: Quadrat gelb, Statuscode: 25)
  • Beendet ohne Rückmeldung (Icon: Quadrat gelb mit Fragezeichen, Statuscode: 28)
    Dieser Status wird nach 60 Minuten automatisch auf den Monitor-Objekten gesetzt, sofern die Monitor-Objekte den Status 10 - Keine Rückmeldung haben und der Prozess gemäss Rechner-PID (ComputerPID) nicht mehr vorhanden ist.
    Notiz
    Notiz
    Der neue Status wird lediglich von ServiceBus-Instanzen unterstützt, welche unter einem Account mit lokalen Administrator-Rechten ausgeführt werden.
  • Unbekannt (Icon: Quadrat weiss, Statuscode: 99)
Beachten Sie, dass der Verarbeitungs-Status auf "Grün" (wird ausgeführt oder normal beendet) stehen kann, während der zugehörige Monitor-Status auf "Gelb" (Warnung) steht. Diese Konstellation kann dann auftreten, wenn eine Verarbeitung eine Warnung ausgegeben hat, jedoch ohne Folgefehler weiterläuft.

Monitor-Id:

Hier wird die Id des Monitor-Objekts angezeigt, unter dem die Verarbeitung ausgeführt wird.

Dauer des Status:

Hier wird die Zeit angezeigt, seit der sich die Verarbeitung in dem unter Verarbeitungs-Status angezeigten Status befindet.

Anwender-Nr:

Hier wird die Nummer des Benutzers angezeigt, welcher die Verarbeitung gestartet hat.

Rechner-PID:

Hier wird die Id des Prozesses angezeigt unter dem die Verarbeitung auf dem ausführenden Rechner läuft

Dialoge erlaubt:

Ist diese Checkbox aktiv, sind Server-seitige Interaktionen mit dem Anwender zugelassen. Diese Option kann für F-Scripts oder BOF-Scripts eingerichtet / programmiert werden.

Info:

Hier werden Informationen / Fehlermeldungen zum Verarbeitungs-Status hinterlegt sein. Bei einer fehlerhaften Applikationspool-Verarbeitung ist dies beispielsweise: "Err-348, Bitte kontrollieren Sie den Applikations-Pool: 4000!"

Log

Diese Gruppe können Sie mit +/- ein- und ausblenden.

Log-Daten

Log-Daten werden in Abhängigkeit von der jeweiligen Verarbeitung erstellt. Neben dem Log-Status und der Log-Meldung können die Log-Herkunft mit Log-Detailangaben, der Log-Mandant und Log-Benutzer, der Log-Computer und der Log-Prozess sowie der Log-Windows-User und Log-Thread protokolliert werden.

Log-Status:

Hier wird der Log-Status angezeigt. Folgende Werte kann der Lag-Status annehmen.
  • 0 - ProgressLogState
  • 10 - Info
  • 20 - Warnung
  • 30 - Fehler
Der Log-Status kann aber auch leer sein.

Log-Meldung:

Log-Meldungen können sowohl bei normal beendeten Verarbeitungen als auch bei Verarbeitungen, die mit einer Warnung oder einem Fehler abgeschlossen wurden, ausgegeben werden.
Beispiele: 
Normal abgeschlossen: "[Prc3804] Biz.Progress(1837092) 5.0506 ms"
mit Warnung abgeschlossen: "WasLab-Adressen_FULL_INDEXER has successfully finished working" 
mit Fehler abgeschlossen: "Err-348, Bitte, kontrollieren Sie den Applikations-Pool"
Nach dem erfolgreichen Quittieren eines Monitor-Objekt-Prozesses werden die folgenden Attribute automatisch gesetzt:

Gültige Quittierung vorhanden:

Nach dem erfolgreichen Quittieren eines Monitor-Objekt-Prozesses ist diese Checkbox aktiv.

Zeit der Quittierung:

Hier sind Datum und Uhrzeit eingetragen, an der die Quittierung erfolgte.

Quittierungs-Mandant: / Quittierungs-Anwender:

Hier werden der Mandant, in dem die Quittierung vorgenommen wurde und der Anwender, der die Quittierung durchgeführt hat, angezeigt.

Buttons

Der Button <Verarbeitung beobachten...> öffnet das gewählte Monitor Objekt im BC 98804 Monitor-Objekt beobachten. Dort werden Verarbeitungs-Detailinformationen und Logdaten (z.B. Log-Status und Log-Meldung) angezeigt. Sowohl im Classic-Client-Modus als auch im Cloud-Client-Modus können bei Monitor-Objekten mit Abbruchmöglichkeit die Verarbeitung, der Job oder der Schritt abgebrochen werden.
Notiz
Notiz
Der Titel des BC wird nicht mit "98804 Monitor-Objekt beobachten" angezeigt, sondern variiert in Abhängigkeit vom beobachteten Monitor-Objekt, z.B. Dms-Agent 7936@OCH-ERP2 für einen DMAS-Agent-Monitor-Objekt oder AppPool_Process -4000 für ein Applikationspool-Monitor-Objekt. Einem Namen ist jeweils die Mandanten-Nr gefolgt von einem "/" vorangestellt.

               
Mit dem Button <Verarbeitung abbrechen...> können Sie eine laufende Verarbeitung inkl. aller Teilschritte, vorausgesetzt die Verarbeitung sieht eine Abbruchmöglichkeit vor.

               
Mit dem Button <Job abbrechen...> können Sie den aktuell laufenden Job einer Verarbeitung abbrechen und falls vorhanden, den nächsten Job innerhalb der Verarbeitung starten.

               
Mit dem Button <Schritt abbrechen...> können Sie den laufenden Verarbeitungsschritt einer Verarbeitung abbrechen.

               
Der Button <Applikationspool beenden...> öffnet das BC 98803 Applikationspool beenden, in dem Sie gleichzeitig mehrere Applikationspools auf einmal beenden können.
Notiz
Notiz
Beachten Sie, dass die Applikationspool-Verarbeitung das Beenden unterstützen muss. Bei Applikationspools vom Typ F-Script muss die Prüfung auf das Beenden der Verarbeitung im jeweiligen F-Script implementiert sein.

               
Der Button <Monitor Objekte bereinigen...> öffnet das BC 98805 Monitor Objekte bereinigen. Dort können Sie Monitor-Objekte (Verarbeitungen) mit Status der Verarbeitung 10 - Keine Rückmeldung manuell bereinigen oder löschen. Beim Bereinigen werden die Monitor Objekte (Verarbeitungen) auf Status der Verarbeitung 28 - Beendet ohne Rückmeldung gesetzt.

               
Der Button <Quittieren> kennzeichnet das angezeigte Monitor-Objekt als quittiert (Haken in der Check-Box des Attributs Gültige Quittung vorhanden). Zusätzlich werden der Zeitpunkt der Quittierung, der quittierende Anwender und der Mandant, in dem die Quittierung erfolgte, hinterlegt. Quittiert werden können sowohl normal als auch fehlerhaft beendete Verarbeitungen.

               
Mit dem Button <Löschen> können beendete Verarbeitungen oder Verarbeitungen mit dem Monitor-Status Warnung (gelb) und dem Verarbeitungs-Status "Keine Rückmeldung gelöscht werden. Monitor-Objekte mit dem Verarbeitungs-Status "Wird ausgeführt" können nicht gelöscht werden.