Get process activity

4D v17.4


Get process activity {( opções )} -> Resultado

Parâmetro	Tipo	Descrição
opções	Inteiro longo	Retorna opções
Resultado	Objeto	snapshot dos processos executando ou sessões de usuário (apenas em 4D Server)

Descrição

O comando Get process activity devolve uma foto instantânea das sessôes dos usuários conectados ou dos processos relacionados que são executados em um momento dado. Este comando devolve todos os processos, incluindo os processos internos que não eram acessíveis pelo comando PROCESS PROPERTIES.

Quando executar no servidor, como padrão se omitir o parâmetro opções, Get process activity devolve as listas de sessões usuário e dos processos, como abaixo:

{
"sessions": [
          {
             "type": "remote",
             "userName": "Designer",
             "machineName": "iMac27caroline",
             "systemUserName": "Caroline Briaud",
             "IPAddress": "192.168.18.18",
             "hostType": "mac",
             "creationDateTime": "2017-09-22T12:46:39Z",
             "state": "postponed",
             "ID": "3C81A8D7AFE64C2E9CCFFCDC35DC52F5"
           },...
       ],
"processes": [
          {
             "name": "Application process",
             "sessionID": "3C81A8D7AFE64C2E9CCFFCDC35DC52F5",
             "number": 4,
             "ID": 4,
             "visible": true,
             "systemID": "123145476132864",
             "type": -18,
             "state": 0,
             "cpuUsage": 0,
             "cpuTime": 0.006769,
             "preemptive": false,
             "session": {   
                      "type": "remote",
                      "userName": "Designer",
                      "machineName": "iMac27caroline",
                      "systemUserName": "Caroline Briaud",
                      "IPAddress": "192.168.18.18",
                      "hostType": "mac",
                      "creationDateTime": "2017-09-22T12:46:39Z",
                      "state": "postponed",
                      "ID": "3C81A8D7AFE64C2E9CCFFCDC35DC52F5"
                       }
           },...
    ]
}

Se puder selecionar a lista a devolver ao passar uma das seguintes constantes do tema "Ambiente 4D" no parâmetro opções:

Constante	Tipo	Valor	Comentário
Processes only	Inteiro longo	1	Retorna apenas a lista de processo
Sessions only	Inteiro longo	2	Retorna apenas a lista de sessão do usuário

Quando executar em 4D em modo remoto ou local, Get process activity só devolve a lista de processos (o parâmetro opções é inútil).

Lista de sessões

A propriedade "sessions" contém uma coleção de objetos que descrevem todas as sessões usuário em execução no servidor, por exemplo:

{
    "sessions": [
        {
            "type": "remote",
            "hostType": "mac",
            "userName": "Designer",
            "machineName": "YANNICK-CORE-I7",
            "systemUserName": "Yannick",
            "IPAddress": "fe80::c189:5ea1:c635:90e6",
            "creationDateTime": "2017-04-24T17:13:15Z",
            "state": "postponed",
            "ID": "63DCD177059C60459F2AD278EAD84B4B" 
        },
        ...
    ],...
}

Cada objeto sessão contém as propriedades abaixo (quando não estiverem disponíveis, as propriedades não são devolvidas):

Nome da propriedade	Tipo	Descrição
type	Texto (enum)	Tipo de sessão. Valores possíveis: "remote", "storedProcedure", "web", "rest"
hostType	Texto (enum)	Tipo de host. Valores possíveis: "windows", "mac", "browser"
userName	Texto	Nome de usuario
machineName	Texto	Nome da máquina remota
systemUserName	Texto	Nome da sessão do sistema aberta na máquina remota
IPAddress	Texto	Endereço IP da máquina remota
creationDateTime	Date ISO 8601	Data e hora da conexão da máquina remota
state	Texto (enum)	Estado das sessões. Valores possíveis: "active", "postponed", "sleeping"
ID	Texto	UUID da sessão

Lista Processo

A propriedad e "processo" contém uma coleção de objetos que descrevem todos os processos em execução no servidor, por exemplo:

{
    "processes": [
        {
            "state": 0,
            "cpuTime": 12.755332415303,
            "preemptive": true
        },
        {
            "name": "processOnServer",
            "sessionID": "BB8A0C8420FE5741B59F3B13F40A3063",
            "number": 6,
            "ID": 6,
            "visible": true,
            "type": 1,
            "state": 0,
            "cpuTime": 0.40872755886655,
            "preemptive": false
        },
        {
            "name": "ServerNet select I/O handler",
            "state": 0,
            "cpuTime": 0.015625,
            "preemptive": true
        },...
    ]
}

Cada objeto processo contém as propriedades abaixo (quando não estiverem disponíveis, as propriedades não são devolvidas):

Nome

Tipo

Descrição

name

Texto

Nome de processo

sessionID

Texto

UUID da sessão

type

Entero largo

Tipo de processo em execução. Pode utilizar as seguintes constantes do tema "Tipo de processo":

Constante	Valor	Comentário
HTTP Log flusher	-58
Logger process	-57
HTTP Listener	-56
HTTP Worker pool server	-55
SQL Listener	-54
SQL Net Session manager	-53
SQL Worker pool server	-52
DB4D Listener	-51
DB4D Mirror	-50
DB4D Cron	-49
DB4D Worker pool user	-48
DB4D Garbage collector	-47
DB4D Flush cache	-46
DB4D Index builder	-45
ServerNet Session manager	-44
ServerNet Listener	-43
Worker pool spare	-42
Worker pool in use	-41
Other internal process	-40
Main 4D process	-39
Client manager process	-31
Compiler process	-29
Monitor process	-26
Internal timer process	-25
SQL Method execution process	-24
MSC process	-22
Restore Process	-21
Log file process	-20
Backup process	-19
Internal 4D server process	-18
Method editor macro process	-17
On exit process	-16
Server interface process	-15
Execute on client process	-14
Web server process	-13
Web process on 4D remote	-12
Other 4D process	-10
External task	-9
Event manager	-8
Apple event manager	-7
Serial Port Manager	-6
Indexing process	-5
Cache manager	-4
Web process with no context	-3
Design process	-2
Main process	-1
None	0
Execute on server process	1
Created from menu command	2
Created from execution dialog	3
Other user process	4
Worker process	5	Processos Worker lançados pelo usuário

state

Inteiro longo

Estado atual (ver a lista de constantes Estado do processo)

cpuTime

Real

Tempo de execução (segundos)

cpuUsage

Real

Porcentagem de tempo dedicado a este processo (entre 0 e 1)

preemptive

Booleano

se executar preemptivo,do contrário false

visible

Booleano

True se for visível, do contrário false

Inteiro longo

Identificador único do processo

number

Inteiro longo

Número do processo

Exemplo

Se quiser obter a coleção de todas as sessões de usuário:

  //A ser executado no servidor

 C_OBJECT($result)

 C_COLLECTION($userCol)

 $result:=Get process activity(Sessions only)

 $userCol:=OB Get($result;"users")

Ver também

PROCESS PROPERTIES
WEB Get server info