Enregistrement des journaux d'activité dans des fichiers, sur la console du serveur d'intégration ou dans une pile d' ELK

Vous pouvez enregistrer vos journaux d'activité dans un fichier, sur la console du serveur d'intégration (sortie standard), dans une pile d' ELK, ou dans une combinaison de ces destinations de sortie.

A propos de cette tâche

Par défaut, vous pouvez afficher les données de journal d'activité récentes pour un flux de messages à l'aide de la vue Journal d'activité de l'interface utilisateur Web, comme décrit dans Affichage des journaux d'activité pour les flux de messages dans l'interface utilisateur Web. Si vous souhaitez afficher les activités sur une période plus longue, vous pouvez également écrire des journaux d'activité dans les destinations de sortie suivantes:

Système de fichiers: Les journaux d'activité peuvent être écrits dans un système de fichiers circulaire, ce qui permet une consignation continue des activités sur une longue période. Vous pouvez utiliser les propriétés d'une règle de journal d'activité ou d'un fichier server.conf.yaml pour activer l'écriture d'entrées de journal d'activité dans des fichiers, et configurer la taille et le nombre de fichiers journaux ainsi que les critères selon lesquels le journal passe d'un fichier à l'autre. Vous pouvez également identifier l'emplacement et le nom de fichier des fichiers journaux.
Logstash dans une pile d' ELK: Vous pouvez utiliser les propriétés d'une stratégie ou server.conf.yaml d'un fichier de journal d'activité pour contrôler la publication des données du journal d'activité vers Logstash dans une pile ELK. La publication des données du journal d'activité sur ELK est désactivée par défaut.
Console du serveur d'intégration (sortie standard): Vous pouvez écrire des entrées de journal d'activité dans la console du serveur d'intégration (sortie standard) en définissant la propriété consoleLog dans la règle ActivityLog ou le fichier server.conf.yaml sur true. Configurez le format de ces entrées en définissant leconsoleLogFormat propriété à texte d'identification, texte ou ibmjson.

Vous pouvez spécifier la destination de sortie des données de journal d'activité (et configurer les données de journal d'activité que vous souhaitez capturer), à l'aide d'une règle de journal d'activité ou en définissant des propriétés dans la section ActivityLog du fichier server.conf.yaml du serveur d'intégration.

Vous pouvez utiliser une règle de journal d'activité ou des propriétés du fichier server.conf.yaml pour configurer les caractéristiques de journal d'activité suivantes:

Indique si la journalisation de fichier est activée
Nombre maximal de fichiers utilisés pour chaque journal
Taille maximale des fichiers journaux (avant la rotation du journal vers le fichier suivant). Si la taille maximale n'est pas atteinte et que le serveur d'intégration est redémarré, un nouveau fichier journal est créé.
Age maximal des fichiers journaux (avant que le journal ne passe au fichier suivant)
Filtres qui déterminent le contenu des journaux
Niveaux de gravité des messages consignés
Chemin d'accès au journal et nom de fichier
Indique si les messages sont formatés avec des insertions incluses dans le texte du message
Portée de la règle (à quel serveur d'intégration elle s'applique)
Si la publication sur ELK est activée
La configuration de connexion à utiliser pour l' ELK

La portée des paramètres est le serveur d'intégration. Par exemple, si vous définissez la propriété Number of log files sur 5, chaque serveur d'intégration dispose d'un maximum de cinq fichiers pour son journal d'activité.

Procédure

Configurez la consignation des activités à l'aide de l'une des méthodes suivantes:

Définition d'une règle de journal d'activité:
1. Créez une stratégie de journalisation des activités à l'aide de l'éditeur de stratégies de la boîte à outils « IBM® App Connect Enterprise ».
  Pour plus d'informations sur la création d'une stratégie, consultez la section « Création de stratégies à l'aide de l'outil IBM App Connect Enterprise Toolkit ».
2. Définissez les valeurs appropriées pour les propriétés de la règle, comme décrit dans la règle Journal d'activité (ActivityLog).
3. Déployez la règle Journal d'activité avec les flux de messages auxquels la règle s'applique.
  Pour plus d'informations sur le déploiement d'une règle, voir Remplacement des propriétés lors de l'exécution par des règles.
Définissez les propriétés ActivityLog dans le fichier server.conf.yaml du serveur d'intégration, comme décrit dans Configuration de la sortie du journal d'activité.