Aller au contenu principal
Version: 20 R7 BETA

Application info

Application info : Object

ParamètreTypeDescription
RésultatObjectInformation sur l'activité de l'application courante

Description

La commande Application info retourne un objet qui fournit des informations détaillées sur l'activité de l'application courante et sa configuration réseau.

La commande peut être exécutée sur des applications locales ou client/serveur. Les informations retournées dépendent de l'environnement dans lequel la commande Application info est exécutée. Par exemple, si la commande est exécutée depuis un 4D distant, les informations concernent uniquement les postes distants. Si la commande est appelée dans une méthode exécutée sur serveur, les informations retournées concernent le serveur.

L'objet retourné contient les propriétés suivantes :

PropriétéTypeDescriptionExemple
volumeShadowCopyStatuschaîneRetourne le statut du Volume Shadow Copy Service. Windows uniquement. Pour plus d'informations, consultez Utiliser Volume Shadow Copy Service sous Windows. Valeurs possibles :
ConstanteValeurComment
vss availableavailableLe service est disponible.
vss errorerrorLe service a rencontré une erreur.
vss not availablenotAvailableLe service est indisponible.
vss update requiredupdateRequiredLe service doit être mis à jour.
"available"
launchedAsServicebooléenVrai si l'application est lancée en tant que service. Valeurs possibles : vrai, faux. Pour plus d'informations, consultez Enregistrer une base comme service.faux
portIDnumérique4D Server : port d'écoute active, 4D distant : port de connexions distantes. Non retourné en mode local. Minimum: 1. Pour plus d'informations, consultez Numéro de port.19814
remoteDebuggerSessionIDtexteID de la session de l'application distante à laquelle est associé le débogueur du serveur. Cet ID est également retourné par Process activity."A838A40BJN3NJKH..."
SDIModebooléenVrai si l'application fonctionne en mode SDI sous Windows (inutile sous macOS). Valeurs possibles : vrai, faux. Pour plus d'informations, voir le mode SDI sur developer.4d.comvrai
TLSEnabledbooléenVrai si TLS activé pour les communications client/serveur. Non retourné en mode local. Valeurs possibles : vrai, faux. Pour plus d'informations, consultez Qu’est-ce que le protocole TLS dans le cadre des connexions client/serveur ?.vrai
newConnectionsAllowedbooléen4D Server uniquement. Vrai si de nouvelles connexions sont autorisées. Valeurs possibles : vrai, faux. Pour plus d'informations, consultez .vrai
cpuUsage(*)numériquePourcentage du processeur utilisé par 4D. Notez que, pour les Macs, le nombre affiché correspond à 1 cœur et représente une moyenne pour le processeur.10.03
headlessbooléenVrai si l'application est lancée sans interface (mode headless). Valeurs possibles : vrai, faux. Pour plus d'informations, voir Interface ligne de commande.faux
uptimenumériqueTemps écoulé (en secondes) depuis l'ouverture de la base locale 4D. Pour les connexions distantes, retourne le temps écoulé depuis que la connexion a été effectuée.143
pidnumériqueID du process de l'instance de l'application 4D (fourni par le système d'exploitation) -- permet d'identifier chaque instance 4D en cours d'exécution, à partir d'un script externe par exemple16600
networkInputThroughput(*)numériqueDébit de données (octets/secondes) pour les entrées réseau de la machine exécutant l'application. En mode distant, le débit de la machine distante est retourné. Pour plus d'informations, consultez Page Moniteur.37311495
networkOutputThroughput(*)numériqueDébit de données (octets/secondes) pour les sorties réseau de la machine exécutant l'application. En mode distant, le débit de la machine distante est retourné. Pour plus d'informations, consultez Page Moniteur.88058023
useLegacyNetworkLayerbooléenVrai si l'ancienne couche réseau est utilisée pour le serveur d'application. Non retourné en mode local. Valeurs possibles : vrai, faux. Pour plus d'informations, consultez Activer ou désactiver l'ancienne couche réseau.faux
IPAddressesToListencollection4D Server uniquement. Retourne les adresses IP écoutées par 4D Server. Pour plus d'informations, consultez IP configuration.["192.168.18.12","192.168.18.10"]
IPAddressesAllowDenycollection4D Server uniquement. Retourne une collection d'adresses IP autorisées ou refusées dans les paramètres de la base. Pour plus d'informations, consultez IP configuration.[{"mode": "allow", "ip": "192.168.*"},{...}]
[ ].modechaînePropriété décrivant si l'adresse IP est autorisée ou non. Valeurs possibles : "allow" ou "deny""allow"
[ ].ipchaîneAdresse IP"192.167.1.2"
useQUICNetworkLayerbooléenVrai si la couche réseau QUIC est utilisée pour le serveur d'application et le serveur db4d (beta dans 4D v20, voir Page Compatibilité). Non retourné en mode local. Valeurs possibles : vrai, faux. Pour plus d'informations, voir cet article de blog.faux

(*) Sur Windows, vous devez vous assurer que ce compteur est préalablement initialisé, en appelant par exemple la commande Application info dans la On Startup database method.

Exemple

Le code suivant retourne un objet contenant des informations sur l'application courante :

 var $appInfo : Object
 $appInfo:=Application info

Si le code est exécuté sur un 4D en mode local, l'objet contient (par exemple) :

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

Si le code est exécuté depuis un 4D distant, l'objet contient (par exemple) :

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

Si le code est exécuté sur 4D Server, l'objet contient (par exemple) :

{
"launchedAsService": false,
"volumeShadowCopyStatus": "notAvailable",
"cpuUsage": 10.016125,
"portID": 19814,
"TLSEnabled": false,
"uptime": 192,
"headless": false,
"pid": 9560,
"useLegacyNetworkLayer": true,
"useQUICNetworkLayer": false,
"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
}

Voir aussi

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