A propos de l'utilitaire d'analyse des journaux
L'utilitaire d'analyse des journaux est un outil de ligne de commande qui vous aide à identifier rapidement la cause des problèmes signalés par les composants Oracle Enterprise Performance Management System en analysant les fichiers journaux appropriés. Cet utilitaire automatisant l'analyse des fichiers journaux, vous n'avez pas besoin de localiser et parcourir manuellement les fichiers journaux EPM System pour identifier les problèmes. Grâce à cet outil, les informations requises pour résoudre le problème ou le faire remonter au support Oracle sont rapidement disponibles. Exécuté sur le serveur où Oracle Hyperion Foundation Services est installé, cet utilitaire accède aux fichiers journaux de tous les serveurs identifiés dans le registre Oracle Hyperion Shared Services d'une instance EPM System et les analyse.
L'utilitaire d'analyse des journaux vous permet d'effectuer les opérations suivantes :
Répertorier les erreurs EPM System qui se sont produites au cours d'une période donnée. Les problèmes système sont liés aux services, aux erreurs de communication entre les composants et aux erreurs de communication de l'annuaire des utilisateurs.
Répertorier les problèmes fonctionnels qui sont survenus au cours d'une période donnée. Les problèmes fonctionnels sont liés aux fonctionnalités des composants EPM System ; il peut s'agir par exemple d'un échec au cours de l'exécution du calcul Oracle Essbase ou du processus de chargement de formulaires dans Oracle Hyperion Planning ou Oracle Hyperion Financial Management.
Tracer un ID de contexte d'exécution (ECID) dans les fichiers journaux afin de tracer des sessions utilisateur dans l'ensemble des composants EPM System. L'ECID est un identificateur unique permettant de corréler les événements qui font partie du même flux d'exécution de demandes. L'ECID est un ID unique standard Oracle.
Prérequis
Tout utilisateur ayant accès au répertoire EPM_ORACLE_INSTANCE/bin
, par exemple à C:/Oracle/Middleware/user_projects/epmsystem1/bin
sur un serveur Windows, peut exécuter l'utilitaire d'analyse des journaux.
Les utilisateurs exécutant l'utilitaire d'analyse des journaux doivent disposer de privilèges d'exécution sur les fichiers suivants :
Windows : EPM_ORACLE_INSTANCE/bin/loganalysis.bat
Les utilisateurs exécutant l'utilitaire d'analyse des journaux doivent disposer d'une autorisation en lecture sur les fichiers et répertoires contenus dans MIDDLEWARE_HOME/user_projects
sur tous les ordinateurs serveur hébergeant des composants EPM System. Ils doivent également disposer d'une autorisation en écriture sur le répertoire où l'utilitaire crée ses rapports.
Si l'emplacement des fichiers journaux ne se trouve pas dans MIDDLEWARE_HOME/user_projects
, les utilisateurs exécutant l'utilitaire doivent disposer d'une autorisation en lecture sur les fichiers journaux à leur emplacement personnalisé.
Emplacement des rapports de l'utilitaire d'analyse des journaux
L'utilitaire d'analyse des journaux crée un rapport HTML sur la base des options que vous spécifiez dans la commande et il l'enregistre dans le répertoire EPM_ORACLE_INSTANCE/diagnostics/reports
, par exemple dans C:/Oracle/Middleware/user_projects/epmsystem1/diagnostics/reports
sur un serveur Windows.
En général, l'utilitaire d'analyse des journaux nomme le rapport selon la convention suivante :
LogAnalysis_Report_YYYY_MM_DD_HR_MIN_SEC.html
L'utilitaire d'analyse des journaux propose une option de commande qui vous permet de spécifier un nom de rapport unique.
Remarque :
Si le contenu des rapports de l'utilitaire d'analyse des journaux est illisible, enlevez la directive -Dfile.encoding=UTF-8
de l'exécutable (EPM_ORACLE_INSTANCE/bin/loganalysis.bat
ou EPM_ORACLE_INSTANCE/bin/loganalysis.sh
), puis générez à nouveau le rapport.
Options de l'utilitaire d'analyse des journaux
Les options d'utilisation de l'utilitaire d'analyse des journaux sont les suivantes :
loganalysis [-all | -system | -functional | -m [ERROR | INCIDENT_ERROR WARNING | NOTIFICATION | TRACE]] [-t [<TIME FROM> <TIME TO>] -tday <days> -thour <hours> -tmin <minutes>] -ecid <ecid> -s <SEARCH STRING> -d <Offline log files directory> -f <file with message ids to filter from the report> -maxsize <max report size in MB>
Tableau 3-1 Paramètres de l'utilitaire d'analyse des journaux
Paramètre | Description |
---|---|
-h |
Affiche la page d'aide.
Exemple : |
-system |
Génère un rapport contenant les types de message de journal Exemple : |
-functional |
Génère un rapport détaillé contenant les messages de type WARNING , NOTIFICATION et TRACE . Généralement utilisé par les administrateurs fonctionnels d'EPM System.
Exemple : |
-ecid <ECID> |
Génère un rapport fournissant la trace d'une activité exécutée dans l'ensemble des composants EPM System. Nécessite un ECID en tant qu'argument. Ce rapport sert à tracer une erreur dans l'ensemble des composants EPM System. Généralement, cette option est utilisée après qu'une erreur a été identifiée par la génération d'un rapport avec l'option Remarque : Un ECID contenant un accent circonflexe (^) doit être mis entre guillemets. Exemple : |
-m <ERROR TYPE> |
Génère un rapport contenant les messages du type spécifié. Nécessite l'un des types de message suivants en tant qu'argument :
Exemple : |
-o <TITLE> |
Génère un rapport avec un titre personnalisé. Nécessite un titre de rapport entre guillemets en tant qu'argument.
Exemple : |
-s <STRING> |
Génère un rapport sur les messages de journal qui contiennent la chaîne spécifiée. Nécessite une chaîne d'erreur entre guillemets en tant qu'argument.
Exemple : |
-t <FROM DATE> T<FROM TIME><TO DATE> T<TO TIME> |
Génère un rapport sur les messages de journal qui ont été générés au cours de la période indiquée. Nécessite une date/heure de début et une date/heure de fin séparées par un espace en tant qu'argument.
Les dates/heures de début et de fin doivent être spécifiées au format Exemple : |
-tday <DAYS> |
Génère un rapport sur les messages de journal qui ont été générés au cours du nombre de jours indiqué. Nécessite une valeur numérique en tant qu'argument. Exemple : |
-thour <HOURS> |
Génère un rapport sur les messages de journal qui ont été générés au cours du nombre d'heures indiqué. Nécessite une valeur numérique en tant qu'argument. Exemple : |
-tmin <MINUTES> |
Génère un rapport sur les messages de journal qui ont été générés au cours du nombre de minutes indiqué. Nécessite une valeur numérique en tant qu'argument. Exemple : |
-d <DIRECTORY PATHS> |
Génère un rapport sur les fichiers journaux stockés dans les répertoires indiqués. Cette option sert à analyser les fichiers journaux qui ne sont pas stockés dans l'emplacement des fichiers journaux par défaut des composants EPM System. Vous pouvez spécifier plusieurs emplacements en les séparant par des virgules. Les chemins de répertoire doivent être mis entre guillemets.
Exemple : |
-f <arg> |
Non utilisé dans cette version ; réservé à une utilisation ultérieure. |
-maxsize <arg> |
Augmente la taille du rapport. La taille du rapport par défaut est de 5 Mo. Exemple : |
-all |
Génère un rapport répertoriant les messages de tous les fichiers journaux. La génération peut être longue et produire un fichier volumineux. Oracle recommande de ne pas utiliser cette option sans d'autres paramètres permettant de restreindre le contenu du rapport.
Exemple : |
Exécution de l'utilitaire d'analyse des journaux
L'utilitaire d'analyse des journaux est un utilitaire de ligne de commande.
Pour exécuter l'utilitaire d'analyse des journaux, procédez comme suit :
Lancez une invite de commande sur l'ordinateur serveur hébergeant Foundation Services.
Accédez au répertoire EPM_ORACLE_INSTANCE/bin
, généralement C:/Oracle/Middleware/user_projects/epmsystem1/bin
sur un serveur Windows.
Exécutez la commande ci-dessous. Spécifiez les options appropriées pour la génération du rapport. Reportez-vous à la section Tableau 3-1.
loganalysis.bat OPTIONS
(Windows)
Par exemple, sur un serveur Windows, pour créer un rapport intitulé "Database Issues_1-21-2013_11AM", contenant les messages liés à une erreur qui a entraîné la perte de la connectivité de base de données pour un composant EPM System aux environs de 11:00 le 21 novembre 2012, utilisez une commande telle que celle-ci :
loganalysis -system -t 2013-01-21T11:15:00 2013-01-21T11:20:00 -s "Failed to connect to DB" -o "Database Issues_1-21-2013_11 AM"
.
Déterminer l'ECID d'une activité utilisateur
L'ECID est un identificateur unique généré par le système qui corrèle l'activité d'un utilisateur dans plusieurs composants EPM System.
Pour déterminer l'ECID de l'activité d'un utilisateur, vous devez d'abord générer un rapport de l'utilitaire d'analyse des journaux. L'ECID, qui figure dans les détails des messages de journal, ressemble à ceci :
0000Jet8kA6ESOG_Ix5Eif1G^RAF000005
Pour localiser l'ECID d'une activité utilisateur, procédez comme suit :
Exécutez l'utilitaire d'analyse des journaux et générez un rapport répertoriant les erreurs système ou fonctionnelles. Reportez-vous à la section Exécution de l'utilitaire d'analyse des journaux.
A partir du répertoire EPM_ORACLE_INSTANCE/diagnostics/reports
(par exemple C:/Oracle/Middleware/user_projects/epmsystem1/diagnostics/reports
sur un serveur Windows), ouvrez le rapport que vous avez généré.