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 plus d'informations sur les attributs de configuration disponibles et les valeurs par défaut, voir la documentation relative à 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. Parce que la taille de la charge maximale de JSON est configurée pour être 30 720 caractère, tout contenu (réponse) JSON d'une taille supérieure est tronqué de façon à ne pas dépasser cette taille de charge 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



Icône d'horodatage Dernière mise à jour: 7 juin 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_zconnect_file_sys_log_int
Nom du fichier : twlp_zconnect_file_sys_log_int.html