Get Monitored Activity

4D v20 R7


Get Monitored Activity -> Resultado

Parámetro	Tipo	Descripción
Resultado	Collection	Colección de actividades monitoreadas

Descripción

El comando Get Monitored Activity devuelve una colección de objetos que describen operaciones registradas de acuerdo con las especificaciones definidas por el comando START MONITORING ACTIVITY. Se puede llamar y ejecutar en 4D remoto, 4D Server y aplicaciones 4D autónomas (si fuente no proviene de la actividad de red).

Los objetos en la colección devuelta tienen las siguientes propiedades:

Propiedad

Tipo

Descripción

activityKind

Entero largo

El tipo de actividad registrada:

Constante	Valor	Comentario
Activity language	1	Operaciones de ejecución del lenguaje
Activity network	2	Operaciones de peticiones de red
Activity operations	4	Operaciones de datos 4D

activityDuration

Real

La duración de la actividad expresada en segundos

activityData

Objeto

Objeto(s) que contiene(n) propiedades específicas dependiendo del tipo de actividad registrada (activityKind). En algunas circunstancias, se pueden devolver varios objetos para la misma operación. En este caso, los objetos tendrán el mismo UUID. Las propiedades adicionales en estos objetos se describen en las secciones a continuación.

activityKind = Activity language (1)

Nota: el objeto activityData utiliza la información definida por el comando SET DATABASE PARAMETER para 4DDebugLog.txt (estándar) (si corresponde), de lo contrario, utiliza un modo predeterminado. Iniciar la grabación del historial durante la ejecución del comando Get Monitored Activity afectará los resultados devueltos.

objeto activityData:

Propiedad	Tipo	Descripción
sequenceNumber	entero largo	Número de operación único y secuencial en la sesión de historial.
elapsedTime	entero largo	Tiempo transcurrido desde que se inició el historial de depuración (expresado en milisegundos)
processID	entero largo	ID de proceso
uniqueProcessID	entero largo	ID de proceso único
stackLevel	entero largo	Nivel de pila
duration	entero largo	Duración de la operación (expresada en microsegundos)
kind	texto	Tipo de operación registrada. Valores posibles: "command" "method" "Message" "pluginMessage" "pluginCommand" "pluginCallback" "pluginEvent" "task" "member"

Propiedades adicionales

Las siguientes propiedades adicionales se devuelven en el objeto activityData según el tipo de operación:

Propiedad	Tipo	Tipo	Descripción
commandName	texto	comando	Nombre del comando
commandNumber	entero largo	comando	Número del comando
connectionUUID	texto	tarea	Máquina cliente UUID
formEvent	texto	comando	Nombre del evento de formulario
formMethod	texto	comando	Método de formulario
functionName	texto	miembro	Nombre del método del miembro ORDA
memberMethod	texto	comando	Cadena localizada del método miembro para la llamada al objeto 4D
method	texto	comando	Nombres localizados de comandos y funciones 4D
parameters	texto	comando member message method pluginCommand pluginEvent task	Parámetros pasados en la operación
pluginCommandName	texto	pluginCommand pluginEvent	Nombre del comando del plug-in
pluginCommandNumber	entero largo	pluginCommand pluginEvent pluginMessage	Número del comando del plug-in
pluginExternalCall	entero largo	pluginCallback	Llamada de punto de entrada Plug-in SDK
pluginMessageName	texto	pluginMessage	Valores posibles: PackMsgServerDeInit PackMsgServerDisposeData PackMsgServerWriteData PackMsgServerReadData PackMsgServerKillClient PackMsgServerNewClient PackMsgServerInit PackMsgProcessDeInit PackMsgProcessInit PackMsgClientDeInit PackMsgClientInit
pluginName	texto	pluginCallback pluginCommand pluginEvent pluginMessage	Nombre del plug-in

activityKind = Activity network (2)

Notas:

si los historiales de depuración se han detenido en el servidor 4D GRAPH SETTINGS, Get Monitored Activity no devolverá nada. Si los historiales se reinician en el servidor o mediante el comando START MONITORING ACTIVITY con Activity network, Get Monitored Activity reanudará la información de actividad de red.
el objeto activityData utiliza la información definida por el comando SET DATABASE PARAMETER para el 4DRequestsLog.txt (si corresponde), de lo contrario, utiliza un modo predeterminado . Iniciar la grabación del historial durante la ejecución del comando Get Monitored Activity impactará los resultados devueltos.

objeto activityData:

Propiedad	Tipo	Descripción
sequenceNumber	entero largo	Número de operación único y secuencial en la sesión de historial
time	texto	Fecha y hora en formato ISO 8601 ("AAAA-MM-DDTHH:MM:SS.sss")
systemID	texto	ID del sistema
component	texto	Firma del componente (p. ej., 4SQLS o dbmg)
processInfoIndex	entero largo	Corresponde al campo "index" en historial 4DRequestsLog_ProcessInfo.txt, y permite vincular una solicitud a un proceso
request	entero largo	ID de solicitud para mensajes c/s, peticiones SQL o mensajes LOG EVENT
bytesIn	entero largo	Número de bytes recibidos
bytesOut	entero largo	Número de bytes enviados
execDuration	entero largo	Dependiendo de dónde se genere: server_duration . OR, exec_duration cuando se genera en el servidor --tiempo que tarda en microsegundos para que el servidor procese la solicitud.
writeDuration	entero largo	Tiempo empleado en microsegundos para enviar: Request (cuando se ejecuta en el cliente). Response (cuando se ejecuta en el servidor).
serverDuration	entero largo	Tiempo en microsegundos para la comunicación cliente/servidor
taskKind	texto	Apropiativo o cooperativo (respectivamente 'p' o 'c')
rtt	entero largo	Tiempo estimado en microsegundos para que el cliente envíe la solicitud y el servidor la confirme. Solo se mide cuando se utiliza la capa de red ServerNet, devuelve 0 cuando se utiliza con la capa de red heredada. Para versiones de Windows anteriores a Windows 10 o Windows Server 2016, la llamada devolverá 0.

activityKind = Activity operations (4)

Nota: el objeto activityData es similar al que devuelve el comando GET ACTIVITY SNAPSHOT, excepto que solo se devuelven las operaciones de umbral y finalizadas.

objeto activityData:

Propiedad		Tipo	Descripción
message		texto	Descripción de la operación
maxValue		entero largo	Número máximo de iteraciones para la operación (valor=-1 para operaciones no iterativas)
remote		booleano	Operación cliente/ servidor. Valores posibles: true, false
uuid		texto	UUID de la operación
taskId		entero largo	Identificador interno 4D para el proceso de origen
startTime		texto	Hora de inicio de la operación en formato ISO 8601 ("AAAA-MM-DDTHH:MM:SS.sss")
duration		entero largo	Tiempo total (expresado en milisegundos) de ejecución de la operación
title		texto	Información adicional sobre la operación
extraInfo		objeto	Información SQL adicional (si la hay): extraInfo.SQL_Query (text): la consulta SQL extraInfo.SQL_User (text): usuario autenticado en el servidor SQL
dbContextInfo		objeto	Información de contexto de la operación
	host_name	texto	Nombre del host que inició la operación
	user_name	texto	Nombre del usuario 4D cuya sesión inició la operación
	task_name	texto	Nombre del proceso que inició la operación
	task_id	entero largo	ID del proceso que inició la operación
	client_uid	texto	(solo operaciones c/s) UUID de la máquina cliente que inició la operación de la base de datos
	is_remote_context	entero largo	(solo operaciones c/s) Indica si la operación fue lanzada por el servidor mediante un procedimiento almacenado (valor=0) o por un cliente (valor=1)
	user4d_id	entero largo	ID del usuario 4D en la máquina cliente
	user4d_alias	texto	Alias definido para el usuario 4D. Ver SET USER ALIAS
	client_version	texto	Valor de cadena codificado que expresa el número de versión del entorno 4D devuelto por el comando Application version
dbOperationDetails		objeto	Información sobre llamadas de operación al motor de la base
	table	texto	Nombre de la tabla en la operación
	field	texto	Nombre del campo de tabla en la operación
	queryPlan	texto	Plan de consulta para la operación
	operationType	texto	Tipo de operación
	sortParameters	colección	Criterio de ordenación
subOperations		colección	colección de objetos activytData que contienen información sobre operaciones subordinadas dentro de la operación actual.
	[ ].message	texto	Etiqueta de operaciones
	[ ].maxValue	entero largo	Número máximo de iteraciones para la operación (valor = -1 para operaciones no iterativas)
	[ ].remote	booleano	Operación cliente / servidor (0=true, 1=false)
	[ ].uuid	texto	UUID de la operación
	[ ].taskId	entero largo	Identificador 4D interno para el proceso de origen
	[ ].startTime	texto	Hora de inicio de la operación en formato ISO 8601 ("AAAA-MM-DDTHH:MM:SS.sss")
	[ ].duration	entero largo	Tiempo total (expresado en milisegundos) de ejecución de la operación
	[ ].title	texto	Información adicional sobre la operación
	[ ].extraInfo	objeto	Información SQL adicional (si la hay): [ ].extraInfo.SQL_Query (text): la consulta SQL [ ].extraInfo.SQL_User (text): usuario autenticado en el servidor SQL

Ejemplo

Ver el ejemplo de START MONITORING ACTIVITY

Ver también

START MONITORING ACTIVITY
STOP MONITORING ACTIVITY