Monitored activity

Monitored activity : Collection

Parâmetro	Tipo		Descrição
Resultado	Collection	←	Coleção de atividades monitoradas

Descrição

O comando Monitored activity devolve uma coleção de objetos que descrevem operações registradas de acordo com as especificações definidas pelo comando START MONITORING ACTIVITY. Pode ser chamado e executado em 4D remoto, 4D Server e aplicações 4D autonomas (se fonte não vier da atividade de rede).

Os objetos na coleção devolvida têm as propriedades abaixo:

Propriedade	Tipo	Descrição
activityKind	Inteiro longo	O tipo de atividade registrada: Constante Valor Comentário Activity language 1 Operações de execução de Linguagem Activity network 2 Operações de petição de network Activity operations 4 Operações de dados 4D
activityDuration	Real	A duração da atividade expressa em segundos
activityData	Objeto	Objetos que contém propriedades específicas dependendo do tipo de atividade registrada (activityKind). Em algumas circunstâncias, podem devolver vários objetos para a mesma operação. Neste caso, os objetos terão o mesmo UUID. As propriedades adicionais nestes objetos são descritas nas seções a seguir.

activityKind = Activity language (1)

Nota: o objeto activityData utiliza a informação definida pelo comando SET DATABASE PARAMETER para 4DDebugLog.txt (standard) (se corresponde), do contrário, utiliza um modo predeterminado. Iniciar a gravação de historial durante a execução do comando Monitored activity afetará os resultados devolvidos.

objeto activityData:

P ropiedad	Tipo	Descripción
sequenceNumber	inteiro longo	Número de operação único e sequencial na sessão de historial.
elapsedTime	inteiro longo	Tempo transcorrido desde que se iniciou o histórico de depuração (expresso em milissegundos)
processID	inteiro longo	ID de processo
uniqueProcessID	inteiro longo	ID de processo único
stackLevel	inteiro longo	Nivel de pilha
duration	inteiro longo	Duração da operação (expressa em microssegundos)
kind	texto	Tipo de operação registrada. Valores possíveis: "command" "method" "Message" "pluginMessage" "pluginCommand" "pluginCallback" "pluginEvent" "task" "member"

Propriedades adicionais

As propriedades abaixo adicionais são devolvidas no objeto activityData segundo o tipo de operação:

Propriedade	Tipo	Tipo	Descrição
commandName	texto	comando	Nome de comando
commandNumber	inteiro longo	comando	Número de comando
connectionUUID	texto	tarea	Máquina cliente UUID
formEvent	texto	comando	Nome de evento de formulário
formMethod	texto	comando	Método de formulário
functionName	texto	miembro	Nome de método de membro ORDA
memberMethod	texto	comando	String localizada do método membro para a chamada ao objeto 4D
method	texto	comando	Nomes localizados de comandos e funções 4D
parameters	texto	comando member message method pluginCommand pluginEvent task	Parâmetros passados ​na operação
pluginCommandName	texto	pluginCommand pluginEvent	Nome de comando de plug-in
pluginCommandNumber	inteiro longo	pluginCommand pluginEvent pluginMessage	Número de comando de plug-in
pluginExternalCall	inteiro longo	pluginCallback	Chamada de ponto de entrada Plug-in SDK
pluginMessageName	texto	pluginMessage	Valores possíveis: PackMsgServerDeInit PackMsgServerDisposeData PackMsgServerWriteData PackMsgServerReadData PackMsgServerKillClient PackMsgServerNewClient PackMsgServerInit PackMsgProcessDeInit PackMsgProcessInit PackMsgClientDeInit PackMsgClientInit
pluginName	texto	pluginCallback pluginCommand pluginEvent pluginMessage	Nome de plug-in

activityKind = Activity network (2)

• se os históricos de depuração foram parados no servidor 4D GRAPH SETTINGS, Monitored activity não devolverá nada. Se os históricos forem reiniciados no servidor ou mediante o comando START MONITORING ACTIVITY com Activity network, Monitored activity reiniciará a informação de atividad de rede.
• o objeto activityData utiliza a informação definida pelo comando SET DATABASE PARAMETER para 4DRequestsLog.txt (se corresponde), do contrário, utiliza um modo pré-determinado . Iniciar a gravação de historial durante a execução do comando Monitored activity impactará os resultados devolvidosobjeto activityData:

P ropriedade	Tipo	Descrição
sequenceNumber	entero largo	Número de operação único e sequencial na sessão de histórico
time	texto	Data e hora em formato ISO 8601 ("AAAA-MM-DDTHH:MM:SS.sss")
systemID	texto	ID de sistema
component	texto	Assinatura do componente (p. ex., 4SQLS ou dbmg)
processInfoIndex	entero largo	Corresponde ao campo "index" em histórico 4DRequestsLog_ProcessInfo.txt, e permite vincular uma solicitação a um processo
request	entero largo	ID de solicitação para mensagens c/s, petições SQL ou mensagens LOG EVENT
bytesIn	entero largo	Número de bytes recebidos
bytesOut	entero largo	Número de bytes enviados
execDuration	entero largo	Dependendo de onde seja gerado:server_duration . OR,exec_duration quando se gera no servidor --tempo que demora em microssegundos para que o servidor processe a solicitação.
writeDuration	entero largo	Tempo empregado em microssegundos para enviar:Request (quando se executa no cliente).Response (cuando se executa no servidor).
serverDuration	entero largo	Tempo em microssegundos para a comunicação cliente/servidor
taskKind	texto	Preemptivo ou cooperativo (respectivamente 'p' ou 'c')
rtt	entero largo	Tempo estimado em microssegundos para que o cliente envie a solicitação e o servidor a confirme. Só se mede quando se utilizar a capa de rede ServerNet, devolve 0 quando se utilizar com a capa de rede herdada.Para versões de Windows anteriores a Windows 10 ou Windows Server 2016, a chamada devolverá 0.

activityKind = Activity operations (4)

Nota: o objeto activityData é parecido com aquele retornado pelo comando ACTIVITY SNAPSHOT, exceto que apenas operações terminadas são retornadas.

activityData object:

Propriedade		Tipo	Descrição
message		text	Descrição da operação
maxValue		longint	Número máximod e iterações para a operação (value=-1 ara operações não-iterativas)
remote		boolean	Operações cliiente / servidor. Valores possíveis: true, false
uuid		text	UUID da operação
taskId		longint	Identificador Interno 4D para o processo originador
startTime		text	HOra de início para a operação em formato ISO 8601 ("AAAA-MM-DDTHH:MM:SS.sss")
duration		longint	Tempo total (expresso em milissegundos) da execução de operação
title		text	Informação adicional sobre a operação
extraInfo		object	Informação adicional SQL (se houver): extraInfo.SQL_Query (text): a pesquisa SQL extraInfo.SQL_User (text): Usuário autenticado em SQL server
dbContextInfo		object	Informação Contextual da operação
	host_name	text	Nome do host que lança a operação
	user_name	text	Nome do usuário 4D cuja sessão lança a operação
	task_name	text	Nome do processo que lança a operação
	task_id	longint	ID do processo que lança a operação
	client_uid	text	(operações c/s somente) UUID da máquina cliente que lança a operação de banco de dados
	is_remote_context	longint	(operações c/s somente) Indica se a operação foi lançada pelo servidor via um processo armazenado (valor=0) ou por um cliente (valor=1)
	user4d_id	longint	ID do usuário 4D na máquina cliente
	user4d_alias	text	Alias/apelido estabelecido pelo usuário 4D. Veja SET USER ALIAS
	client_version	text	Valor de string codificada que expressa o número da versão do ambiente 4D retornado pelo comando Application version
dbOperationDetails		object	Informação sobre as chamadas da operação para o motor de banco de dados
	table	text	Nome da tabela na operação
	field	text	Nome do campo tabela na operação
	queryPlan	text	Plano pesquisa para a operação
	operationType	text	Tipo de operação
	sortParameters	collection	Critério de ordenação
subOperations		collection	coleção de objetos activytData contendo informação sobre as operações subordinadas dentro da operação atual.
	[ ].message	text	Etiqueta de operações
	[ ].maxValue	longint	Número máximo de iterações para a operação (valor=-1 para operações não-iterativas)
	[ ].remote	boolean	Operação cliente/servidor (0=true, 1=false)
	[ ].uuid	text	UUID da operação
	[ ].taskId	longint	Identificador Interno 4D para o processo original
	[ ].startTime	text	Hora início da operação em formato ISO 8601 ("AAAA-MM-DDTHH:MM:SS.sss")
	[ ].duration	longint	Tempo Total (expresso em milissegundos) de execução de operação
	[ ].title	text	Informação adicional sobre a operação
	[ ].extraInfo	object	Informação adicional SQL (se houver): [ ].extraInfo.SQL_Query (text): a pesquisa SQL [ ].extraInfo.SQL_User (text): Usuário autenticado no servidor SQL

Exemplo

Ver exemplos para START MONITORING ACTIVITY

Ver também

START MONITORING ACTIVITY
STOP MONITORING ACTIVITY

Propriedades

Número do comando	1713
Thread-seguro	✓