Get application info

4D v20 R7


Get application info -> Resultado

Parâmetro	Tipo	Descrição
Resultado	Objeto	Informação sobre a atividade da aplicação ativa

Exemplo 1

O comando Get application info retorna um objeto que traz informação detalhada sobre a atividade da aplicação ativa e da configuração de rede.

O comando pode ser executado em aplicações rodando tanto em modo standalone e ambientes cliente/servidor. A informação retornada depende de onde Get application info for executado. Por exemplo, se executado a partir de um 4D remoto, a informação se aplica apenas a uma workstation remota. Entretanto, se o comando for selecionado, a informação retornada aplica ao servidor.

O objeto retornado contém as propriedades abaixo:

Propriedade Tipo Descrição Exemplo

cpuUsage(*) number Porcentagem de processamento usado por 4D. Note que para Macs, o número exibido é para 1 núcleo e representa a média do processador. 10.03

headless boolean True se a aplicação estiver rodando em modo headless. Valores possíveis: true, false. Para saber mais, veja Interface da linha de comando. false

IPAddressesAllowDeny collection Só em 4D Servidor. Retorna uma coleção de endereços IP que são permitidos ou negados nas configurações de banco de dados. Para saber mais, veja IP configuration. [{"mode": "allow", "ip": "192.168.*"},{...}]

[ ].mode string Propriedade descrevendo se o endereço IP é permitido ou não. Valores possíveis: : "allow" ou "deny" "allow"

[ ].ip string IP addresses "192.167.1.2"

IPAddressesToListen collection Só em 4D Servidor. Retorna o endereço IP que o Servidor 4D escuta. Para saber mais, veja IP configuration. ["192.168.18.12","192.168.18.10"]

launchedAsService boolean True se a aplicação for lançada como um serviço. Valores possíveis: true, false. Para saber mais, veja Registrar um banco de dados como serviço. false

networkInputThroughput number A taxa de dados (bytes/segundos) para input de rede da máquina rodando a aplicação. Em modo remoto, a taxa para a máquinia remota é retornada. Para saber mais, veja Página Monitor. 37311495

networkOutputThroughput number A taxa de dados (bytes/segundos) para output de rede da máquina rodando a aplicação. Em modo remoto, a taxa para a máquina remota é retornada. Para saber mais, veja Página Monitor. 88058023

useLegacyNetworkLayer boolean True se a capa de rede legado usada para a aplicação servidor. Não retorna nada em modo standalone. Valores possíveis: true, false. Para saber mais, veja Ativar ou desativar a capa de rede antiga. false

newConnectionsAllowed boolean Só em 4D Server. True se novas conexões forem permitidas. Valores possíveis: true, false. Para saber mais, veja . true

pid number ID da instância do processo da aplicação 4D (fornecida pelo OS) -- permite identificar cada instância 4D executando, por exemplo a partir de um script externo 16600

portID number 4D Server: porta para listening ativo, 4D remote: porta para conexões remotas. Não retorna nada em modo standalone. Minimum: 1. Para saber mais, veja Número de porta. 19814

remoteDebuggerSessionID text Sessão ID da aplicação remota a qual o depurador servidor está anexado. Essa ID também é retornada por Process activity. "A838A40BJN3NJKH..."

TLSEnabled boolean True se TLS estiver ativado para comunicações cliente/servidor. Não retorna nada em modo standalone. Valores possíveis: true, false. Para saber mais, veja O protocolo SSL e as conexões cliente/servidor. true

uptime number Tempo passado (em segundos) desde que o banco de dados 4D local foi aberto. Para conexões remotas, retorna o tempo decorrido desde que a conexão foi feita. 143

useLegacyNetworkLayer boolean True se a camada de rede legado for usada pelo servidor de aplicação. Não retornado em ambiente standalone. Possíveis valores: true, false. Para saber mais veja Ativar ou desativar a capa de rede antiga. false

useQUICNetworkLayer booleano True si la capa de red QUIC utilizada para el servidor de la aplicación y el servidor db4d (beta en 4D v20, ver Página Compatibilidade). No devuelto en entorno monopuesto. Valores posibles: true, false. Para más información ver este blog post. false

volumeShadowCopyStatus

string

Retorna o estado do Serviço Volume Shadow Copy. Só para Windows. Para saber mais, veja Usar Serviço Volume Shadow Copy em Windows.

Valores possíveis:

Constante	Valor	Comentário
vss available	available	O serviço está disponível
vss error	error	O serviço experimentou um erro.
vss not available	notAvailable	O serviço não está disponível
vss update required	updateRequired	O serviço precisa ser atualizado

"available"

(*) Em Windows, deve ser iniciado previamente este contador, por exemplo, mediante uma chamada ao comando Get application info em Método banco de dados On Startup.

Exemplo 2

O código abaixo retorna um objeto que contém informação sobre a aplicação que está rodando:

 C_OBJECT($appInfo)

 $appInfo:=Get application info

Se o código for executado de um ambiente standalone, o objeto vai conter (por exemplo):


{
    "launchedAsService": false,
    "volumeShadowCopyStatus": "notAvailable",
    "cpuUsage": 10.035875,
    "uptime": 469,
    "networkInputThroughput": 377263157,
    "networkOutputThroughput": 12345242236 
}

Se o código for executado de um cliente remoto 4D, o objeto vai conter (por exemplo):


{
    "launchedAsService": false,
    "volumeShadowCopyStatus": "notAvailable",
    "cpuUsage": 10.035875,
    "portID": 19814,
    "TLSEnabled": false,
    "uptime": 143,
    "useLegacyNetworkLayer": true,
    "networkInputThroughput": 268047058,
    "networkOutputThroughput": 12207686274 
}

Se o código for executado em 4D Server, o objeto contém (por exemplo):


{
    "launchedAsService": false,
    "volumeShadowCopyStatus": "notAvailable",
    "cpuUsage": 10.016125,
    "portID": 19814,
    "TLSEnabled": false,
    "uptime": 192,
    "useLegacyNetworkLayer": true,
    "newConnectionsAllowed": true,
    "IPAddressesToListen": [
        "192.168.18.8",
        "192.168.18.7" 
    ],

      "IPAddressesAllowDeny": [
       { "mode": "allow", "ip": "192.168.*"},
       {"mode": "deny", "ip": "192.167.15.3"},
       {"mode": "allow", "ip": "192.167.1.2" }
    ],

    "networkInputThroughput": 149014925,
    "networkOutputThroughput": 80238805 
}

Ver também

Execute on server
Get database parameter
Get system info
REJECT NEW REMOTE CONNECTIONS