Configuration de l'intercepteur de consignateur de système de fichiers z/OS Connect

L'intercepteur de consignateur de système de fichiers permet aux utilisateurs z/OS Connect de consigner des informations de demande dans un fichier du système de fichiers.

Pourquoi et quand exécuter cette tâche

Cette fonction est disponible lorsque vous configurez la fonction zosConnect-1.0 ou zosConnect-1.2 ; une configuration est requise.

Tableau 1. Descriptions des entrées du fichier journal généré
Entrée Description
DateTime Date et heure calculées par l'intercepteur de consignateur avant l'appel de service.
ThreadID ID de l'unité d'exécution sous laquelle la demande de service est traitée.
UserName Nom d'utilisateur pour lequel la demande est traitée.
RequestID ID de suivi de demande généré par z/OS Connect
RemoteAddress Adresse IP du client à l'origine de la demande ou du dernier proxy ayant envoyé la demande.
LocalAddress Adresse IP de l'interface sur laquelle la demande a été reçue.
MessageType Indique si le contenu provient d'une demande ou d'une réponse.
MessageSize Taille de caractère du contenu.
MessageData Contenu d'une demande ou d'une réponse.
*****************************************************************************
ServerName: com.ibm.ws.zos.connect.interceptor.logger.fs
*****************************************************************************
DateTime:2015-07-19_12-14-02 | ThreadId:47 | UserName:Fred | RequestID:0000000000000001000000000000000000000000000000 | 
RemoteAddress:127.0.0.1 | LocalAddress:127.0.0.1
MessageType:REQUEST
MessageSize:27
MessageData:{"payload":"HELLO_SERVICE"}

DateTime:2015-07-19_12-14-02 | ThreadId:47 | UserName:Fred | RequestID:0000000000000001000000000000000000000000000000 | 
RemoteAddress:127.0.0.1 | LocalAddress:127.0.0.1
MessageType:RESPONSE
MessageSize:26
MessageData:{"payload":"HELLO_CALLER"}

Procédure

  1. Configurez l'élément fileSystemloggerInterceptor globalement.
    <fileSystemloggerInterceptor id="globalFileSystemLogger" logName="globalLog_%SERVERNAME%"/>
    <zosConnectInterceptors id="globalInterceptorList" interceptorRef="globalFileSystemLogger" />
    <zosConnectManager globalInterceptorsRef="globalInterceptorList/>

    Dans l'exemple, toutes les demandes de service z/OS Connect sont consignées dans un fichier appelé globalLog_myServer1_yyyy-MM-dd_HH_mm_ss_SSS.log, où myServer1 est le nom du serveur. Le seul élément de configuration requis est la définition d'attribut logName. L'élément de configuration accepte une chaîne %SERVERNAME% qui est remplacée par le nom du serveur quand le journal est créé. L'emplacement par défaut du fichier journal est ${server.output.dir}/logs/zosConnect. Pour en savoir plus sur les attributs de configuration disponibles et les valeurs par défaut, voir la documentation de z/OS Connect 1.0 et z/OS Connect 1.2.

    Vous pouvez également configurer l'élément fileSystemloggerInterceptor pour des services spécifiques :
     <fileSystemloggerInterceptor id="serviceYFileSystemLogger" 
                                     logName="service1Log" 
                                     logPath="/zosConnect/logs"
                                     logOption="RESPONSE"
                                     maxPayloadSize="30720"/>
    <zosConnectInterceptors id="serviceYInterceptorList" interceptorRef="serviceYFileSystemLogger" />
    <zosConnectService serviceName="serviceY" serviceRef="serviceY" interceptorsRef="serviceYInterceptorList"/>
    <usr_myService id="serviceY"/>

    Dans l'exemple, toutes les demandes de service z/OS Connect sont consignées dans un fichier appelé service1Log_yyyy-MM-dd_HH_mm_ss_SSS.log situé sous le chemin d'accès /zosConnect/logs. Le chemin d'accès au journal est un chemin qualifié complet. Seules les données de réponse sont consignées pour toutes les demandes entrantes qui ciblent serviceY. Vu que taille maximale du contenu JSON est configurée pour être de 30 720 caractères, tout contenu (réponse) JSON d'une taille supérieure est tronqué de façon à ne pas dépasser cette taille maximale.

  2. (Facultatif) Configurez les définitions d'attribut bufferedLogging et bufferSize pour activer la consignation en zone tampon. La taille par défaut de la mémoire tampon est de 8 kilooctets. Tous les enregistrements de la mémoire tampon sont transférés sur disque quand la mémoire tampon est pleine. L'utilisation de la consignation en zone tampon est appropriée quand les performances constituent un élément essentiel ou quand la perte d'enregistrements non transférés est acceptable en cas de panne.
     <fileSystemloggerInterceptor id="globalFileSystemLogger" 
                                     logName="globalLog_%SERVERNAME%"
                                     bufferedLogging="true"
                                     bufferSize="16384"/>
  3. (Facultatif) Configurez l'attribut rollOffLogPolicy. Cette règle indique que lorsque le fichier journal actif atteint la taille spécifiée ou par défaut de 50 mégaoctets, un nouveau fichier est créé. Un nouveau fichier peut également être créé à l'expiration de la durée spécifiée ou par défaut de 24 heures depuis la création du fichier journal. Dans l'exemple suivant, un fichier est créé quand le fichier atteint la taille de 16 kilooctets. Le schéma de nommage est le même : globalLog_myServer1_yyyy-MM-dd_HH_mm_ss_SSS.log. La différente entre les noms des fichiers journaux créés réside dans l'horodatage utilisé quand un fichier donné est créé :
    <fileSystemloggerInterceptor id="globalFileSystemLogger" 
                                     logName="globalLog_%SERVERNAME%"
                                     rollOffLogPolicy="SIZE"
                                     rollOffLogPolicySize="16384"/>

Icône indiquant le type de rubrique Rubrique Tâche

Nom du fichier : twlp_zconnect_file_sys_log_int.html