Introduction #
Open iT prend en charge les rapports d'utilisation de l'ALM en collectant les fichiers journaux et en les convertissant au format Open iT.
Un client Open iT est installé sur votre serveur de licences, et le serveur de licences ne crée pas de journaux d'historique d'utilisation des licences pour cette collecte. Le collecteur de données demande au collecteur de données brutes de solliciter les journaux d'utilisation des licences auprès du gestionnaire de licences toutes les 5 minutes, ce qui déclenche le processus de collecte des données. Une fois les journaux reçus, le collecteur de données brutes les transmet au collecteur de données. Les données collectées sont ensuite envoyées à un préprocesseur de données pour être traitées. Après le prétraitement, les données finales prétraitées sont envoyées et stockées dans le serveur central.
Flux de travail pour l'analyse des fichiers journaux avec Raw Collector
Cela produira les types de données agrégées suivants, utilisés pour les rapports historiques:
Enregistrer les données du journal :
- (89) Total de l'utilisation de la licence Événements de la licence
- (90) Licence individuelle Utilisation de la licence Événements de licence
- (91) Usergroup License Use Licenseevents
- (108) Licence d'accueil Utilisation de la licence Manifestations
- (109) Groupe d'accueil Utilisation de la licence Événements de licence
Données du journal des événements :
- (104) Événements du fichier journal de la licence v2.0
- (107) Refus de licence Utilisation de la licence Événements de licence
Les sections suivantes vous guideront dans la mise en place de la configuration nécessaire pour collecter et envoyer les données requises au serveur.
Appliquez les configurations indiquées dans le client Open iT.
Exigences #
- Un Open iT Client connecté à un Open iT Server ou à une installation Open iT coexistante
- Droits d'administration du serveur de licences
- Chemin complet vers le fichier journal de débogage
Activation de la collecte des données du journal #
Voici les étapes nécessaires pour activer la collecte des données du journal ALM.
- Ouvrez une invite de commande avec les privilèges d'un administrateur.
- Allez dans le répertoire bin, qui se trouve par défaut dans C:\NProgram Files\NOpeniT\NCorebin, exécutez la commande :
Syntaxe de la commande
cd $BIN_DIR
Exemple
cd C:\NProgram Files\NOpeniT\NCorebin
- Une fois dans le répertoire, activez la collecte des données du journal ALM, exécutez la commande :
Syntaxe de la commande
openit_oconfinit -u "collect_license_alm-logs.root.scheduler.jobs.collect_alm_raw_licenselogs.general.active=true"
- Définissez le chemin d'accès à la base de données produite par ALM, exécutez la commande :
Syntaxe de la commande
openit_oconfinit -u “collect_license_alm-logs.root.scheduler.jobs.collect_alm_raw_licenselogs.operations.arguments=automationlm –databasefile \”<database_file>\” –outputfile \”${OpeniT.directories.temp}/SqlCeUtil/ALM/automationlm.csv\” –logdir \”${OpeniT.directories.log}\””
where <database_file> is the path to the database produced by ALM. This is usually in C:\ProgramData\Siemens\Automation\Automation License Manager\logging.
Exemple
openit_oconfinit -u “collect_license_alm-logs.root.scheduler.jobs.collect_alm_raw_licenselogs.operations.arguments=automationlm –databasefile \”C:\ProgramData\Siemens\Automation\Automation License Manager\logging\almdb.sdf\” –outputfile \”${OpeniT.directories.temp}/SqlCeUtil/ALM/automationlm.csv\” –logdir \”${OpeniT.directories.log}\””
Configuration avancée #
| Nom de l'attribut | Valeur acceptée | Description |
| max-instances | Uint (par exemple, 5, 8, 9) | Le nombre d'instances autorisées à fonctionner en même temps. |
| Manutention maximale | Chaîne (end-oldest, end-all-old, ou end-new) | Action effectuée lorsque le nombre maximal d'instances est atteint : end-oldest - Spécifiez cette option pour arrêter/tuer l'instance la plus ancienne et en démarrer une nouvelle. end-all-old - Spécifiez cette option pour arrêter/tuer toutes les instances en cours avant de démarrer la nouvelle. end-new - Spécifiez cette option pour empêcher le démarrage d'une nouvelle instance. |
| délai de fin | Durée (par exemple, P30S, P5M, P1H) | Le temps d'attente maximum avant de mettre fin à une instance en cours d'exécution. |
| quarantaine | Durée (par exemple, P30S, P5M, P1H) | Le temps d'attente avant de démarrer une nouvelle instance après une précédente. |
Configuration de la collecte des fichiers journaux #
Le fichier de configuration du fichier journal ALM, logfilecollector-alm.xml, se trouve dans le répertoire Components, qui se trouve par défaut dans C:\NProgram Files\NOpeniT\NCore\NConfiguration\NComponents. Vous n'avez pas besoin de le mettre à jour, mais si vous souhaitez en savoir plus sur son comportement, reportez-vous au tableau de configuration de l'analyseur de logs ALM.
| Nom de l'objet | Valeur acceptée | Description |
| source.dir | Nom du répertoire (par exemple, ${OpeniT.directories.temp}/SqlCeUtil/ALM/) | Emplacement des fichiers journaux de l'ALM. |
| source.pattern | Chaîne (c'est-à-dire *.csv) | Le motif global identifiant les fichiers source dans le répertoire source. |
| source.vu | Chaîne (collecter, ignorer, ou queue) | Les fichiers vus sont les fichiers sources collectés précédemment. collect - Spécifier cette option pour collecter à partir du début à chaque fois. ignore - Spécifier cette option pour ne pas collecter à nouveau à partir du même fichier. tail - Spécifier cette option pour continuer la collecte à partir de la fin du fichier la dernière fois (c'est-à-dire collecter les fichiers ajoutés depuis la dernière fois). |
| source.cmplines | Entier (par exemple, 6, 10, 20) | Ceci est nécessaire si la valeur de source.seen est tail. Il s'agit du nombre de lignes comparé aux fichiers source collectés précédemment pour déterminer où commencer la collecte. Remarque : si ce nombre est trop faible, vous risquez d'obtenir une position incorrecte et des données en double peuvent se trouver dans les fichiers journaux. En général, il est préférable d'avoir quelques lignes de plus que le strict nécessaire plutôt qu'une seule ligne de trop. |
| target.dir | Nom du répertoire (par exemple, ${OpeniT.directories.temp}/LogFileCollector) | Il s'agit de l'emplacement du répertoire contenant les données logs collectées. |
| target.module | Chaîne (c.-à-d. licence) | Le type de module cible (en général). |
| target.datatype | Chaîne (c'est-à-dire alm) | Le type spécifique de données cibles. |
| cible.intervalle | Durée (par exemple, P30S, P5M, P1D) | Le laps de temps qui s'écoule entre les passages du collecteur. |
| target.rotation-size | Entier (par exemple, 6, 10, 20) | Le fichier journal tourne s'il dépasse le nombre (en mb) défini. |
| cible.rotation-glob | Chaîne (par exemple, *) | Le motif global qui doit être pris en compte avant la rotation du fichier journal. |
Configuration de l'analyseur de logs ALM
Désactivation de la collecte des données du journal d'enregistrement #
L'activation de la collecte des données du journal permet d'agréger automatiquement les données du journal des enregistrements et du journal des événements. Si vous souhaitez collecter uniquement les données du journal des événements, procédez comme suit.
- Ouvrez une invite de commande avec les privilèges d'un administrateur.
- Allez dans le répertoire bin, qui se trouve par défaut dans C:\NProgram Files\NOpeniT\NCorebin, exécutez la commande :
Syntaxe de la commande
cd $BIN_DIR
Exemple
cd C:\NProgram Files\NOpeniT\NCorebin
- Une fois dans le répertoire, désactivez la collecte des données d'enregistrement, exécutez la commande :
Syntaxe de la commande
openit_oconfinit -u "collect_license_alm-logs.root.scheduler.jobs.preprocess_alm_licenselogs-records.general.active=false"
- Pour modifier le traitement des journaux d'événements, exécutez la commande suivante :
Syntaxe de la commande
openit_oconfinit -u "collect_license_alm-logs.root.scheduler.jobs.preprocess_alm_licenselogs-events.operations.arguments=-srcdir \"${OpeniT.directories.temp}/LogFileCollector\" -srcpattern raw-alm-license-LogFileCollector*.data -srcfilehandling rename -trgdir \"${OpeniT.directories.temp}/LogParserALM\" -module license -datatype event -resolution PT1H -matchobjects \"${OpeniT.directories.conf}/matchobjects-event-alm.oconf\" -type event -disable-statlogging"
- Pour modifier le calendrier de transfert des données, exécutez la commande :
Syntaxe de la commande
openit_oconfinit -u "collect_license_alm-logs.root.scheduler.jobs.transfer_alm_licenselogs.scheduling.start-triggers.trigger#1.job-name=preprocess_alm_licenselogs-events"
Vérification de la collecte des données du journal #
Après l'activation, vous pouvez vérifier que les données sont collectées et envoyées au serveur en suivant les étapes suivantes :
- Ouvrez une invite de commande avec les privilèges d'un administrateur.
- Allez dans le répertoire bin, qui se trouve par défaut dans C:\NProgram Files\NOpeniT\NCorebin, et exécutez la commande :
Syntaxe de la commande
cd $BIN_DIR
Exemple
cd C:\NProgram Files\NOpeniT\NCorebin
- Exécutez la commande :
Syntaxe de la commande
openit_executor -r collect_license_alm-logs
- Vérifier que des fichiers archiver*.in ont été créés sur le serveur dans le répertoire archiver, qui se trouve par défaut dans C:\ProgramData\OpeniT\Data\incoming\archiver.
