WEB Get server info

4D v18

WEB Get server info


WEB Get server info {( comCache )} -> Resultado

Parâmetro	Tipo	Descrição
comCache	Booleano	True para retornar a descrição web cache. Senão (pré-determinado) a descrição da cache não é retornada
Resultado	Objeto	Informação no servidor Web executando e servidor SOAP

Descrição

O comando WEB Get server info devolve um objeto que contèm informação do tempo de execução detalhada na sessão atual do servidor web 4D. A informação devolvida inclui o servidor SOAP.

Nota: Esse comando retorna runtime information, ou seja. Parâmetros atuais usados pelo servidor Web. Esses parâmetros podem ser diferentes daqueles retornados pelo comando WEB GET OPTION já que dependem de configurações de sistema, recursos disponíveis, etc.

De forma pré-determinada, o comando não devolve a propriedad e "caché", já que pode ser muito grande. Entretanto, se quiser conhecer o conteúdo da caché, passe True no parâmetro opcional conCache.

O objeto devolvido contém as propriedades abaixo (os nomes de propriedade são sensíveis às maiúsculas e minúsculas):

Nome da propriedade			Tipo de valor	Descrição
started			Booleano	true se for iniciado o servidor http, do contrário false
uptime			Número	Tempo transcorrido desde o último início de servidor http
httpRequestCount			Número	Número de visitas HTTP recebidas pelo servidor desde que foi iniciado
startMode			String	"automático" se estiver ativada a opção "Iniciar servidor web no início", do contrário "manual".
SOAPServerStarted			Booleano	true se for iniciado o servidor SOAP, no caso contrário false
cache			Objeto	Esta propriedade só é incluída se o valor da propriedade do parâmetro cacheInfo for True. Descreve o conteúdo da caché de servidor web (ver Propriedade de cache abaixo)
security			Objeto	Estado atual das diferentes opções de segurança
	properties		Objeto	Estado atual das diversas propriedades de segurança
		TLSEnabled	Booleano	Verdadeiro se TLS for iniciado no início do servidor
		openSSLVersion	String	Versão da biblioteca OpenSSL utilizada
		cipherSuite	String	Lista de cifras utilizada por 4D para o protocolo seguro (corresponde ao parâmetro do banco de dados SSL cipher list)
		minTLSVersion	String	Versão TLS mínima aceita para as conexôes (corresponde ao parâmetro de banco de dados Min TLS version)
options			Objeto	Estado atual de várias opções de servidor web padrão
	properties		Objeto	Estado atual de várias propriedades de opção de servidor web padrão
		webCharacterSet	String	Nome de conjunto de caracteres (corresponde a opção web Web character set)
		webHTTPCompressionLevel	Número	Nivel de compressão para os intercâmbios HTTP comprimidos (corresponde à opção web Web HTTP compression level)
		webHTTPCompressionThreshold	Number	Valor de compressão (corresponde à opção web Web HTTP compression threshold)
		webHTTPSPortID	Number	Número de porto TCP utilizado pelo servidor Web para conexôes seguras (corresponde à opção web Web HTTPS port ID)
		webInactiveProcessTimeout	Número	Duração de vida dos processos de sessão inativos (corresponde a opção web Web inactive process timeout)
		webInactiveSessionTimeout	Número	Duração da vida das sessões inativas (corresponde a opção web Web inactive session timeout)
		webIPAddressToListen	Coleção	O endereço IP (e) no "formato" definido no qual o servidor web recebe as solicitações http (corresponde a opção web Web IP address to listen)
		webMaxConcurrentProcesses	Número	Número máximo de procesos web simultáneos (corresponde a la opción web Web max concurrent processes)
		webPortID	Número	Porto TCP utilizado pelo servidor Web (corresponde a opção web Web port ID)

Nota: este comando devolve informação de tempo de execução, ou seja, parâmetros reais utilizados pelo servidor Web. Estes parâmetros podem diferir dos devolvidos pelo comando WEB GET OPTION já que dependem da configuração de sistema, os recursos disponíveis, etc.

Propriedade de cache

Se passar true no parâmetro conCache, o comando devolve a propriedade objeto "cache" com o conteúdo abaixo:

Nome da propriedade	Tipo de valor	Descrição
cacheUsage	Número	Taixa de uso da caché
numOfLoads	Número	Número de objetos carregados
currentSize	Número	Tamanho atual da caché
maxSize	Número	Tamanho máximo da caché
objectMaxSize	Número	Tamanho máximo de objetos carregáveis na caché
enabled	Booleano	true se a caché de servidor web estiver ativada
nbCachedObjects	Número	Número de objetos na caché
cachedObjects	Coleção	Coleção de objetos na caché. Cada objeto em caché é definido por diferentes propriedades (url, mimeType, expirationType, lastModified, etc.)

Exemplo

Depois de executar o código abaixo:

$webServerInfo:=WEB Get server info(True)

... $webServerInfo conterá por exemplo:

{
   "started": true,
   "uptime": 40,
   "SOAPServerStarted": true,
   "startMode": "manual",
   "httpRequestCount": 0,
   "options": {
      "webCharacterSet": "UTF-8",
      "webHTTPCompressionLevel": 1,
      "webHTTPCompressionThreshold": 1024,
      "webHTTPSPortID": 443,
      "webIPAddressToListen": ["192.168.xxx.xxx"],
      "webInactiveProcessTimeout": 28800,
      "webInactiveSessionTimeout": 28800,
      "webMaxConcurrentProcesses": 100,
      "webPortID": 80
   },
   "security": {
      "TLSEnabled": true,
      "cipherSuite": "ECDHE-RSA-AES128-GCM-SHA256:...:CAMELLIA128-SHA",
      "openSSLVersion": "OpenSSL 1.0.2h 3 May 2016",
      "perfectForwardSecrecy": true,
      "minTLSVersion": "1.2" 
   },
    "cache": {
        "cacheUsage": 1,
        "numOfLoads": 24,
        "currentSize": 154219,
        "maxSize": 10485760,
        "objectMaxSize": 524288,
        "enabled": true,
        "nbCachedObjects": 23,
        "cachedObjects": [
            {...},{...}
         ]
   }
}

Ver também

Get license info
Get process activity
SOAP REJECT NEW REQUESTS