WEB Get server info

Home

4D v19.8

WEB Get server info


WEB Get server info {( withCache )} -> Funktionsergebnis

Parameter	Typ	Beschreibung
withCache	Boolean	Wahr, um Angaben zum Web Cache zurückzugeben. Standardmäßig werden keine Angaben zum Cache zurückgegeben.
Funktionsergebnis	Objekt	Angaben zum laufenden Web Server und SOAP Server

Beschreibung

Die Funktion WEB Get server info gibt ein Objekt mit detaillierten Angaben zur aktuellen 4D Web Server Sitzung im laufenden Betrieb zurück. Dazu gehört auch der SOAP Server.

Hinweis: Die Funktion gibt Information im laufenden Betrieb zurück. z.B. aktuelle Parameter, die der Web Server nutzt. Diese können sich von den Werten unterscheiden, die der Befehl WEB GET OPTION zurückgibt, da sie von Systemeinstellungen, verfügbaren Ressourcen, etc. abhängen.

Standardmäßig gibt die Funktion nicht die Eigenschaft "cache" zurück, da dies sehr umfangreich sein kann. Um den Inhalt des Cache zu erhalten, übergeben Sie Wahr im optionalen Parameter withCache.

Das zurückgegebene Objekt enthält folgende Eigenschaften. Beachten Sie, dass die Bezeichnungen Groß- und Kleinschreibung berücksichtigen:

Eigenschaft		Wertetyp	Beschreibung
started		Boolean	Wahr, wenn der http Server gestartet ist, sonst falsch
uptime		Zahl	Abgelaufene Zeit seit dem letzten Start des http Server
httpRequestCount		Zahl	Anzahl der empfangenen http hits seit Serverstart
startMode		String	"Automatisch" wenn in den Datenbank-Eigenschaften auf der Seite Web die Option “Web Server automatisch starten" markiert ist, sonst "manuell"
SOAPServerStarted		Boolean	Wahr, wenn der SOAP Server gestartet ist, sonst falsch
cache		Objekt	Diese Eigenschaft ist nur enthalten, wenn der Wert des Parameters withCache auf wahr gesetzt ist. Beschreibt den Inhalt des Web Server Cache (siehe unten Eigenschaft cache)
security		Objekt	Aktueller Status der verschiedenen Sicherheitsoptionen
	cipherSuite	String	Von 4D verwendete Cipher Liste für das SSL Protokoll (entspricht dem Datenbankparameter SSL cipher list)
	HTTPEnabled	Boolean	Wahr, wenn HTTP aktiviert ist
	HTTPSEnabled	Boolean	Wahr, wenn HTTPS aktiviert ist
	HSTSEnabled	Boolean	Wahr, wenn HSTSE auf dem Server aktiviert ist
	HSTSMaxAge	Zahl	Maximales Alter (in Sekunden) für HSTS. Standard sind 2 Jahre (63.072.000 Sekunden).
	minTLSVersion	String	Erforderliche TLS Mindestversion für Verbindungen (entspricht dem Datenbankparameter Min TLS version)
	openSSLVersion	String	Version der verwendeten OpenSSL Library
	perfectForwardSecrecy	Boolean	Wahr, wenn PFS auf dem Server verfügbar ist, sonst Falsch
options		Objekt	Aktueller Status der verschiedenen Optionen des Standard Web Server
	CORSEnabled	Boolean	Wahr, wenn CORS Dienst auf dem Server aktiviert ist, sonst Falsch (Standard)
	CORSSettings	Collection	Collection der CORS Objekte für die Liste der erlaubten Host(s) und Methode(n) (siehe Web Option Web CORS settings)
	webCharacterSet	String	Name des Zeichensatzes (entspricht der Web Option Web character set)
	webHTTPCompressionLevel	Zahl	Komprimierungsebene für komprimierten HTTP Austausch (entspricht der Web Option Web HTTP compression level)
	webHTTPCompressionThreshold	Zahl	Komprimierungsrate (entspricht der Web Option Web HTTP compression threshold)
	webHTTPSPortID	Zahl	Vom Web Server benutzte TCP Port Nummer für sichere Verbindungen (entspricht Web HTTPS port ID)
	webInactiveProcessTimeout	Zahl	Lebensdauer der inaktiven Prozesse der Sitzung (entspricht der Web Option Web inactive process timeout)
	webInactiveSessionTimeout	Zahl	Lebensdauer der inaktiven Sitzungen (entspricht der Web Option Web inactive session timeout)
	webIPAddressToListen	Collection	IP Adresse(n) im definierten "Format", auf denen der Web Server http Anfragen erhält (entspricht der Web Option Web IP address to listen)
	webMaxConcurrentProcesses	Zahl	Maximale Anzahl gleichzeitig laufende Web Prozesse (entspricht der Web Option Web max concurrent processes)
	webPortID	Zahl	Vom Web Server benutzter TCP Port (entspricht der Web Option Web port ID)

4D Server: Die Funktion gibt Information über den lokalen Web Server zurück. Um den Web Server des 4D Server über remote 4D zu überwachen, müssen Sie der Methode die Eigenschaft "Auf Server ausführen" übergeben.

Eigenschaft cache

Übergeben Sie wahr im Parameter withCache, gibt die Funktion die Objekteigenschaft "cache" mit folgendem Inhalt zurück:

Bezeichnung	Wertetyp	Beschreibung
cacheUsage	Zahl	Rate der Cache Verwendung
numOfLoads	Zahl	Anzahl der geladenen Objekte
currentSize	Zahl	Aktuelle Größe des Cache
maxSize	Zahl	Maximale Größe des Cache
objectMaxSize	Zahl	Maximale Größe der im Cache ladbaren Objekte
enabled	Boolean	Wahr, wenn der Cache des Web Server aktiviert ist
nbCachedObjects	Zahl	Anzahl der Objekte im Cache
cachedObjects	Collection	Objekt Collection im Cache. Jedes Cache Objekt ist durch verschiedene Eigenschaften definiert (url, mimeType, expirationType, lastModified, etc.)

Beispiel

Nach Ausführen des Code:

$webServerInfo:=WEB Get server info(True)

... kann $webServerInfo z.B. Beispiel folgende Angaben enthalten:

{
   "started": true,
   "uptime": 40,
   "SOAPServerStarted": true,
   "startMode": "manual",
   "httpRequestCount": 0,
   "options": {
      "CORSEnabled": false,
      "CORSSettings": null,
      "webCharacterSet": "UTF-8",
      "webHTTPCompressionLevel": 1,
      "webHTTPCompressionThreshold": 1024,
      "webHTTPSPortID": 443,
      "webIPAddressToListen": ["192.168.xxx.xxx"],
      "webInactiveProcessTimeout": 28800,
      "webInactiveSessionTimeout": 28800,
      "webMaxConcurrentProcesses": 100,
      "webPortID": 80
   },
   "security": {
      "HTTPEnabled": 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": [
            {...},{...}
         ]
   }
}

Siehe auch

Get license info
Get process activity
SOAP REJECT NEW REQUESTS