(Update with the copy of version:DRAFT)
m (1 révision importée)
Ligne 1 : Ligne 1 :
=Journaux centralisés=
+
=Centralized Logs=
{{#anc:Centralized Logs}}
 
 
__TOC__
 
__TOC__
La base de données de journaux centrale contient les messages de journaux générés par les applications Genesys. Le plug-in de journal centralisé pour Genesys Administrator Extension affiche un résumé de ces journaux, à partir duquel vous pouvez sélectionner et étudier ceux qui vous intéressent. Comme pour tous les objets de GAX, vous pouvez voir uniquement les journaux pour lesquels vous avez les privilèges requis.
+
The Centralized Log Database contains log messages generated by Genesys applications. The Centralized Log plugin for Genesys Administrator Extension displays a summary of those logs, from which you can select and investigate any that are of special interest. As with all objects in GAX, you can only see those logs for which you have the required privileges.
  
{{NoteFormat|La base de données de journaux centrale est uniquement compatible avec les systèmes de bases de données Oracle, Microsoft et PostgreSQL ; IBM DB2 n’est pas pris en charge.}}
+
{{NoteFormat|The Centralized Log Database supports only the Oracle, Microsoft, and PostgreSQL DBMS; IBM DB2 is not supported.}}
  
Les messages de journaux stockés dans la base de données de journaux centrale sont de deux types différents :
+
Log messages stored in the Centralized Log Database are of two types:
* Journaux d’application générés par la plupart des applications Genesys, ces journaux utilisent le même format d’enregistrement de journal unifié.
+
* Application logs: Generated by most Genesys applications, these logs feature the same unified log record format.
* Journaux d’audit : générés par certaines applications seulement (notamment Configuration Server et Solution Control Server), ces journaux contiennent des attributs supplémentaires, ainsi que des informations sur les modifications de configuration et les actions de contrôle exécutées dans le cadre de processus, de solutions et d’alarmes.
+
* Audit logs: Generated by only a few applications (notably Configuration Server and Solution Control Server), these logs contain additional attributes and information about configuration changes and control actions performed for processes, solutions, and alarms.
  
Pour afficher le journal centralisé, sélectionnez '''Journaux centralisés''' dans la barre de menus GAX.
+
To view the Centralized Log, select '''Centralized Logs''' in the GAX menu bar.
  
{{#anc:Centralized Log Window}}
+
==Centralized Log Window==
==Fenêtre Journaux centralisés==
+
Log records are displayed in the Centralized Log window.  
Les enregistrements des journaux s’affichent dans la fenêtre Journaux centralisés.  
 
  
Dans la fenêtre, le menu de gauche affiche les vues disponibles pour l’affichage, notamment les recherches enregistrées.
+
In the window, the menu on the left shows the views that are available for display, including any Saved Searches.
{{NoteFormat|Les journaux d’audit s’affichent uniquement dans la vue Audit et dans les résultats d’une recherche dans laquelle le critère '''Type''' est défini sur <tt>Audit</tt>.}}
+
{{NoteFormat|Audit Logs are displayed only in the Audit view, and in the results of any searches where the '''Type''' criteria is set to <tt>Audit</tt>.}}
  
Au-dessus de la liste des journaux, les informations et les commandes suivantes apparaissent :
+
Above the list of logs, the following information and controls appear:
 
<ul>
 
<ul>
<li> Le nombre de journaux qui ont été récupérés et le nombre total de journaux à récupérer. Afin de réduire les délais de récupération de tous les enregistrements d’une base de données de journaux qui contient un nombre important d’enregistrements, les enregistrements sont récupérés par lots à partir de la base de données (la valeur de la taille des lots par défaut est de 100) ; davantage d’enregistrements sont récupérés lorsque vous avez fait défiler la moitié de la liste. De plus, pour optimiser les performances, le nombre d’enregistrements qui peuvent être affichés par GAX est limité (le nombre d’enregistrements par défaut est de 5 000). Si ces paramètres ne vous conviennent pas, vous pouvez les modifier à l’aide des options '''minlogs''' et '''maxlogs''' (respectivement). Reportez-vous à la "[https://docs.genesys.com/Documentation/GA/8.5.2/Dep/CLOG section clog]" du guide ''Genesys Administrator Extension Deployment Guide''.</li>  
+
<li> The number of logs that have been retrieved, and the total number of logs to be retrieved. To minimize any delays caused by retrieving all records from a Log Database that contains a huge number of records, records are retrieved in batches from the Database (default batch size is 100); more records are retrieved when you have scrolled halfway through the existing list. In addition, to increase performance, the number of records that can be displayed by GAX is limited (default number of records is 5000). If these parameters are not adequate for you, you can change them using the '''minlogs''' and '''maxlogs''' options (respectively). Refer to the "[[Documentation:GA:Dep:CLOG|clog Section]]" of the ''Genesys Administrator Extension Deployment Guide''.</li>  
<li> Critères de recherche utilisés pour sélectionner les journaux dans la liste. Par défaut, seuls les journaux générés le jour en cours ('''plage de dates :''' <tt>Aujourd’hui</tt>) sont sélectionnés. Consultez la section [[CentLog#search|Filtrage des journaux]] pour obtenir plus d’informations sur la sélection de journaux à l’aide des filtres.</li>
+
<li> Search criteria used to select the logs in the list. By default, only logs generated on the current day ('''Date Range:''' <tt>Today</tt>) are selected. See [[CentLog#search|Filtering Logs]] for more information about selecting logs using filters.</li>
<li> Quatre icônes de commande :
+
<li> Four control icons:
 
<ul>
 
<ul>
<li>[[File:GAX852-CLsearch.png]] Ouvre la fenêtre de recherche, dans laquelle vous définissez des [[CentLog#search|filtres]] pour créer la liste des journaux qui vous intéressent, ou au moins pour réduire la liste afin que sa taille soit plus facile à gérer.</li>
+
<li> [[File:GAX852-CLsearch.png]] Opens the search window, in which you set [[CentLog#search|filters]] to create the list of logs in which you are interested, or at least reduce the list down to a more manageable size.</li>
<li> [[File:GAX852-CLtrash.png]] Supprime les journaux sélectionnés de la liste. Afin de sélectionner un journal pour le supprimer, cochez la case dans la première colonne. Sélectionnez-en autant que vous le souhaitez, ou cochez la case dans la ligne d’en-tête pour sélectionner tous les enregistrements affichés.
+
<li> [[File:GAX852-CLtrash.png]] Removes selected logs from the list. To select a log for deletion, select the check box in the first column. Select as many as required, or select the check box in the header row to select all of the displayed records.
{{NoteFormat|Si vous cochez la case dans la ligne d’en-tête, vous serez également invité à sélectionner tous les enregistrements dans la base de données (pas seulement les enregistrements affichés) qui répondent aux mêmes critères que les enregistrements affichés. Sélectionnez cette option UNIQUEMENT si vous êtes sûr que vous souhaitez sélectionner, à des fins de suppression, tous les enregistrements dans votre base de données qui répondent à ces critères.|3}}</li>
+
{{NoteFormat|If you select the check box in the header row, you will also be prompted to select all records in the database (not just the displayed records) that meet the same criteria as the displayed records. Choose this option ONLY if you are sure that you want to select for deletion all the records in your database that meet those criteria.|3}}</li>
<li> [[File:GAX852-CLcolumns.png]] Permet de sélectionner les colonnes (attributs) à afficher dans la liste.</li>
+
<li> [[File:GAX852-CLcolumns.png]] Enables you to select what columns (attributes) are displayed in the list.</li>
<li> [[File:GAX852-CLrefresh.png]] Actualise l’affichage.</li>
+
<li> [[File:GAX852-CLrefresh.png]] Refreshes the display.</li>
 
</ul></li>
 
</ul></li>
<li> Case Filtre rapide&mdash;Saisissez du texte dans cette zone pour rechercher des journaux spécifiques sans utiliser la fonction de filtre complète. Ces journaux contenant ce texte (y compris les nombres, tels que l’ID du journal) seront renvoyés et affichés. Ce filtre est sensible à la casse et est cumulatif&mdash;la requête est évaluée puis exécutée. La liste des résultats est mise à jour pendant que vous tapez chaque caractère. Pour des résultats optimaux, saisissez autant de caractères que possible.</li>
+
<li> Quick filter box&mdash;Enter text in this box to search for specific logs without using the full filter capability. Those logs containing that text (including numbers, such as the log ID) will be returned and listed. This filter is case-insensitive, and is cumulative&mdash;the query is evaluated and performed, and the list of results is updated as you type each character. For best results, enter as many characters as you can.</li>
 
</ul>
 
</ul>
  
Chaque enregistrement de journal est affiché avec tous ses attributs ou une partie d’entre eux, de la façon suivante :
+
Each log record is displayed with some or all of its attributes, as follows:
* '''Niveau'''&mdash;[[CentLog#levels|Niveau de journal]] du journal, pour [[CentLog#alarmLL|Alarme]], [[CentLog#stdLL|Standard]], [[CentLog#intnLL|Interaction]] ou [[CentLog#traceLL|Suivi]].  
+
* '''Level'''&mdash;The [[CentLog#levels|log level]] of the log, either [[CentLog#alarmLL|Alarm]], [[CentLog#stdLL|Standard]], [[CentLog#intnLL|Interaction]], or [[CentLog#traceLL|Trace]].  
* '''ID'''&mdash;Identificateur unique du journal, au format <tt><Application id>-<message ID></tt>, <Application ID> est l’ID de l’application qui a généré le journal, et <message ID> est l’identificateur numérique du message du journal, unique dans le composant qui a généré le journal.  
+
* '''ID'''&mdash;The unique identifier of the log, in the format <tt><Application id>-<message ID></tt>, where <Application ID> is the Application ID of the Application that generated the log, and <message ID> is the numeric identifier of the log message, unique within the component that generated the log.  
 
<!--*''' Text'''&mdash;The text of the log message.-->
 
<!--*''' Text'''&mdash;The text of the log message.-->
* '''Description'''&mdash;Texte du message du journal.
+
* '''Description'''&mdash;The text of the log message.
* '''Hôte'''&mdash;Hôte sur lequel l’application qui a généré le journal a été exécuté.
+
* '''Host'''&mdash;The host on which the Application that generated the log was running.
* '''Application'''&mdash;Nom de l’application qui a généré le journal.
+
* '''App'''&mdash;The name of the Application that generated the log.
* '''Date'''&mdash;Date et heure de génération du journal.
+
* '''Date'''&mdash;The date and time when the log was generated.
* '''ID de l’interaction'''&mdash;Identificateur de l’interaction pour laquelle ce journal a été généré. Cet attribut apparaît uniquement pour les journaux de niveau Interaction.
+
* '''Interaction ID'''&mdash;The identifier of the interaction for which this log was generated. This attribute appears only for Interaction-level logs.
Vous pouvez également cliquer sur [[File:GAX852-CLcolumns.png]] et personnaliser les attributs (colonnes) affichés ; par défaut, toutes les colonnes sont affichées.
+
You can also click [[File:GAX852-CLcolumns.png]] and customize what attributes (columns) are displayed; by default, all columns are displayed.
 
   
 
   
Les attributs actuellement affichés dépendent de la sélection effectuée dans le menu à gauche de la fenêtre et des attributs que vous avez choisi d’afficher. Par exemple, l’attribut '''Niveau''' ne s’affiche que si vous avez choisi d’afficher uniquement les journaux de niveau Standard.
+
The actual attributes displayed depends on the selection made in the menu on the left of the window, and on the attributes that you have chosen to display. For example, the '''Level''' attribute is not displayed if you have selected to display only Standard-level logs.
  
Cliquez dans la ligne d’un journal pour afficher les attributs supplémentaires.
+
Click in the line of any log to see additional attributes.
  
{{#anc:Viewing Logs}}
+
==Viewing Logs==
==Affichage des journaux==
+
In the Centralized Log window, you can:
Dans la fenêtre Journaux centralisés, vous pouvez :
+
* View all Application-type logs, by selecting '''All Logs''' under '''Applications''' in the left-hand menu.
* Afficher tous les journaux de type Application, en sélectionnant '''Tous les journaux''' sous '''Applications''' dans le menu de gauche.
+
* View all logs of a certain [[CentLog#levels|level]], by selecting the appropriate level under '''Applications'''.  For example, to view all Standard-level Application logs, select '''Standard''' under '''Applications'''.
* Afficher tous les journaux d'un certain [[CentLog#levels|niveau]], en sélectionnant le niveau approprié sous '''Applications'''.  Par exemple, pour afficher tous les journaux d’application de niveau Standard, sélectionnez '''Standard''' sous '''Applications'''.
+
* View all Audit-type logs, '''All Logs''' under '''Applications''' in the left-hand menu.
* Afficher tous les journaux de type Audit, en sélectionnant '''Tous les journaux''' sous '''Applications''' dans le menu de gauche.
+
* View all logs meeting criteria defined in a saved search, by selecting the search name under '''SAVED SEARCHES''' in the left-hand menu.
* Afficher tous les journaux répondant aux critères définis dans une recherche enregistrée, en sélectionnant le nom de la recherche sous '''RECHERCHES ENREGISTRÉES''' dans le menu de gauche.
+
* Create a new search for all logs meeting specified criteria, by [[CentLog#search|filtering]] the logs based on specified criteria.  
* Créer une recherche pour tous les journaux répondant aux critères spécifiés, en [[CentLog#search|filtrant]] les journaux selon des critères spécifiés.  
 
  
Par défaut, GAX affiche les journaux triés en fonction de leur attribut '''Date'''. Vous pouvez également les trier en fonction de leur '''[[CentLog#levels|Niveau]]''', '''ID''', '''Description''', '''Hôte''', '''Application''' et '''Date''' (et heure) au moment où ils ont été générés. Cliquez sur une cellule de l’en-tête pour trier la liste en fonction de cet attribut et/ou pour modifier l’ordre de la liste (ascendant ou descendant).
+
By default, GAX displays the logs sorted by their '''Date''' attribute. You can sort also them by their '''[[CentLog#levels|Level]]''', '''ID''', '''Description''', '''Host''', '''App''', and '''Date''' (and time) when they were generated. Click in a header cell to sort the list by that attribute and/or to change the order of the list (ascending or descending).
  
 
{{AnchorDiv|search}}
 
{{AnchorDiv|search}}
  
{{#anc:Searching for Logs}}
+
==Searching for Logs==
==Recherche de journaux==
+
You can search for specific logs by filtering a list of logs by one or more search criteria. Click [[File:GAX852-CLsearch.png]] to open the filter window. From this window you can perform a Basic Search or an Advanced Search:
Vous pouvez rechercher des journaux spécifiques en filtrant la liste des journaux selon un ou plusieurs critères de recherche. Cliquez sur [[File:GAX852-CLsearch.png]] pour ouvrir la fenêtre de filtre. Dans cette fenêtre, vous pouvez effectuer une recherche simple ou une recherche avancée :
+
* [[CentLog#basic|Basic search]]&mdash;Enables you to view a subset of the logs using a basic set of criteria.
* [[CentLog#basic|Recherche simple]]&mdash;Vous permet d’afficher un sous-ensemble de journaux à l’aide d’un ensemble de critères de base.
+
* [[CentLog#adv|Advanced search]]&mdash;With specified privileges, enables you to filter the list using additional criteria, save the searches, manage the list of saved searches, and remove some or all of the logs.
* [[CentLog#adv|Recherche avancée]]&mdash;Sous réserve des privilèges spécifiés, vous permet de filtrer la liste à l’aide de critères supplémentaires, d’enregistrer les recherches, de gérer la liste des recherches enregistrées et de supprimer certains ou tous les journaux.
 
  
Cliquez sur '''Enregistrer sous''' pour enregistrer jusqu'à 10 recherches définies, afin de les utiliser plus tard. Si vous souhaitez enregistrer une nouvelle recherche, mais que vous en avez déjà enregistré 10, vous devez supprimer l’une des recherches existantes (cliquez sur la croix '''x''' qui s’affiche lorsque vous passez le curseur sur le nom de la recherche) avant d’enregistrer la nouvelle. Vous pouvez également faire glisser les noms de recherches vers le haut et vers le bas pour les réorganiser dans la liste.  
+
Click '''Save As''' to save up to 10 defined searches, for use at a later time. If you want to save a new search but have already saved 10, you must delete one of the existing searches (click the '''x''' that appears when you hover the mouse on the search name) before saving the new one. You can also drag the search names up and down to reorder them in the list.  
  
 
{{NoteFormat|
 
{{NoteFormat|
* Avant de commencer votre recherche, assurez-vous que tous les enregistrements de journal ont été récupérés de la base de données&mdash;Vérifiez le nombre d’enregistrements dans le coin supérieur droit de la fenêtre de Journaux centralisés.
+
* Before starting your search, be sure that all log records have been retrieved from the database&mdash;check the record count in the top right corner of the Centralized Log window.
* Si vous souhaitez simplement rechercher des enregistrements de journal contenant un texte, ou même un enregistrement de journal avec un ID unique, vous obtiendriez probablement les mêmes résultats avec la recherche simple et avec la recherche avancée en saisissant du texte dans la zone Filtrer le tableau en haut à gauche de la fenêtre.|2}}
+
* If all you want to do is search for log records containing some text, or even a log record with a unique ID, you can most likely get the same results as a Basic or Advanced Search by entering the text in the Filter Table box at the top-left of the window.|2}}
  
 
{{AnchorDiv|basic}}
 
{{AnchorDiv|basic}}
{{#anc:Basic Search}}
+
===Basic Search===
===Recherche simple===
+
In a basic Search, you can filter logs based on '''Host''', '''Application''', '''Tenant''', '''User''', '''Date''', and/or  '''Description'''.  
Dans une recherche simple, vous pouvez filtrer les journaux selon les critères '''Hôte''', '''Application''', '''Locataire''', '''Utilisateur''', '''Date''' et/ou '''Description'''.  
 
  
Notez les points suivants lorsque vous effectuez une recherche simple :
+
Note the following when performing a basic search:
 
<ul>
 
<ul>
<li>Vous pouvez saisir uniquement une valeur de filtre pour chaque attribut.</li>
+
<li>You can enter only one filter value for each attribute.</li>
<li>Les filtres '''Hôte''', '''Application''', '''Locataire''' et '''Utilisateur''' contiennent des listes déroulantes de valeurs de l’attribut correspondant pour chaque enregistrement de journal dans la liste d’origine.</li>
+
<li>The '''Host''', '''Application''', '''Tenant''', and '''User''' filters contain drop-down lists of the values of the corresponding attribute for each log record in the original list.</li>
<li>Le filtre '''Date''' inclut huit valeurs de filtre prédéfinies, comme suit :
+
<li>The '''Date''' filter includes eight predefined filter values, as follows:
 
<ul>
 
<ul>
<li><tt>5 dernières minutes</tt></li>
+
<li><tt>Last 5 Minutes</tt></li>
<li><tt>15 dernières minutes</tt></li>
+
<li><tt>Last 15 Minutes</tt></li>
<li><tt>Dernière heure</tt></li>
+
<li><tt>Last 1 Hour</tt></li>
<li><tt>Aujourd’hui</tt></li>
+
<li><tt>Today</tt></li>
<li><tt>Hier</tt>&mdash;Jours en cours et précédents</li>
+
<li><tt>Yesterday</tt>&mdash;Current and previous days</li>
<li><tt>5 derniers jours</tt>&mdash;5 derniers jours jusqu’à aujourd’hui</li>
+
<li><tt>Last 5 Days</tt>&mdash;Current and last 5 days</li>
<li><tt>30 derniers jours</tt>&mdash;30 derniers jours jusqu’à aujourd’hui</li>
+
<li><tt>Last 30 Days</tt>&mdash;Current and last 30 days</li>
 
</ul>
 
</ul>
Tous les jours commencent à minuit (00:00:00) ; les intervalles en minutes et en heures sont mesurés à partir de l’heure d’exécution du filtre.<br>
+
All days start at midnight (00:00:00); minute and hourly intervals are measured from the time when the filter is run.<br>
Vous pouvez également sélectionner une '''plage de dates personnalisées''', puis sélectionner une plage de dates et d’heures dans les calendriers adjacents qui s’affichent.</li>
+
You can also select '''Custom Date Range''' and select a range of dates and times in the adjacent  calendars that appear.</li>
<li>Le filtre '''Description''' ne contient aucune liste déroulante ; saisissez le texte qui peut être trouvé dans le '''nom d’hôte''', le '''nom de l’application''' ou la '''description''' du journal. Cela est légèrement différent de la zone de '''filtre rapide''' située au-dessus de la liste des enregistrements. En effet, ce champ recherche uniquement le texte correspondant dans trois attributs, et ne peut donc pas être utilisé pour rechercher un journal d’un nombre donné.</li>  
+
<li>The '''Description''' filter has no drop-down list; enter any text that might be found in the '''Host name''', '''Application name''', or '''Description''' of the log. This is somewhat different from the '''Quick Filter''' box located above the record list, in that this field looks only for matching text in three attributes, so cannot be used to look for a log of a given number.</li>  
 
</ul>
 
</ul>
  
Pour filtrer les journaux, sélectionnez une valeur pour un ou plusieurs critères de recherche, puis cliquez sur '''Recherche'''. Les journaux qui répondent aux critères spécifiés sont affichés.
+
To filter the logs, select a value for one or more search criteria, and click '''Search'''. The logs that meet the specified criteria are listed.
  
 
{{AnchorDiv|adv}}
 
{{AnchorDiv|adv}}
  
{{#anc:Advanced Search}}
+
===Advanced Search===
===Recherche avancée===
+
To use the Advanced Search filter, you must have the ACCESS_CLOGS privilege. This advanced filter gives you more search criteria, and if you have the DELETE_CLOGS privilege, you can also delete from the Centralized Log Database some or all of the log records returned by your query.
Pour utiliser le filtre de recherche avancée, vous devez disposer du privilège ACCESS_CLOGS. Ce filtre avancé vous offre davantage de critères de recherche. De plus, si vous disposez du privilège DELETE_CLOGS, vous pouvez également supprimer de la base de données de journaux centrale tout ou partie des enregistrements de journal retournés par votre requête.
 
  
Pour définir un filtre avancé, saisissez d’abord des critères de filtrage pour une [[CentLog#basic|recherche simple]]. Cliquez ensuite sur la flèche en regard de Recherche avancée. La fenêtre de recherche s’étend pour afficher les filtres supplémentaires avec lesquels vous pouvez rechercher des journaux, en particulier :
+
To define an Advanced filter, first enter any filter criteria for a [[CentLog#basic|Basic Search]]. Then click the arrow next to Advanced Search. The Search window expands to show the additional filters with which you can search for logs, specifically:
* '''Type de journal'''&mdash;<tt>Application</tt> ou <tt>Audit</tt>
+
* '''Log Type'''&mdash;<tt>Application</tt> or <tt>Audit</tt>
* '''Niveau Journal'''&mdash;<tt>[[CentLog#alarmLL|Alarme]]</tt>, <tt>[[CentLog#stdLL|Standard]]</tt>, <tt>[[CentLog#intnLL|Interaction]]</tt> ou <tt>[[CentLog#traceLL|Suivi]]</tt>
+
* '''Log Level'''&mdash;<tt>[[CentLog#alarmLL|Alarm]]</tt>, <tt>[[CentLog#stdLL|Standard]]</tt>, <tt>[[CentLog#intnLL|Interaction]]</tt>, or <tt>[[CentLog#traceLL|Trace]]</tt>
* Nom de la '''Solution''' dans laquelle le fichier journal a été généré.
+
* Name of '''Solution''' in which the log was generated.
* Type et nom des objets de configuration qui ont été modifiés.
+
* Type and name of configuration objects that have been changed.
* Nom de clé et valeur des attributs qui ont été modifiés.
+
* Key name and value of attributes that have been changed.
Pour supprimer la valeur d’un filtre, cliquez sur '''Réinitialiser''' ; pour effacer tous les filtres, cliquez sur '''Réinitialiser tous les filtres'''. Pour supprimer uniquement certaines paires clé/valeur saisies dans le filtre '''Attributs''', cliquez sur l’icône [[File:GAX852-CLtrash.png]] adjacente.
+
To clear a value from a filter, click '''Reset'''; to clear all filters click '''Reset All Filters'''. To remove only some of the Key:Value pairs entered in the '''Attributes''' filter, click the adjacent [[File:GAX852-CLtrash.png]].
  
Dans la liste des enregistrements de résultats renvoyés par la recherche avancée, vous pouvez afficher et trier les enregistrements de journal comme d’habitude. Cliquez sur [[File:GAX852-CLtrash.png]] pour supprimer les enregistrements sélectionnés de la base de données de journaux centrale. (Vous devez disposer du privilège DELETE_CLOGS pour supprimer des enregistrements).
+
In the list of records returned by the Advanced Search, you can view and sort the log records as usual. Click [[File:GAX852-CLtrash.png]] to delete selected records from the Centralized Log Database. (You must have the DELETE_CLOGS privilege to delete records.)
  
 
{{AnchorDiv|levels}}
 
{{AnchorDiv|levels}}
  
{{#anc:Log Levels}}
+
==Log Levels==
==Niveaux Journal==
+
Genesys Administrator reports log events at four levels of detail: [[CentLog#alarmLL|Alarm]], [[CentLog#stdLL|Standard]], [[CentLog#intnLL|Interaction]], and [[CentLog#traceLL|Trace]]. Log events of these levels feature the same unified log record format and can be stored in the Centralized Log Database.  
Genesys Administrator génère des événements de journal à quatre niveaux de détail : [[CentLog#alarmLL|Alarme]], [[CentLog#stdLL|Standard]], [[CentLog#intnLL|Interaction]] et [[CentLog#traceLL|Suivi]]. Les événements de journal de ces niveaux de journal utilisent le même format d’enregistrement de journal unifié et peuvent être stockés dans la base de données de journaux centrale.  
 
  
De plus, certaines applications génèrent également des journaux d’audit. Ces journaux d’audit contiennent généralement des attributs supplémentaires, ainsi que des informations sur les modifications de configuration et les actions de contrôle exécutées dans le cadre de processus, de solutions et d’alarmes.  
+
In addition, some applications also generate Audit logs. These Audit logs usually contain additional attributes and information about configuration changes and control actions performed for processes, solutions, and alarms.  
  
 
{{AnchorDiv|alarmLL}}
 
{{AnchorDiv|alarmLL}}
{{#anc:Alarm Level}}
+
===Alarm Level===
===Niveau Alarme===
+
Alarm-level logs contain only log records of the Alarm level. Solution Control Server (SCS) generates Alarm log events on behalf of other applications when receiving from them log events configured as Detection Events in Alarm Conditions. Using this level, SCS reports the occurrence and removal of all alarms to the Centralized Log Database.
Les journaux de niveau Alarme contiennent uniquement des enregistrements de journal de niveau Alarme. Solution Control Server (SCS) génère des événements de journal d’alarme pour le compte d'autres applications quand il reçoit de leur part des événements de journal configurés comme événements de détection dans des conditions d'alarme. C'est avec ce niveau que SCS signale l'apparition et l'élimination de toutes les alarmes à la base de données de journaux centrale.
 
  
 
{{AnchorDiv|stdLL}}
 
{{AnchorDiv|stdLL}}
{{#anc:Standard Level}}
+
===Standard Level===
===Niveau Standard===
+
Standard-level logs contains high-level events that report both major problems and normal operations of in-service solutions. An event is reported at the Standard level if it satisfies one of these criteria:
Les journaux de niveau Standard contiennent des événements de haut niveau qui signalent les problèmes importants et les opérations normales des solutions en service. Un événement est signalé au niveau Standard s'il répond à l'un des critères suivants :
 
  
<toggledisplay linkstyle font-size:larger showtext="[+] Afficher les critères" hidetext="[-] Masquer les critères">
+
<toggledisplay linkstyle font-size:larger showtext="[+] Show criteria" hidetext="[-] Hide criteria">
* Indique une tentative d'exécution de toute opération externe qui a échoué
+
* Indicates that an attempt to perform any external operation has failed
* Indique que la dernière tentative d'exécuter une opération externe ayant précédemment échoué a abouti
+
* Indicates that the latest attempt to perform an external operation that previously failed has succeeded
* Indique la détection d'une condition ayant une incidence négative sur les opérations, réelles ou projetées
+
* Indicates detection of a condition that has a negative impact on operations, actual or projected
* Indique qu'une condition précédemment détectée avec une incidence négative sur les opérations, n'existe plus
+
* Indicates that a previously detected condition, which had a negative impact on operations, no longer exists
* Indique une violation quelconque de la sécurité
+
* Indicates a security violation of any kind
* Indique un échange de données de haut niveau non reconnu ou qui ne suit pas la séquence logique attendue
+
* Indicates a high-level data exchange that cannot be recognized or does not follow the expected logical sequence
* Indique l'impossibilité de traiter une demande externe
+
* Indicates inability to process an external request
* Indique l'achèvement réussi d'une étape logique dans un processus d'initialisation
+
* Indicates successful completion of a logical step in an initialization process
* Indique la transition d'une application d'un mode de fonctionnement vers un autre
+
* Indicates a transition of an application from one operational mode to another
* Indique que la valeur d'un paramètre associée à un seuil configurable a dépassé ce seuil
+
* Indicates that the value of a parameter associated with a configurable threshold has exceeded that threshold
* Indique que la valeur d'un paramètre associée à un seuil configurable qui a précédemment dépassé ce seuil est revenue dans sa plage normale
+
* Indicates that the value of a parameter associated with a configurable threshold that earlier exceeded the threshold has returned to its normal range
 
</toggledisplay>
 
</toggledisplay>
  
 
{{AnchorDiv|intnLL}}
 
{{AnchorDiv|intnLL}}
{{#anc:Interaction Level}}
+
===Interaction Level===
===Niveau Interaction===
+
Interaction-level logs report the details of an interaction processed by solution components that handle interactions. The log contains information about the processing steps for each interaction by each solution component. An event is reported at the Interaction level if it:
Les journaux de niveau Interaction rendent compte en détail d'une interaction traitée par les composants de la solution qui gèrent ces interactions. Le journal contient des informations sur les étapes de traitement de chaque interaction des différents composants de la solution. Un événement est signalé au niveau Interaction s'il répond à l'un des critères suivants :
+
* Is a recognizable high-level data exchange with another application about an interaction.
* Il s'agit d'un échange de données de haut niveau reconnaissable avec une autre application relatif à une interaction.
+
* Indicates a change in real-time state of an interaction handled by the application (unless such a change is visible from the high-level data exchange).
* Il indique un changement de l'état en temps réel d’une interaction gérée par l'application (à moins que ce changement soit visible depuis l'échange de données de haut niveau).
+
The specific criteria depend on a particular component and its role in interaction processing.
Les critères précis dépendent du composant et de son rôle dans la procédure d'interaction.
 
  
 
{{AnchorDiv|traceLL}}
 
{{AnchorDiv|traceLL}}
{{#anc:Trace Level}}
+
===Trace Level===
===Niveau Suivi===
+
Trace-level logs report the details of communications between the various solution components. The log contains information about the processing steps for each interaction by each solution component. An event is reported at the Trace level if it satisfies one of these criteria:
Les journaux de niveau Suivi rendent compte en détail des communications entre les divers composants de la solution. Le journal contient des informations sur les étapes de traitement de chaque interaction des différents composants de la solution. Un événement est signalé au niveau Suivi s'il répond à l'un des critères suivants :
+
* It is a recognizable high-level data exchange with another application.
* Il s'agit d'un échange de données de haut niveau reconnaissable avec une autre application.
+
* It is a recognizable high-level data exchange with an external system.
* Il s'agit d'un échange de données de haut niveau reconnaissable avec un système externe.
+
* It indicates a change in real-time state of user-level objects that the application handles (unless such a change can be seen from the high-level data exchange).
* Il indique un changement de l'état en temps réel des objets de niveau utilisateur que gère l'application (à moins que ce changement ne puisse être vu de l'échange de données de haut niveau).
 
  
{{#anc:For More Information}}
+
==For More Information==
==Pour obtenir plus d’informations==
+
For more information about logging in Genesys software, refer to the ''{{Repository|85fr_us-ml.pdf|381f2360-a946-409c-9561-d3f37ce0790b|Framework 8.5 Management Layer User's Guide}}''. For descriptions of the logs themselves, refer to ''{{Repository|85fr_logevents-help.zip|c068fe1a-55a6-44e3-899d-8ee92365d64a|Framework Combined Log Events Help}}''.   
Pour plus d’informations sur la journalisation dans le logiciel Genesys, consultez le guide ''[http://docs.genesys.com/Special:Repository/85fr_us-ml.pdf?id=381f2360-a946-409c-9561-d3f37ce0790b Management Layer User's Guide]''. Pour obtenir une description spécifique des journaux, reportez-vous au guide ''[http://docs.genesys.com/Special:Repository/85fr_logevents-help.zip?id=c068fe1a-55a6-44e3-899d-8ee92365d64a Framework Combined Log Events Help]''.   
 
  
 
[[Category:V:GA:DRAFT]]
 
[[Category:V:GA:DRAFT]]

Version du mai 10, 2019 à 17:10

Centralized Logs

The Centralized Log Database contains log messages generated by Genesys applications. The Centralized Log plugin for Genesys Administrator Extension displays a summary of those logs, from which you can select and investigate any that are of special interest. As with all objects in GAX, you can only see those logs for which you have the required privileges.

Important
The Centralized Log Database supports only the Oracle, Microsoft, and PostgreSQL DBMS; IBM DB2 is not supported.

Log messages stored in the Centralized Log Database are of two types:

  • Application logs: Generated by most Genesys applications, these logs feature the same unified log record format.
  • Audit logs: Generated by only a few applications (notably Configuration Server and Solution Control Server), these logs contain additional attributes and information about configuration changes and control actions performed for processes, solutions, and alarms.

To view the Centralized Log, select Centralized Logs in the GAX menu bar.

Centralized Log Window

Log records are displayed in the Centralized Log window.

In the window, the menu on the left shows the views that are available for display, including any Saved Searches.

Important
Audit Logs are displayed only in the Audit view, and in the results of any searches where the Type criteria is set to Audit.

Above the list of logs, the following information and controls appear:

  • The number of logs that have been retrieved, and the total number of logs to be retrieved. To minimize any delays caused by retrieving all records from a Log Database that contains a huge number of records, records are retrieved in batches from the Database (default batch size is 100); more records are retrieved when you have scrolled halfway through the existing list. In addition, to increase performance, the number of records that can be displayed by GAX is limited (default number of records is 5000). If these parameters are not adequate for you, you can change them using the minlogs and maxlogs options (respectively). Refer to the "clog Section" of the Genesys Administrator Extension Deployment Guide.
  • Search criteria used to select the logs in the list. By default, only logs generated on the current day (Date Range: Today) are selected. See Filtering Logs for more information about selecting logs using filters.
  • Four control icons:
    • GAX852-CLsearch.png Opens the search window, in which you set filters to create the list of logs in which you are interested, or at least reduce the list down to a more manageable size.
    • GAX852-CLtrash.png Removes selected logs from the list. To select a log for deletion, select the check box in the first column. Select as many as required, or select the check box in the header row to select all of the displayed records.
      Avertissement
      If you select the check box in the header row, you will also be prompted to select all records in the database (not just the displayed records) that meet the same criteria as the displayed records. Choose this option ONLY if you are sure that you want to select for deletion all the records in your database that meet those criteria.
    • GAX852-CLcolumns.png Enables you to select what columns (attributes) are displayed in the list.
    • GAX852-CLrefresh.png Refreshes the display.
  • Quick filter box—Enter text in this box to search for specific logs without using the full filter capability. Those logs containing that text (including numbers, such as the log ID) will be returned and listed. This filter is case-insensitive, and is cumulative—the query is evaluated and performed, and the list of results is updated as you type each character. For best results, enter as many characters as you can.

Each log record is displayed with some or all of its attributes, as follows:

  • Level—The log level of the log, either Alarm, Standard, Interaction, or Trace.
  • ID—The unique identifier of the log, in the format <Application id>-<message ID>, where <Application ID> is the Application ID of the Application that generated the log, and <message ID> is the numeric identifier of the log message, unique within the component that generated the log.
  • Description—The text of the log message.
  • Host—The host on which the Application that generated the log was running.
  • App—The name of the Application that generated the log.
  • Date—The date and time when the log was generated.
  • Interaction ID—The identifier of the interaction for which this log was generated. This attribute appears only for Interaction-level logs.

You can also click GAX852-CLcolumns.png and customize what attributes (columns) are displayed; by default, all columns are displayed.

The actual attributes displayed depends on the selection made in the menu on the left of the window, and on the attributes that you have chosen to display. For example, the Level attribute is not displayed if you have selected to display only Standard-level logs.

Click in the line of any log to see additional attributes.

Viewing Logs

In the Centralized Log window, you can:

  • View all Application-type logs, by selecting All Logs under Applications in the left-hand menu.
  • View all logs of a certain level, by selecting the appropriate level under Applications. For example, to view all Standard-level Application logs, select Standard under Applications.
  • View all Audit-type logs, All Logs under Applications in the left-hand menu.
  • View all logs meeting criteria defined in a saved search, by selecting the search name under SAVED SEARCHES in the left-hand menu.
  • Create a new search for all logs meeting specified criteria, by filtering the logs based on specified criteria.

By default, GAX displays the logs sorted by their Date attribute. You can sort also them by their Level, ID, Description, Host, App, and Date (and time) when they were generated. Click in a header cell to sort the list by that attribute and/or to change the order of the list (ascending or descending).

Searching for Logs

You can search for specific logs by filtering a list of logs by one or more search criteria. Click GAX852-CLsearch.png to open the filter window. From this window you can perform a Basic Search or an Advanced Search:

  • Basic search—Enables you to view a subset of the logs using a basic set of criteria.
  • Advanced search—With specified privileges, enables you to filter the list using additional criteria, save the searches, manage the list of saved searches, and remove some or all of the logs.

Click Save As to save up to 10 defined searches, for use at a later time. If you want to save a new search but have already saved 10, you must delete one of the existing searches (click the x that appears when you hover the mouse on the search name) before saving the new one. You can also drag the search names up and down to reorder them in the list.

Conseil
  • Before starting your search, be sure that all log records have been retrieved from the database—check the record count in the top right corner of the Centralized Log window.
  • If all you want to do is search for log records containing some text, or even a log record with a unique ID, you can most likely get the same results as a Basic or Advanced Search by entering the text in the Filter Table box at the top-left of the window.

Basic Search

In a basic Search, you can filter logs based on Host, Application, Tenant, User, Date, and/or Description.

Note the following when performing a basic search:

  • You can enter only one filter value for each attribute.
  • The Host, Application, Tenant, and User filters contain drop-down lists of the values of the corresponding attribute for each log record in the original list.
  • The Date filter includes eight predefined filter values, as follows:
    • Last 5 Minutes
    • Last 15 Minutes
    • Last 1 Hour
    • Today
    • Yesterday—Current and previous days
    • Last 5 Days—Current and last 5 days
    • Last 30 Days—Current and last 30 days

    All days start at midnight (00:00:00); minute and hourly intervals are measured from the time when the filter is run.

    You can also select Custom Date Range and select a range of dates and times in the adjacent calendars that appear.
  • The Description filter has no drop-down list; enter any text that might be found in the Host name, Application name, or Description of the log. This is somewhat different from the Quick Filter box located above the record list, in that this field looks only for matching text in three attributes, so cannot be used to look for a log of a given number.

To filter the logs, select a value for one or more search criteria, and click Search. The logs that meet the specified criteria are listed.

Advanced Search

To use the Advanced Search filter, you must have the ACCESS_CLOGS privilege. This advanced filter gives you more search criteria, and if you have the DELETE_CLOGS privilege, you can also delete from the Centralized Log Database some or all of the log records returned by your query.

To define an Advanced filter, first enter any filter criteria for a Basic Search. Then click the arrow next to Advanced Search. The Search window expands to show the additional filters with which you can search for logs, specifically:

  • Log TypeApplication or Audit
  • Log LevelAlarm, Standard, Interaction, or Trace
  • Name of Solution in which the log was generated.
  • Type and name of configuration objects that have been changed.
  • Key name and value of attributes that have been changed.

To clear a value from a filter, click Reset; to clear all filters click Reset All Filters. To remove only some of the Key:Value pairs entered in the Attributes filter, click the adjacent GAX852-CLtrash.png.

In the list of records returned by the Advanced Search, you can view and sort the log records as usual. Click GAX852-CLtrash.png to delete selected records from the Centralized Log Database. (You must have the DELETE_CLOGS privilege to delete records.)

Log Levels

Genesys Administrator reports log events at four levels of detail: Alarm, Standard, Interaction, and Trace. Log events of these levels feature the same unified log record format and can be stored in the Centralized Log Database.

In addition, some applications also generate Audit logs. These Audit logs usually contain additional attributes and information about configuration changes and control actions performed for processes, solutions, and alarms.

Alarm Level

Alarm-level logs contain only log records of the Alarm level. Solution Control Server (SCS) generates Alarm log events on behalf of other applications when receiving from them log events configured as Detection Events in Alarm Conditions. Using this level, SCS reports the occurrence and removal of all alarms to the Centralized Log Database.

Standard Level

Standard-level logs contains high-level events that report both major problems and normal operations of in-service solutions. An event is reported at the Standard level if it satisfies one of these criteria:

[+] Show criteria

Interaction Level

Interaction-level logs report the details of an interaction processed by solution components that handle interactions. The log contains information about the processing steps for each interaction by each solution component. An event is reported at the Interaction level if it:

  • Is a recognizable high-level data exchange with another application about an interaction.
  • Indicates a change in real-time state of an interaction handled by the application (unless such a change is visible from the high-level data exchange).

The specific criteria depend on a particular component and its role in interaction processing.

Trace Level

Trace-level logs report the details of communications between the various solution components. The log contains information about the processing steps for each interaction by each solution component. An event is reported at the Trace level if it satisfies one of these criteria:

  • It is a recognizable high-level data exchange with another application.
  • It is a recognizable high-level data exchange with an external system.
  • It indicates a change in real-time state of user-level objects that the application handles (unless such a change can be seen from the high-level data exchange).

For More Information

For more information about logging in Genesys software, refer to the Framework 8.5 Management Layer User's Guide. For descriptions of the logs themselves, refer to Framework Combined Log Events Help.

Comments or questions about this documentation? Contact us for support!