Dies ist die alte 4D Dokumentations-Website. Die neue und aktualisierte Dokumentation finden Sie unter developer.4d.com

Home

 
Home
4D v20 R7
4D Programmiersprache
Werkzeuge
Get Monitored Activity

Get Monitored Activity 


 

Get Monitored Activity -> Funktionsergebnis 
Parameter Typ   Beschreibung
Funktionsergebnis  Collection in Collection der aufgezeichneten Aktivitäten

Der Befehl Get Monitored Activity gibt eine Collection von Objekten zurück mit den protokollierten Operationen gemäß den Spezifikationen, die mit dem Befehl START MONITORING ACTIVITY gesetzt wurden. Er lässt sich in 4D remote, 4D Server und in 4D Anwendungen im Einzelplatz (außer source stammt von Netzwerk Aktivität) aufrufen und ausführen.

Die Objekte in der zurückgegebenen Collection haben folgende Eigenschaften: 

Eigenschaft  Typ  Beschreibung 
activityKind  Lange Ganzzahl Art der aufgezeichneten Aktivität:
Konstante Wert Kommentar
Activity language 1

Operationen der Programmiersprache
Activity network 2

Operationen von Netzwerkanfragen 
Activity operations 4

Operationen von 4D Daten
activityDuration  Zahl Dauer der Aktivität in Sekunden 
activityData Objekt Objekt(e) mit spezifischen Eigenschaften, je nach Typ der aufgezeichneten Aktivität (activityKind). Unter bestimmten Umständen können für die gleiche Operation mehrere Objekte zurückgegeben werden. In diesem Fall haben die Objekte die gleiche UUID. Zusätzliche Eigenschaften dieser Objekte werden in den nachfolgenden Abschnitten beschrieben.

 

Hinweis: Das Objekt activityData verwendet die Angaben, die vom Befehl SET DATABASE PARAMETER für 4DDebugLog.txt (Standard) definiert wurden (falls vorhanden), andernfalls verwendet es den Standardmodus. Demzufolge wirkt sich das Starten der Protokollierung während der Ausführung von Get Monitored Activity auf die zurückgegebenen Ergebnisse aus.

Objekt activityData:

Eigenschaft Typ  Beschreibung 
sequenceNumber  Lange Ganzzahl  Einmalige und fortlaufenden Nummer der Operation in der aufgezeichneten Sitzung.
elapsedTime  Lange Ganzzahl Verbrauchte Zeit seit Starten des Überwachungsprotokolls  (in Millisekunden)  
processID  Lange Ganzzahl Prozess ID 
uniqueProcessID  Lange Ganzzahl Einmalige Prozess ID 
stackLevel  Lange Ganzzahl Stapelebene 
duration  Lange Ganzzahl Dauer der Operation (in Millisekunden)  
kind  Text  Art der protokollierten Operation. Mögliche Werte:
  • "command" 
  • "method"
  • "Message"
  • "pluginMessage"
  • "pluginCommand"
  • "pluginCallback"
  • "pluginEvent"
  • "task"
  • "member"

Im Objekt activityData werden je nach Art der Operation folgende zusätzliche Eigenschaften übergeben:

Eigenschaft  Typ  Art  Beschreibung
commandName Text command Befehlsnname
commandNumber Lange Ganzzahl command Befehlsnummer
connectionUUID Text task UUID des Client Rechners
formEvent Text command Name des Formularereignisses
formMethod Text command Formularmethode
functionName Text member Name der ORDA Member Methode
memberMethod Text command Lokalisierter String der Member Methode für Objektaufruf durch 4D
method Text command Lokalisierter Name der 4D Befehle und Funktionen
parameters Text command
member
message
method
PluginCommand
PluginEvent
task		 In der Operation übergebene Parameter
pluginCommandName Text PluginCommand
pluginEvent		 Name des Plug-In Befehls
pluginCommandNumber Lange Ganzzahl PluginCommand
PluginEvent
PluginMessage		 Nummer des Plug-In Befehls
pluginExternalCall Lange Ganzzahl PluginCallback Aufruf des Plug-in SDK Eingabepunktes
pluginMessageName Text pluginMessage

Mögliche Werte:

  • PackMsgServerDeInit
  • PackMsgServerDisposeData
  • PackMsgServerWriteData
  • PackMsgServerReadData
  • PackMsgServerKillClient
  • PackMsgServerNewClient
  • PackMsgServerInit
  • PackMsgProcessDeInit
  • PackMsgProcessInit
  • PackMsgClientDeInit
  • PackMsgClientInit
pluginName Text pluginCallback
pluginCommand
pluginEvent
pluginMessage		 Name des Plug-In

Hinweise: 

  • Wurden die Debug Logs auf der 4D Server GRAPH SETTINGS gestoppt, gibt Get Monitored Activity nichts zurück. Werden die Logs auf dem Server oder via START MONITORING ACTIVITY mit Activity network erneut gestartet, gibt Get Monitored Activity wieder Informationen zu Netzwerkaktivität zurück.
  • Das Objekt activityData verwendet die Angaben, die vom Befehl SET DATABASE PARAMETER für 4DRequestsLog.txt definiert wurden (falls vorhanden), andernfalls verwendet es den Standardmodus. Demzufolge wirkt sich das Starten der Protokollierung während der Ausführung von Get Monitored Activity auf die zurückgegebenen Ergebnisse aus.

Objekt activityData:

Eigenschaft Typ Beschreibung 
sequenceNumber  Lange Ganzzahl  Einmalige und fortlaufende Nummer der Operation in der protokollierten Sitzung
time  Text  Datum und Zeit im Format ISO 8601 ("YYYY-MM-DDTHH:MM:SS.sss")  
systemID  Text  System ID 
component  Text  Signatur der Komponente (z.B., 4SQLS oder dbmg) 
processInfoIndex  Lange Ganzzahl Entspricht dem Inhalt des "index" Felds im 4DRequestsLog_ProcessInfo.txt Protokoll und ermöglicht, eine Anfrage mit einem Prozess zu verbinden
request  Lange Ganzzahl Anfrage ID für c/s Meldungen, SQL Anfragen oder LOG EVENT Meldungen
bytesIn  Lange Ganzzahl Anzahl der empfangenen Bytes
bytesOut  Lange Ganzzahl  Anzahl der gesendete Bytes
execDuration Lange Ganzzahl  Je nachdem, wo generiert wurde:
  • server_duration .
    ODER,
  • exec_duration bei Generieren auf dem Server --Zeit in Mikrosekunden für den Server zum Bearbeiten der Anfrage.
 
writeDuration Lange Ganzzahl Zeit in Mikrosekunden zum Senden der:
  • Anfrage (bei Laufen auf dem Client).
  • Antwort (bei Laufen auf dem Server).
serverDuration Lange Ganzzahl Zeit in Mikrosekunden für die Client/Server Kommunikation
taskKind text Preemptive oder kooperativ (jeweils 'p' oder 'c')
rtt Lange Ganzzahl Geschätzte Zeit in Mikrosekunden für den Client zum Senden der Anfrage und Akzeptieren durch den Server.
  • Wird nur beim Verwenden der Netzwerkschicht measured when using the ServerNet gemessen, gibt bei Verwenden der bisherigen Netzwerkschicht 0 zurück.
  • Für Windows Versionen vor Windows 10 oder Windows Server 2016 gibt der Aufruf ebenfalls 0 zurück.

 

Hinweis: Das Objekt activityData ist ähnlich wie das vom Befehl GET ACTIVITY SNAPSHOT zurückgegebene Objekt, mit dem Unterschied, dass hier nur Schwellenwerte und abgeschlossene Operationen zurückgegeben werden.

Objekt activityData:

Eigenschaft   Typ  Beschreibung
message   Text  Beschreibung der Operation 
maxValue    Lange Ganzzahl Maximale Anzahl der Durchläufe für die Operation (Wert=-1 für nicht-iterative Operationen) 
remote    Boolean Client / Server Operation. Mögliche Werte: wahr, falsch 
uuid    Text   UUID der Operation 
taskId    Lange Ganzzahl    Interner 4D Identifier für den Ursprungsprozess 
startTime   Text   Startzeit der Operation im ISO 8601 Format ("YYYY-MM-DDTHH:MM:SS.sss")
duration   Lange Ganzzahl Gesamtzeit (in Millisekunden) der Ausführung der Operation
title   Text   Zusätzliche Angaben über die Operation
extraInfo   Objekt Zusätzliche SQL Angaben (falls vorhanden):

  • extraInfo.SQL_Query (text): SQL Suche 
  • extraInfo.SQL_User (text): User authenticated on SQL server
dbContextInfo   Objekt Angaben zum Kontext der Operation
  host_name Text Name des Host, der die Operation gestartet hat
  user_name Text Name des 4D Benutzers, dessen Sitzung die Operation gestartet hat
  task_name Text Name des Prozesses, der die Operation gestartet hat
  task_id Lange Ganzzahl ID des Prozesses, der die Operation gestartet hat 
  client_uid Text (nur C/S Operationen) UUID des Client Rechners, der die Operation der Datenbank gestartet hat
  is_remote_context Lange Ganzzahl (nur C/S Operationen) Gibt an, ob die Operation vom Server via Serverprozedur (Wert=0) oder über einen Client (Wert=1) gestartet wurde
  user4d_id Lange Ganzzahl ID des 4D auf dem Client Rechner
  user4d_alias Text Für den 4D Benutzer gesetztes Alias. Siehe SET USER ALIAS
  client_version Text Codierter Stringwert der Versionsnummer der 4D Umgebung, die der Befehl Application version zurückgibt.
dbOperationDetails   Objekt Information über Aufrufe von Operationen zur Engine der Datenbank
  table Text Name der Tabelle in der Operation
  field Text Name des Tabellenfeldes in der Operation
  queryPlan Text Suchplan für die Operation
  operationType Text Art der Operation
  sortParameters Collection Sortierkriterien 
subOperations   Collection Collection der Objekte activytData mit Angaben zu
      Bezeichnung der Operationen  
  [ ].maxValue Lange Ganzzahl Maximale Anzahl der Durchläufe für die Operation (Wert=-1 für nicht-iterative Operationen)  
  [ ].remote Boolean Client / Server Operation (0=wahr, 1=falsch) 
  [ ].uuid Text UUID der Operation 
  [ ].taskId Lange Ganzzahl Interner 4D Identifier für den Ursprungsprozess
  [ ].startTime Text Startzeit der Operation im ISO 8601 Format ("YYYY-MM-DDTHH:MM:SS.sss")
  [ ].duration Lange Ganzzahl Gesamtzeit (in Millisekunden) der Ausführung der Operation
  [ ].title Text Zusätzliche Angaben zur Operation
  [ ].extraInfo Objekt Zusätzliche SQL Angaben (falls vorhanden):

  • [ ].extraInfo.SQL_Query (text): SQL Suche
  • [ ].extraInfo.SQL_User (text): Benutzer auf SQL Server authentifiziert

Hinweis: Der Befehl Get Monitored Activity gibt immer sämtliche bisher aufgelaufenen Operationen zurück, der Aufruf des Befehls setzt diese nicht zurück. Zum Leeren der Liste muss die Aufzeichnung per STOP MONITORING ACTIVITY gestoppt und mit START MONITORING ACTIVITY neu gestartet werden.

 

Siehe Beispiel unter START MONITORING ACTIVITY



Siehe auch 

START MONITORING ACTIVITY
STOP MONITORING ACTIVITY

Vorige Seite
Nächste Seite

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Werkzeuge
Nummer: 1713

Dieser Befehl kann in preemptive Prozessen laufen

 
SEITENINHALT 
Beschreibung
activityKind = Activity language (1)
Zusätzliche Eigenschaften
activityKind = Activity network (2)
activityKind = Activity operations (4)
Beispiel
 
GESCHICHTE 

Erstellt: 4D v18 R3

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v20 R7)