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"}
- 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.
- (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"/>
- (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"/>