relog
S’applique à : Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012
Extrait les compteurs de performances des journaux du compteur de performances dans d’autres formats, tels que text-TSV (pour le texte délimité par des tabulations), text-CSV (pour le texte délimité par des virgules), binary-BIN ou SQL.
Notes
Pour plus d’informations sur l’incorporation d’une nouvelle journalisation dans vos scripts WMI (Windows Management Instrumentation), consultez le blog Scripts.
Syntaxe
relog [<filename> [<filename> ...]] [/a] [/c <path> [<path> ...]] [/cf <filename>] [/f {bin|csv|tsv|SQL}] [/t <value>] [/o {outputfile|DSN!CounterLog}] [/b <M/D/YYYY> [[<HH>:] <MM>:] <SS>] [/e <M/D/YYYY> [[<HH>:] <MM>:] <SS>] [/config {<filename>|i}] [/q]
Paramètres
| Paramètre | Description |
|---|---|
filename [filename ...] |
Spécifie le chemin d’accès d’un journal de compteur de performances existant. Vous pouvez spécifier plusieurs fichiers d’entrée. |
| -a | Ajoute le fichier de sortie au lieu de remplacer. Cette option ne s’applique pas au format SQL où la valeur par défaut est toujours à ajouter. |
-c path [path ...] |
Spécifie le chemin d’accès du compteur de performances à journaliser. Pour spécifier plusieurs chemins de compteur, séparez-les par un espace et placez les chemins de compteur entre guillemets (par exemple, "path1 path2"). |
| -cf filename | Spécifie le chemin d’accès du fichier texte qui répertorie les compteurs de performances à inclure dans un fichier de relog. Utilisez cette option pour répertorier les chemins de compteur dans un fichier d’entrée, un par ligne. Le paramètre par défaut est que tous les compteurs du fichier journal d’origine sont consignés. |
-f {bin | csv | tsv | SQL} |
Spécifie le chemin d’accès du format de fichier de sortie. Le format par défaut est bin. Pour une base de données SQL, le fichier de sortie spécifie le DSN!CounterLog. Vous pouvez spécifier l’emplacement de la base de données à l’aide du gestionnaire ODBC pour configurer le DSN (Nom du système de base de données). |
| -t value | Spécifie des exemples d’intervalles dans n enregistrements. Inclut chaque nième point de données dans le fichier de journal. La valeur par défaut est chaque point de données. |
-o {Outputfile | SQL:DSN!Counter_Log} |
Spécifie le chemin d’accès du fichier de sortie ou de la base de données SQL où les compteurs seront écrits. Note : Pour les versions 64 bits et 32 bits de relog.exe, vous devez définir un DSN dans la source de données ODBC (respectivement 64 bits et 32 bits) sur le système. Utilisez le pilote ODBC « SQL Server » pour définir un DSN. |
-b <M/D/YYYY> [[<HH>:]<MM>:]<SS>] |
Spécifie l’heure de début de la copie du premier enregistrement à partir du fichier d’entrée. La date et l’heure doivent être au format exact M/D/AAAA:MM:SS. |
-e <M/D/YYYY> [[<HH>:]<MM>:]<SS>] |
Spécifie l’heure de fin de la copie du dernier enregistrement à partir du fichier d’entrée. La date et l’heure doivent être au format exact M/D/AAAA:MM:SS. |
-config {filename | i} |
Spécifie le chemin d’accès du fichier de paramètres qui contient des paramètres de ligne de commande. Si vous utilisez un fichier de configuration, vous pouvez utiliser -i comme espace réservé pour une liste de fichiers d’entrée pouvant être placés sur la ligne de commande. Si vous utilisez la ligne de commande, n’utilisez pas -i. Vous pouvez également utiliser des caractères génériques, par exemple *.blg pour spécifier plusieurs noms de fichiers d’entrée à la fois. |
| -q | Affiche les compteurs de performances et les intervalles de temps des fichiers journaux spécifiés dans le fichier d’entrée. |
| -y | Contourne l’invite en répondant « oui » à toutes les questions. |
| /? | Affiche l'aide à l'invite de commandes. |
Notes
Le format général des chemins de compteur est le suivant :
[\<computer>] \<object>[<parent>\<instance#index>] \<counter>]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 de compteur à utiliser en fonction du compteur lui-même. Par exemple, l’objet LogicalDisk a une instance
<index>, vous devez donc fournir le<#index>ou un caractère générique. Par conséquent, vous pouvez utiliser le format suivant :\LogicalDisk(*/*#*)\\*.En comparaison, l’objet Process ne nécessite pas d’instance
<index>. Par conséquent, vous pouvez utiliser le format suivant :\Process(*)\ID Process.Si un caractère générique est spécifié dans le nom parent, toutes les instances de l’objet spécifié qui correspondent aux champs d’instance et de compteur spécifiés seront retourné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 sont retourné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 du compteur, tous les compteurs de l’objet spécifié sont retournés.
Les correspondances de chaîne de chemin de compteur partiel (par exemple, pro*) ne sont pas prises en charge.
Les fichiers de compteur sont des fichiers texte qui répertorient un ou plusieurs compteurs de performances dans le journal existant. Copiez le nom complet du compteur à partir du journal ou de la sortie /q au format
<computer>\<object>\<instance>\<counter>. Répertoriez un chemin de compteur sur chaque ligne.Lors de l’exécution, la commande de relog copie les compteurs spécifiés à partir de chaque enregistrement dans le fichier d’entrée, en convertissant le format si nécessaire. Les chemins d’accès génériques sont autorisés dans le fichier de compteur.
Utilisez le paramètre /t pour spécifier que les fichiers d’entrée sont insérés dans les fichiers de sortie à intervalles de chaque
nthenregistrement. Par défaut, les données sont consignées à partir de chaque enregistrement.Vous pouvez spécifier que vos journaux de sortie incluent des enregistrements d’avant l’heure de début (c’est-à-dire /b) afin de fournir des données pour les compteurs qui nécessitent des valeurs de calcul de la valeur mise en forme. Le fichier de sortie aura les derniers enregistrements des fichiers d’entrée avec des horodatages inférieurs au paramètre /e (autrement dit, heure de fin).
Le contenu du fichier de paramètres utilisé avec l’option /config doit avoir le format suivant :
<commandoption>\<value>, où<commandoption>est une option de ligne de commande et<value>spécifie sa valeur.
##Q# Exemples
Pour rééchantillonner les journaux de suivi existants à des intervalles fixes de 30, répertoriez les chemins d’accès des compteurs, les fichiers de sortie et les formats, tapez :
relog c:\perflogs\daily_trace_log.blg /cf counter_file.txt /o c:\perflogs\reduced_log.csv /t 30 /f csv
Pour rééchantillonner les journaux de suivi existants à des intervalles fixes de 30, répertoriez les chemins d’accès des compteurs et les fichiers de sortie et tapez :
relog c:\perflogs\daily_trace_log.blg /cf counter_file.txt /o c:\perflogs\reduced_log.blg /t 30
Pour rééchantillonner les journaux de trace existants dans une base de données, tapez :
relog "c:\perflogs\daily_trace_log.blg" -f sql -o "SQL:sql2016x64odbc!counter_log"