Documentation sur Oracle Cloud Infrastructure

Activer et utiliser les journaux de la passerelle d'application

La passerelle d'application fournit des fichiers journaux pour vous aider à surveiller le comportement de la passerelle d'application. Voyez comment configurer ces fichiers journaux et y accéder.

Configurer les journaux de la passerelle d'application

Les journaux sont activés par défaut. Pour désactiver les journaux ou modifier les niveaux de journalisation du serveur de passerelle d'application, connectez-vous au serveur, modifiez le fichier /usr/local/nginx/conf/cloudgate.config, puis dans la section general, modifiez la valeur de l'attribut logLevel, puis enregistrez le fichier.

Voici les valeurs par défaut de la passerelle d'application :
"general":{
      "disableAuthorize":false,
      "logLevel":"warn",
      "logFolder":"",
      "policyMode":"gateway",
      "policyRefreshTime":300,
      "policyStaleTime":3600,
      "policyExpiryTime":604800
    }
Note

Les valeurs de l'attribut logLevel sont : off | crit | security | config | fail | warn | info | trace1 | trace2 | trace3.

Par défaut, les fichiers journaux se trouvent dans le dossier /usr/local/nginx/logs. Si vous voulez modifier le dossier de journaux par défaut, mettez à jour la valeur de l'attribut logFolder dans la section general du fichier /usr/local/nginx/conf/cloudgate.config.

Pour modifier le niveau de journalisation du service d'agent de la passerelle d'application, modifiez le fichier /usr/local/nginx/conf/cloudgate.config, puis réglez les attributs logLevel et logFolder dans la section agentConfig comme suit :

Par exemple, pour remplacer le niveau de journal par trace3 et le dossier de journaux par /tmp, mettez à jour le fichier /usr/local/nginx/conf/cloudgate.config avec les valeurs suivantes, puis enregistrez le fichier.
"agentConfig":{
   "pollIntervalSecs":60,
   "daemon":true,
   "logFolder":"/tmp",
   "logLevel":"trace3"
  }

Les modifications apportées au niveau de journalisation et au dossier du journal prennent effet au démarrage suivant de la passerelle d'application.

Voir les journaux de la passerelle d'application

La passerelle d'application est basée sur un serveur NGINX. Les fichiers journaux natifs NGIX suivants se trouvent dans le répertoire /usr/local/nginx/logs/ :

Fichiers journaux natifs NGINX
Fichier journal Description
access.log NGINX Le journal d'accès natif contient des informations sur toutes les demandes HTTP reçues par NGINX et par la passerelle d'application.
error.log NGINX Journal de débogage natif.
nginx.pid Contient l'ID processus du serveur NGINX.

Les fichiers journaux spécifiques à la passerelle d'application suivants se trouvent dans le répertoire /usr/local/nginx/logs/ :

Fichiers journaux de la passerelle d'application
Fichier journal Description
cg-trace-main.log Fichier journal principal de la passerelle d'application.
cg-trace-policy.log Enregistre les informations sur une actualisation de politique lorsque la passerelle d'application contacte le service IAM.
cg-trace-session.log Enregistre les informations sur les sessions créées et gérées par la passerelle d'application.
cg-trace-token.log Enregistre les informations sur les jetons d'accès reçus par la passerelle d'application.
cg-trace-agent.log Fichier journal de l'agent.
cg-trace-init.log Contient des informations sur le processus d'initialisation.