Logman

Gère et planifie les collections des journaux de suivi d'événements et de compteur de performances sur les systèmes locaux et distants.

Verbes de la syntaxe

Logman [create {counter | trace} collection_name ] [start collection_name] [stop collection_name] [delete collection_name] [query {collection_name|providers}] [update collection_name]

Paramètres

create {counter | trace} collection_name

Crée des interrogations pour les collections de compteurs ou d'événements. Vous pouvez utiliser les options de la ligne de commande pour spécifier les paramètres.

start collection_name

Démarre l'interrogation pour la collection de données nom_collection. Utilisez cette option pour passer des collections planifiées aux collections manuelles. Utilisez le paramètre update de la ligne de commande avec heure de début (-b), heure de fin (-e) ou durée de répétition (-rt) pour replanifier les collections.

stop nom_collection

Arrête l'interrogation pour la collection de données nom_collection. Utilisez cette option pour passer des collections planifiées aux collections manuelles. Utilisez le paramètre update de la ligne de commande avec heure de début (-b), heure de fin (-e) ou durée de répétition (-rt) pour replanifier les collections.

delete nom_collection

Supprime l'interrogation pour la collection de données nom_collection. Si le nom_collection n'existe pas, une erreur est renvoyée.

query {nom_collection|providers}

Si aucun nom_collection ou fournisseur n'est donné, l'état de toutes les interrogations pour les collections existantes s'affiche. Utilisez nom_collection pour afficher les propriétés d'une collection donnée. Pour afficher les propriétés sur des ordinateurs distants, utilisez l'option -s ordinateur distant dans la ligne de commande. Utilisez fournisseurs comme mot clé à la place de nom_collection pour afficher les fournisseurs enregistrés qui sont installés sur votre système local. Pour répertorier les fournisseurs enregistrés qui sont installés sur le système distant, utilisez l'option -s dans la ligne de commande.

update collection_name

Met à jour les interrogations pour les collections de compteurs et d'événements. Dans le cas des collections pour les compteurs, les modifications apportées à l'interrogation s'arrêteront, puis les collections redémarreront. Dans le cas des collections pour le suivi d'événements, utilisez les paramètres suivants dans la ligne de commande pour effectuer une interrogation sans arrêter la collection : -p fournisseur [(indicateurs[,indicateurs ...])] Niveau, - max n, - o NomChemin, -ft mm:ss, ou -fd.

Options de syntaxe

[-s nom_ordinateur] [-config NomFichier] [-b M/j/aaaa h:mm:ss[AM | PM]] [-e M/j/aaaa h:mm:ss[AM | PM]] [-m [démarrer] [arrêter]] [-[-]r] [-o {Chemin | journal_compteurDNS!}] [-f {bin | bincirc | csv | tsv | SQL}] [-[-]a] [-[-]v [{nnnnn | mmjjhhmm}]] [-[-] rc [NomFichier]] [-[-] {valeur max}] [-[-]cnf [[[hh:]]mm:]ss] [-c {Chemin [chemin ...] | -cf NomFichier}] [-si [[hh:]mm:]ss] [-ln nom_journal] [-ets] [-[-] rt] [-p {GUID | fournisseur [(indicateurs [,indicateurs...]}] Niveau | -pf NomFichier}] [-[-] ul] [-bs valeur] [-ft [[hh:]mm:]ss] [-nb min max] [-fd nom journal] [-[-]u mot de passe utilisateur] [-rf [[hh:]mm:]ss] [-y] [-mode {mode_suivi [mode_suivi ...]}]

Paramètres

-s nom_ordinateur

Spécifie que les commandes créer, arrêter, supprimer ou mettre à jour seront exécutées sur le système distant. Par défaut, le système local est utilisé pour les commandes.

-config Nom_fichier

Spécifie le chemin d'accès du fichier de paramètres contenant les paramètres de la ligne de commande.

-b M/j/aaaa h:mm:ss[AM | PM]

Précise l’heure de début des collections (format 24 heures). Vous pouvez également spécifier l'heure de début des collections au format 12 heures en ajoutant AM ou PM dans la ligne de commande. Sauf spécification contraire, le jour et l'heure en cours sont utilisés par défaut. Utilisez l'option de démarrage manuel pour démarrer la collection immédiatement.

-e M/j/aaaa h:mm:ss[AM | PM]

Précise l’heure de fin des collections (format 24 heures). Vous pouvez également spécifier l'heure de fin des collections au format 12 heures en ajoutant AM ou PM dans la ligne de commande. Sauf spécification contraire, le jour et l'heure en cours sont utilisés par défaut. Utilisez l'arrêt manuel puis répétez l'option pour spécifier une heure d'arrêt avant l'heure actuelle, ou vous recevrez un message d'erreur.

-m start stop

Spécifie que les collections s'arrêtent et démarrent manuellement en utilisant les paramètres démarrer et arrêter dans la ligne de commande. Vous ne pouvez pas utiliser conjointement les paramètres -m démarrer et -b, ou -m arrêter et -e, ou -rf dans la ligne de commande pour la même interrogation.

-r

Répète la collection tous les jours aux périodes spécifiées par les options -b et -rf, ou les options -b et -e. Cette commande est valide uniquement pour les périodes de début et de fin spécifiées le même jour, le même mois et la même année.

--r

Désactive l'option de répétition.

-o {Chemin | Journal_compteurDSN!}

Spécifie le chemin d'accès au fichier de sortie qui rassemble les données de suivi d'événements et de compteur de performances, ou l'emplacement de la base de données et du groupe de données SQL. Pour spécifier SQL avec le format DSN!journal_compteur, utilisez l'option -f dans la ligne de commande. Par défaut, le nom du fichier journal est composé du nom de la requête de collection, suivi de l'extension .blg pour les compteurs de performances ou .etl pour les données de suivi.

-f {bin | bincirc | csv | tsv | SQL}

Spécifie le format de fichier utilisé pour recueillir les données de suivi et de compteur de performances. Vous pouvez utiliser des formats binaires, binaires circulaires, séparés par des virgules et des tabulations, ou des formats de base de données SQL pour les relevés de compteurs de performances. Vous devez utiliser l'option -o dans la ligne de commande avec l'option Journal_CompteurDNS!. Pour les formats de bases de données SQL, le DNS (Database System Name) doit être prédéfini et les autorisations doivent être accordées pour l'écriture dans la base de données. Le journal_compteur est créé dans la base de données et il est spécifié par le DSN. La valeur par défaut est binaire.

-a

Utilisez cette option si vous souhaitez ajouter le fichier.

--a

Désactive l'option de la commande d'ajout et retourne au mode de remplacement.

-v {nnnnn | mmjjhhmm}

Joint les informations de contrôle de version à la fin du fichier de sortie et du nom du chemin d'accès. Utilisez le format numérique nnnnn, ou le format de date mmjjhhmm (mois, jour, 24 heures, minute) pour le contrôle de version.

--v

Désactive l'option de version.

-rc NomFichier

Spécifie que cette commande doit être exécutée après la fermeture du fichier, durant la période de collecte ou à la fin de celle-ci. Utilisez l'option -rf avec -cnf pour fermer les fichiers durant les périodes de collecte. Si vous utilisez l'option -stop, cette commande n'est pas désactivée. Les commandes sont toujours exécutées au premier plan.

--rc

Désactive l'exécution de cette option de commande.

-max valeur

Indique la taille maximale en méga-octets du fichier journal obtenu. Si la taille du journal dépasse la taille maximale autorisée, la collecte s’arrête. Pour une base de données SQL, la taille maximale correspond au nombre d’enregistrements à écrire.

--max

Désactive l'option de taille limite maximale. Il s'agit de l'option par défaut.

-cnf [[hh:]mm:]ss

Crée un nouveau fichier lorsque les fichiers de sortie dépassent une taille maximale ou lorsque l'heure spécifiée est écoulée. Vous devez inclure l'option -v lorsque vous exécutez cette commande. Par défaut, un seul fichier journal est créé durant chaque collecte.

--cnf

Désactive l'option de création de nouveau fichier.

-c {Chemin [chemin ...] | -cf NomChemin}

Spécifie le chemin du compteur de performances vers le journal, ou spécifie le nom du chemin du fichier journal qui répertorie ces compteurs. Pour répertorier plusieurs chemins de compteurs, séparez la ligne de commande par un espace, ou utilisez l'option -cf pour répertorier les chemins de compteurs dans un fichier d'entrée, à raison d'une entrée par ligne.

Le format général des chemins de compteur est le suivant : [\\Ordinateur]\objet[parent/instance#index]\compteur] où :

Les composants parent, instance, index et compteur du format peuvent contenir un nom valide ou un caractère générique. Les composants ordinateur, parent, instance et index ne sont pas nécessaires pour tous les compteurs.

Vous déterminez les chemins d'accès des compteurs en fonction du compteur proprement dit. Par exemple, l'objet DisqueLogique a un index d'instance. Vous devez donc spécifier le #index ou un caractère générique. Par conséquent, vous pouvez utiliser le format suivant :

\DisqueLogique(*/*#*)\*

Par comparaison, l'objet Processus ne nécessite pas d'index d'instance. Par conséquent, vous pouvez utiliser le format suivant :

\Processus(*)\Processus ID

La liste ci-dessous présente les formats possibles :

• \\machine\objet(parent/instance#index)\compteur
• \\machine\objet(parent/instance)\compteur
• \\machine\objet(instance#index)\compteur
• \\machine\objet(instance)\compteur
• \\machine\objet\compteur
• \objet(parent/instance#index)\compteur
• \objet(parent/instance)\compteur
• \objet(instance#index)\compteur
• \objet(instance)\compteur
• \objet\compteur

Si un caractère générique est spécifié dans le nom du parent, toutes les instances de l'objet spécifié correspondant à l'instance spécifiée et aux champs du compteur sont renvoyées.

Si un caractère générique est spécifié dans le nom de l'instance, toutes les instances de l'objet et de l'objet parent spécifiés seront renvoyées si tous les noms d'instance correspondant à l'index spécifié correspondent au caractère générique.

Si un caractère générique est spécifié dans le nom de compteur, tous les compteurs de l'objet spécifié sont renvoyés.

Les chemins de compteur partiels (par exemple, pro*) ne sont pas pris en charge.

-si [[hh:]mm:]ss

Spécifie les intervalles d'échantillonnage des compteurs de performances en heures, minutes et secondes. La valeur par défaut est 15 secondes.

-ln nom_journal

Spécifie un nom défini par l'utilisateur pour la session du journal de suivi d'événements. Par défaut, le nom de collection est utilisé comme nom de journal.

-ets

Crée et démarre une session de suivi d'événements avec les options spécifiées sur la ligne de commande. Vous pouvez utiliser ce paramètre facultatif avec les paramètres create trace, update, query et delete.

-rt

Spécifie que la session de suivi d'événements s'exécute en mode temps réel, et n'est pas enregistrée dans un fichier. Par défaut, les données sont enregistrées dans un fichier.

--rt

Désactive l'option de journalisation en temps réel.

-p {GUID | fournisseur [(indicateurs[,indicateurs ...])] Niveau] | -pf {NomFichier}

Spécifie les fournisseurs (collecteurs de données de suivi) à utiliser pour effectuer un suivi de la collecte des données. Utilisez les fournisseurs des interrogations logman pour trouver le nomf (fournisseurs nommés) dans la liste des fournisseurs enregistrés. Utilisez l'option -pf pour répertorier plusieurs fournisseurs. L'option -pf identifie le fichier d'entrée contenant le nom des fournisseurs. Les noms des fournisseurs sont insérés entre des guillemets droits (""), ou dans le cas des GUID, entre des accolades, des masques d'indicateurs et des entiers (activer le niveau). Les indicateurs sont au format hexadécimal (OXFFFF) ou (indicateur, indicateur).

-ul

Spécifie que la session de suivi d'événements est exécutée en mode utilisateur. Si vous utilisez l'option -ul, seul un fournisseur peut être activé pour la session de suivi d'événements.

--ul

Spécifie que le mode utilisateur est désactivé, et la session de suivi d'événements est exécutée en mode kernel.

-bs valeur

Indique la taille de la zone tampon en n kilo-octets pour les collections de données de suivi.

-ft [[hh:]mm:]ss

Spécifie l'intervalle de l'horloge de vidage en minutes et en secondes pour les collections de données de suivi.

-nb min max

Spécifie le nombre minimal et le nombre maximal de tampons pour la collection des données de suivi. La valeur minimale par défaut correspond au nombre de processeurs sur le système, plus deux. La valeur maximale par défaut correspond à 25.

-fd nom_journal

Vide tous les tampons actifs d'une session de suivi d'événements existante sur un disque. Utilisez cette commande avec l'option -ln.

-u mot de passe utilisateur

Spécifie le mot de passe et le nom de compte que l'interrogation utilise sur les systèmes locaux ou distants. Pour démarrer la collecte des données des interrogations de données, enregistrez les journaux et les alertes de performance sur un système distant. Vous pouvez utilliser * comme mot de passe dans la ligne de commande pour générer une invite pour le mot de passe.

--u

Rétablit le nom de compte au compte de service des journaux et alertes de performance.

-rf [[hh:]mm:]ss

Spécifie que les collections sont exécutées pendant une durée définie.

-y

Annule les paramètres d'un nom de collection et applique les nouveaux paramètres sans interroger l'utilisateur final.

-mode {mode_suivi [mode_suivi ...]}

Spécifie les options avancées pour les sessions de suivi uniquement lorsque mode_suivi peut être globalsequence, localsequence ou pagedmemory. Globalsequence spécifie que le journal d'événements ajoute un numéro de séquence à chaque événement qu'il reçoit, quelle que soit la session de suivi qui a reçu l'événement. Localsequence spécifie que le journal d'événements ajoute un numéro de séquence pour les événements reçus lors d'une session de suivi donnée. Lorsque l'option localsequence est utilisée, des numéros de séquence en double peuvent exister entre toutes les sessions, mais les numéros de séquence sont uniques au sein de chaque session de suivi. Pagedmemory spécifie que le journal d'événements utilise une mémoire paginée et non la mémoire pool par défaut non paginée pour ses affectations de mémoires tampon internes.

/?

Affiche l'aide à l'invite de commandes.

Remarques

• Les options valides pour les verbes de la ligne de commande create update, start, stop, delete, et query sont :

  -s nom machine distante

  -[-]u Domaine/mot de passe utilisateur

• Les options valides pour les verbes create et update, et les options pour compteur et suivi sont :

  -y

  -b M/jaaaa h:mm:ss [AM|PM]

  -e M/j/aaaa h:mm:ss [AM|PM]

  -rf hh:mm:ss

  -m start stop

  -f bin|bincirc

  -[-]r

  -o PathName

  -[-]a

  -[-]v nnnnn|mmddhhmm

  -[-]rc command pathname

  -[-]max n

  -[-]cnf hh:mm:ss

• Common options for counters only are:

  -f bin|bincirc|csv|tsv|SQL

  -o PathName | DSN!counter_log

• Common options for create counter are:

  -c counterpath | -cf input file

  -si [[hh:]mm:]ss

  Ces options mettent à jour le compteur, et elles arrêteront et démarreront les collectes.

• Les options de la commande update pour la collection pour le suivi sont :

  - max n

  - o PathName

  -ft mm:ss

  -fd

  Ces options interrogeront les collections pour le suivi sans arrêter les collections.

• Valid options with counters only are:

  -f bin|bincirc|csv|tsv|SQL

  -o PathName | DSN!counter_log

• Valid options with create counter commands are:

  chemincompteur | -cf fichier entrée

  -si hh:mm:ss

• Les options valides pour les commandes create suivi sont :

  -ln nom journal

  -[-]rt

  -p Guid | fournisseur (indicateurs[,indicateurs ...]) niveau | -pf NomFichier

  -[-]ul

  -bs n

  -ft mm:ss

  -nb min max

  -fd nom journal

  -ets

• Utilisation de l'option -config

  Le contenu du fichier de paramètres utilisé avec l'option -config doit avoir le format suivant :

  [option_commande]

  valeur

  où option_commande est une option de ligne de commande et valeur spécifie sa valeur. Par exemple :

  [create]

  counter logx

  [-s]

  mysystem

  [-u]

  mypassword

• Utilisation de l'option -mode

  Utilisez cette option uniquement si vous êtes un utilisateur avancé.

• Gestion de l'analyseur de performances

  Vous pouvez utiliser Logman pour gérer les systèmes qui fonctionnent sous Windows 2000 ou Windows XP.

Exemples

Les formats de date dans les exemples suivants sont uniquement pour l'heure américaine locale.

Pour créer des interrogations quotidiennes pour les collections de compteurs avec des heures de début et de fin et répéter les collections, les numéros de contrôle de version, les chemins de compteurs et les intervalles d'échantillonnage, tapez :

Logman create counter daily_perf_log -b 7/27/2000 13:00:00 -e 7/27/2000 15:00:00 -r -v mmddhhmm -c "\Processor(_Total)\% Processor Time" "\Memory\Available bytes" -si 00:15 -o "c:\perflogs\daily_log"

Pour créer des interrogations quotidiennes pour les collections avec des heures de début et de fin et répéter les collections, les collections de fichiers de sortie, les numéros de contrôle de version, les chemins de compteurs et les intervalles d'échantillonnage, tapez :

Logman create counter daily_perf_log -b 7/27/2000 13:00:00 -e 7/27/2000 15:00:00 -r -o "c:\perflogs\daily_log" -v mmddhhmm -c "\Processor(_Total)\% Processor Time" "\Memory\Available bytes" -si 00:15

Pour créer des interrogations quotidiennes pour les collections en utilisant le fichier de configuration à la place du fichier de ligne de commande, tapez :

Logman -config file daily_perf.txt

Pour créer des interrogations quotidiennes pour le suivi avec des heures de début et de fin et répéter les collections, les numéros de contrôle de version, les noms des fournisseurs, les collections de fichiers d'entrée et de sortie, tapez :

Logman create trace daily_kernel_trace_log -b 7/27/2000 13:00:00 -e 7/27/2000 15:00:00 -r -v mmddhhmm -p "Windows Kernel Trace" 0xFFFFFFFF -rf 100 -o "c:\perflogs\daily_nt_trace"

Pour créer des interrogations quotidiennes pour le suivi avec des heures de début et de fin et répéter les collections, les numéros de contrôle de version, les noms de GUID et de journaux, les collections de fichiers d'entrée et de sortie, tapez :

Logman create trace daily_lsass_trace_log -b 7/27/2000 13:00:00 -e 7/27/2000 15:00:00 -r -v mmddhhmm -p "Local Security Authority(LSA) " 0x00000001 -rf 30:00 -o " c:\perflogs\daily_lsass_trace"

Pour créer des interrogations quotidiennes pour les compteurs avec des heures de début et de fin et répéter les collections, les numéros de contrôle de version, les chemins de compteurs, les intervalles d'échantillonnage et les formats SQL ainsi que les collections de fichiers de sortie, tapez :

Logman create counter daily_perf_log -b 7/27/2000 13:00:00 -e 7/27/2000 15:00:00 -r -v mmddhhmm -c "\Processor(_Total)\% Processor Time" "\Memory\Available bytes" -si 00:15 -f sql -o perfdb!daily_log

Pour démarrer les collections quotidiennes avec des intervalles d'échantillonnage, des mots de passe et noms de comptes, tapez :

Logman start daily_perf_log -s \\%computer_name% -u admin "adminpassword"

Pour démarrer les collections de données manuelles, tapez :

Logman start daily_perf_log

Pour arrêter les collections de données, tapez :

Logman stop daily_perf_log

Pour supprimer les collections de données, tapez :

Logman delete daily_perf_log

Pour afficher l'état des interrogations pour les collections, tapez les commandes suivantes :

Logman query

Logman query daily_perf_log