Page History

...

Inhalt

Image Removed

Image Added

Diagnose

Erweiterte Client-Diagnosen führen 

Parallel zu den Log-Dateien lassen sich die Fehler im Ereignisprotokoll speichern.  Unter Unter erweiterten Diagnosen versteht man Programmmeldungen und Zustände, die zusätzlich den internen Ablauf dokumentieren.  Diese Diese sind über das Kennzeichen "Erweiterte Client-Diagnosen führen" zu aktivieren. Wird das Kennzeichen aktiviert, schreibt die Software in Klammern das Aktivierungsdatum des Kennzeichens in die Klammer. So bleibt es nachvollziehbar, wann die erweiterte Diagnose gestartet wurde.

Image Added

Erweiterte Fehlerprotokollierung auf allen Clients deaktivieren

...

Maximale Zeit zum Erstellen einer Diagnose. Der Wert wird in Millisekunden vergeben. Bei langsamen PCs kann es vorkommen, das diese Zeit zum Erstellen nicht ausreicht. In diesem Fall kann darüber dann über die Einstellung des "Diagnose-Timeout" eine höhere Zeit vorgegeben werden.

Maximale Client-Pausierung in Millisekunden pro Sekunde (

...

x ms) 

Dieser Wert definiertHierüber lässt sich festlegen, ab welcher Windows-Pausierungszeit (Zeitüberschreitung) ein Datensatz für das Pausieren des Clients im Ereignis-Protokoll Eintrag erstellt wirdwerden soll. Per Doppelklick kann der Schwellwert in Millisekunden angepasst werden (Vorgabe = 200 ms). Hierüber lässt sich festlegen, ab welcher Windows-Pausierungszeit ein Ereignis-Protokoll Eintrag erstellt werden soll. Die Prüfung selbst findet einmal pro Sekunde statt. Änderungen der "Parameter für das Ereignis-Protokoll" werden mit dem Speichern automatisch an allen angemeldeten Clients aktiv. Beachten Sie bitte, dass erweiterte Diagnosen das Laufzeitverhalten des Programms beeinträchtigen,

...

Diese Felder lassen sich über Kennzeichen aktivieren und über die Schaltfläche: EIGENSCHAFTEN zulässige Abfragezeiten vergeben.  Über das Kennzeichen: "Lange Datenbank-Transaktion" werden Datenbank-Transaktion die länger als x Sekunden dauern technisch protokolliert. Da lange Transaktionen andere Benutzer sperren können, bekommt man hierüber Aufschluss wer der "Verursacher" ist. Die Vorgabe-Zeit ist 10 Sekunden.

...

Maximaler Datenbank-Timeout

Über diesen Eintrag kann man die können Sie den maximalen Datenbank-Timeout festlegen. Dieser Eintrag kann dabei helfen, lastverursachende Benutzer-Anfragen aufzudecken. In diesem Fall sollte man den Wert z. B. auf 120 Sekunden stellen und im Ereignisprotokoll prüfen, ob Einträge über Lange-Datenbankanfragen existieren. Wenn nein, kann man dies nicht der Fall ist, können Sie den Wert in 10er Schritten verkleinern, um den Verursacher ausfindig zu machen.

...

Diagnosen über Drucker-Konfiguration

Nutzen Sie dieses Kennzeichen, sofern Ihre Drucke länger dauern oder andere Probleme bei der Ausgabe vorliegen, um eine klare Fehleranalyse zu erhalten.

Mittels aktiviertem Kennzeichen werden zur Drucker-Konfiguration Diagnosen erstellt und können über Einträge im Ereignis-Protokoll nachvollzogen werden. Entsprechende Diagnosen zum Laden der Komponenten zur Druckausgabe sowie Hinweise zu fehlerhafter Druckkonfiguration oder Problemen bei der Layout-Ausgabe auf einer bestimmten Druckerkonfiguration werden dokumentiert. 

Regelanweisung "Diagnose-Eintrag im Ereignis-Protokoll erzeugen" ausführen

Über dieses Kennzeichen lassen sich bedingte Feldprüfungen vornehmen und nachfolgend über das Ereignis-Protokoll protokollieren. Sie können über die Ereignisart "Diagnose" eingegrenzt werden. Über ein Layout für den Eintrag lässt sich eine individuelle Information definieren.  Die Die Regel-Anweisung "Anweisungsart: Diagnose-Eintrag im Ereignis-Protokoll erzeugen" steht in allen Auswertungspositionen zur Verfügung, für die es die Anweisung "Feldzuweisungen" über alle Felder der Tabelle gibt.

Kennzeichen zur Ausführungsverhinderung (wenn nötig Verarbeitung abbrechen und Diagnose-Meldung anzeigen)

...

Wird dieses Kennzeichen aktiviert, werden die erweiterten Server-Diagnosen und Logfiles zentral im Ereignis-Protokoll aufgezeichnet. Bei der Aktivierung des Kennzeichens werden Datum und Uhrzeit der Aktivierung zur besseren Nachvollziehbarkeit neben das Kennzeichen notiert.

Maximale Server-Pausierung in Millisekunden pro Sekunde (

...

x ms) 

Dieser Wert definiert, ab welcher Zeitüberschreitung Zeit-Überschreitung ein Datensatz für das Pausieren des Servers im Ereignis-Protokoll erstellt wird. Per Doppelklick kann der Schwellwert in Millisekunden angepasst werden (Vorgabe = 200 ms).

Exchange-Übertragungen protokollieren

Über das Kennzeichen kann bei einer fehlerhaften Kalender-Exchange-Synchronisation dem genauen Grund über die entsprechenden Log-Dateien nachgegangen werden (weitere Infos auch am Ende folgender Hilfe-Seite: Abgleich mit Exchange Kalender). Die Logs werden im Ereignis-Protokoll unter den Namen "Exchange-Abgleich" gespeichert. Die Protokollierung kann im laufenden Betrieb aktiviert und deaktiviert werden. Beachten Sie, dass diese Option nur zur Problem-Findung genutzt werden sollte und nach der Fehlerbehebung wieder zu deaktivieren ist.

Erweiterte Diagnosen protokollieren

Wird dieses Kennzeichen aktiviert, so werden erweiterte Diagnosen im Ereignis-Protokoll aufgezeichnet. Nach der Problem-Findung über die erweiterte Diagnose, ist das Kennzeichen wieder zu deaktivieren, da ansonsten unnötig viele Daten in das Ereignis-Protokoll geschrieben werden.

Performance

In diesem Bereich existieren erweiterte Protokollierungs-Optionen. Die einzelnen Performance Messungs-Parameter lassen sich einzeln aktivieren. Da Performance-Messungen auch Leistung ziehen, sollten diese nur temporär aktiviert werden.

Buchungssatz-Performance Messung

Führt eine Messung im Bereich der Buchungssätze durch.

Cloud-Performance Messung

Ist die Performance Messung aktiviert, werden u. a. alle Schritte vom Bereichs-Aktionen Assistenten bis zur Übertragung protokolliert.

Folgende Informationen stehen durch diese Messung im Ereignis-Protokoll zusätzlich zur Verfügung:

• Auswahl der Bereichs-Aktionen Einstellungen und Regeln
• Informationen über die ausgewählten Daten
• Wohin diese Daten übertragen werden

• Performance-Messung für Übertragung von Artikel-Daten (Aufschlüsselung nach: "Aktion", "Daten", "Dauer der Übertragungen in Millisekunden")

  • Anzahl der Anfragen bei Artikelübertragung

  • Aktionen wie "Bilder-Hashes laden"

  • "GET Documents"

  • "Artikeldaten verarbeiten": z. B.: Allgemeine Daten, Varianten-Daten, Kategorien, Bilder, Eigenschaften, Preise, Artikelzubehör, Fahrzeugverwendungsliste, etc.

  • "POST Documents" / "Warten auf Antwort"

  • "POST Products" / "Warten auf Antwort" / "Verbarbeite Antwort"

  • Weitere Aktionen, die in Zusammenhang mit der Artikelübertragung stehen, werden ggf. unter "Undefined" zusammengefasst

COM-Performance Messung verfügbar / Erstellte Messungen im Ereignis-Protokoll speichern

Auf der COM-Schnittstelle ist es möglich, die Anzahl an Paketen pro Operation zu messen. Diese Statistikfunktion misst die Zeit und die Anzahl der Netz-Pakete zwischen zwei Aufrufen. Dies wird für die beiden wichtigsten Prozesse „Wandeln“ und „Buchen“ so detailliert aufgelöst, dass man Sie gezielt Engpässe innerhalb der Funktionen ermitteln und beseitigen kann. Insbesondere können, insbesondere mit und ohne Regeln. Die Ereignisprotokollierung wird durch das Kennzeichen so erweitert, dass für nachfolgende Programmfunktionen eine detaillierte Statistik erstellt wird: Wandeln, Buchen und Regeln. Die Statistik umfasst neben der Zeit in Millisekunden auch die Anzahl der Netz-Pakete (Anfragen an den externen microtech Server). Jede dieser Funktion wird so detailliert in Textform protokolliert, das man nachfolgend das Zeit- und Lastverhalten für einen Funktionsblock ermitteln kannermittelt werden. Der Funktionsblock definiert sich pro Datensatz aus dem Anfang einer Editier-Funktion und endet mit dem Schreiben von Daten / Verwerfen bei Abbruch. Regel-Bedingungen und Anweisungen werden zusätzlich als Funktionsblock angesehen.

Erstellte Messungen im Ereignis-Protokoll speichern

Zusätzlich lassen sich diese Messungen im Ereignisprotokoll speichern.

Verbesserung der Programmstabilität

Kennzeichen: Problemberichte automatisch an microtech senden

Sofern das Kennzeichen für das automatische Versenden der Problemberichte aktiviert ist, werden auftretende Softwarefehler direkt an microtech gemeldet. Auf diese Weise helfen Sie uns als Softwarehersteller frühzeitig Verbesserungen in der Software vornehmen zu können und profitieren so von einer stabileren Software. 

Wurde das Kennzeichen für das automatische Versenden der Problemberichte nicht aktiviert, so erhalten Sie mit Ausführung des Wartungsassistenten die Abfrage: "Wie sollen Problemberichte zur Verbesserung der Programmstabilität versendet werden?". Über die Abfrage des Wartungsassistenten lässt sich diese Parameter-Einstellung ebenfalls aktivieren.

Weitere Optionen bei Einsatz eines E-Commerce-Moduls "ab M" im Bereich: "Diagnose"

Image Added

Cloud-Übertragungen protokollieren

Sofern Sie microtech Cloud-Dienste nutzen, kann über das aktivierte Kennzeichen eine erweiterte Protokollierung gestartet werden.

• Die Protokolle der Cloud-Übertragungen enthalten unter anderem die Antwort oder Fehlermeldung der Cloud
• Bei aktivierter erweiterter Client-Diagnose werden werden weitere zusätzliche Details der Cloud-Abfrage in das Protokoll geschrieben

Zusätzliche Informationen bei Übertragung anfordern (langsamer)

Mit dieser Option werden zusätzliche Daten der jeweiligen Schnittstelle in das Ereignisprotokoll geschrieben. Dieses Kennzeichen kann bei unbekannten Fehlern hilfreich sein, welche in Zusammenhang mit einer Schnittstelle stehen. Beachten Sie bitte, dass durch Aktivierung des Kennzeichens das Ereignisprotokoll mehr Daten aufnehmen muss und dass das Anfordern der Originaldaten die Datenkommunikation verlangsamen kann. Nach einer Fehlersuche sollte das Kennzeichen wieder deaktiviert werden.

Umfangreiche Daten im Ereignisprotokoll kürzen

Dieses Kennzeichen sollte dann aktiviert werden, wenn Antworten der microtech Cloud, z. B. beim Abholen der Versandbelege sehr groß ausfallen. Sinn und Zweck des Kennzeichens ist es, dass von der Cloud zurück gelieferte, obsolete Informationen für die Protokollierung abgeschnitten werden können.

• Beispiel: Wenn z. B. bei der Antwort der Schnittstelle auf die Abholung eines Versandbelegs zusätzlich ein Feld "Label Data" mitgeliefert wird, der 95 Prozent der Antwort ausmacht, da dieses beispielsweise über 1.000 Zeichen besitzt (aber unerheblich für Ihre Prozesse ist), dann kann diese Antwort gekappt werden und muss nicht in ihrer Gänze in das Ereignisprotokoll geschrieben werden. Mit diesem Kennzeichen verhindern Sie somit ein übertrieben großes Anwachsen des Ereignisprotokolls
• Technische Info: Alle Textfelder, die über diese Zeichenlänge hinaus gehen werden bei aktiviertem Kennzeichen gekürzt

Beispiel:

Das Feld "labelData" eines Versanddienstleisters wird durch Aktivierung des Kennzeichens beim Überschreiten einer bestimmten Datengrenze in der Protokollierung gekappt. Die drei Punkte am Ende der Protokollierung zeigen an, dass durch das Kennzeichen der Text für das Ereignisprotokoll eingekürzt wurde.

"labelData": "LTRERi0xLjUKJeLjz9MKNSAwIG9iago8PC9TdWJ0eXBlL0Zvcm0vRmlsdGVyL0ZsYXRlRGVjb2RlL1R5cGUvWE9iamVjdC9NYXRyaXggWzEgMCAwIDEgMCAwXS9Gb3JtVHlwZSAxL1Jlc879c..."

Image Added

...

Weitere Optionen bei Einsatz eines E-Commerce-Moduls "ab XL" im Bereich: "Diagnose"

Image Added

HTTP-Anfragen protokollieren

Diese Funktion der Ereignisprotokollierung steht in Zusammenhang mit der Funktion: Regel-Anweisungsart: Http-Post Befehl senden.

Durch Aktivierung des Kennzeichens können gesendete und empfangene Daten aus diesem Bereich protokolliert werden. Die Diagnose kann z. B. bei Problemsachlagen hilfreich sein.

Weitere Einstell-Möglichkeiten für das Ereignis-Protokoll in Ausprägung: XXL

Image Removed

...

Image Added

Langer Schreibbefehl (Post-Befehl) (z. B.: "länger als 500 ms") - im Bereich Diagnose

Im Ereignisprotokoll können lange Schreibbefehle protokolliert werden. An dieser Stelle geben Sie den Schwellenwert in Millisekunden ein, ab dem ein Eintrag erfolgen soll. Dieser ist frei konfigurierbar und steht zunächst auf 500 Millisekunden. Über einen Mausklick auf den Eintrag öffnet sich die die Erfassungsmaske, in der Sie die Zeit, ab dem ein langer Schreibbefehlt protokolliert werden soll nach oben oder unten konfigurieren können. Ist das Kennzeichen aktiviert und die angegeben Mindestzeit überschritten, wird ein Ereignisprotokoll-Eintrag erzeugt, der die Speicherung dokumentiert.

Langer Schreibbefehl (Post-Befehl) über COM-Schnittstelle (länger als 500 ms) - im Bereich Diagnose

Auch für lange Schreibbefehle, die über die COM-Schnittstelle erfolgen, kann ein Schwellenwert in Millisekunden eingeben werden. Legen Sie fest, ab welcher Schreibbefehl-Länge ein Eintrag im Ereignis-Protokoll erfolgen soll.

Alle Cloud-Übertragungen protokollieren

Sofern Sie microtech Cloud-Dienste nutzen, kann über das aktivierte Kennzeichen eine erweiterte Protokollierung gestartet werden.

• Die Protokolle der Cloud-Übertragungen enthalten unter anderem die Antwort oder Fehlermeldung der Cloud
• Bei aktivierter erweiterter Client-Diagnose werden werden weitere zusätzliche Details der Cloud-Abfrage in das Protokoll geschrieben

Performance

Zusätzlich stehen noch folgende Optionen im Bereich Performance zur Verfügung:

Regel-Performance Messung

...

(Weitere Informationen zu den Buchungssätzen: Erstellung von Buchungssätzen)

Manuelle Performance-Messung

Für die manuelle Performance Messung muss im Bereich: "Parameter für das Ereignis-Protokoll" das Kennzeichen: "Manuelle Performance Messung" (unter der Gruppe Performance) aktiviert werden. Die manuelle Performance-Messung steht nach Aktivierung im Programm über Registerkarte: ANSICHT - Schaltfläche: OPTIONEN: "Manuelle Performance Messung" zur Verfügung und kann temporär genutzt werden, um eine Messung im Ereignis-Protokoll zu protokollieren.

Serverseitige Session-Thread-Zeiten berechnen /

...

Bei der Performance-Messung werden Abschnittszeiten mit Anfragen ausgewiesen (anstelle der laufenden Zeitspalte im Spalte 1). Die Abschnittszeiten definieren immer die laufende Summe und bei einer Ausrückung die Summe der Zeit für den Abschnitt; die Server-Anfragen werden analog dazu ausgewiesen.

...