relog

  • Artículo

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2 y Windows Server 2012.

Extrae contadores de rendimiento de los registros de contadores de rendimiento en otros formatos, como texto-TSV (para texto delimitado por tabulaciones), texto-CSV (para texto delimitado por comas), binario-BIN o SQL.

Nota:

Para más información sobre cómo incorporar relog a sus scripts de Instrumental de administración de Windows (WMI), consulte el blog de scripting.

Sintaxis

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]

Parámetros

Parámetro Descripción
filename [filename ...] Especifica la ruta de un registro de contador de rendimiento existente. Puede especificar varios archivos de entrada.
-a Anexa el archivo de salida en lugar de sobrescribir. Esta opción no se aplica al formato SQL, en el que el valor predeterminado es siempre anexar.
-c path [path ...] Especifica la ruta de acceso del contador de rendimiento que se va a registrar. Para especificar varias rutas de acceso al contador, sepárelas con un espacio y coloque las rutas de acceso al contador entre comillas (por ejemplo, "path1 path2").
-cf filename Especifica la ruta del archivo de texto que enumera los contadores de rendimiento que se incluirán en un archivo relog. Use esta opción para enumerar las rutas de acceso de contador en un archivo de entrada, una por línea. La configuración predeterminada es que se vuelvan a registrar todos los contadores del archivo de registro original.
-f {bin | csv | tsv | SQL} Especifica la ruta del formato del archivo de salida. El formato predeterminado es bin. Para una base de datos SQL, el archivo de salida especifica el DSN!CounterLog. Puede especificar la ubicación de la base de datos usando el administrador de ODBC para configurar el DSN (nombre del sistema de base de datos).
-t value Especifica los intervalos de muestreo en n registros. Incluye cada enésimo punto de datos en el archivo relog. El valor predeterminado es cada punto de datos.
-o {Outputfile | SQL:DSN!Counter_Log} Especifica el nombre de ruta de acceso del archivo de salida o la base de datos SQL donde se escribirán los contadores.

Nota: Para las versiones de 64 y 32 bits de relog.exe, debe definir un DSN en el origen de datos ODBC (64 y 32 bits respectivamente) del sistema. Use el controlador de ODBC "SQL Server" para definir un DSN.
-b <M/D/YYYY> [[<HH>:]<MM>:]<SS>] Especifica la hora de inicio para copiar el primer registro del archivo de entrada. La fecha y hora deben tener este formato exacto M/D/AAAAHH:MM:SS.
-e <M/D/YYYY> [[<HH>:]<MM>:]<SS>] Especifica la hora de finalización para copiar el último registro del archivo de entrada. La fecha y hora deben tener este formato exacto M/D/AAAAHH:MM:SS.
-config {filename | i} Especifica el nombre de ruta de acceso del archivo de configuración que contiene parámetros de línea de comandos. Si usa un archivo de configuración, puede usar -i como marcador de posición para una lista de archivos de entrada que se pueden colocar en la línea de comandos. Si usa la línea de comandos, no use -i. También puede usar caracteres comodín, como *.blg, para especificar varios nombres de archivo de entrada a la vez.
-q Muestra los contadores de rendimiento y los intervalos de tiempo de los archivos de registro especificados en el archivo de entrada.
-y Omite las solicitudes respondiendo "sí" a todas las preguntas.
/? Muestra la ayuda en el símbolo del sistema.

Comentarios

  • El formato general de las rutas de acceso de contador es el siguiente: [\<computer>] \<object>[<parent>\<instance#index>] \<counter>] donde los componentes primarios, de instancia, de índice y contador del formato pueden contener un nombre válido o un carácter comodín. Los componentes de equipo, primario, instancia e índice no son necesarios para todos los contadores.

  • Usted determina las rutas de acceso al contador que debe usar en función del propio contador. Por ejemplo, el objeto LogicalDisk tiene una instancia de <index>, por lo que debe proporcionar el <#index> o un comodín. Por lo tanto, puede usar el siguiente formato: \LogicalDisk(*/*#*)\\*.

  • En comparación, el objeto Process no requiere una instancia de <index>. Por lo tanto, puede usar el siguiente formato: \Process(*)\ID Process.

  • Si se especifica un carácter comodín en el nombre de Parent, se devolverán todas las instancias del objeto especificado que coincidan con los campos de instancia y contador especificados.

  • Si se especifica un carácter comodín en el nombre de Instance, se devolverán todas las instancias del objeto especificado y del objeto primario si todos los nombres de instancia correspondientes al índice especificado coinciden con el carácter comodín.

  • Si se especifica un carácter comodín en el nombre de Counter, se devuelven todos los contadores del objeto especificado.

  • Las coincidencias parciales de cadenas de ruta de acceso al contador (por ejemplo, pro*) no son compatibles.

  • Los archivos de contador son archivos de texto que enumeran uno o varios de los contadores de rendimiento del registro existente. Copie el nombre del contador completo del registro o la salida /q en formato <computer>\<object>\<instance>\<counter>. Enumere una ruta de acceso al contador en cada línea.

  • Cuando se ejecuta, el comando relog copia los contadores especificados de cada registro del archivo de entrada, convirtiendo el formato si es necesario. Las rutas de acceso con caracteres comodín se permiten en el archivo de contador.

  • Use el parámetro /t para especificar que los archivos de entrada se insertan en archivos de salida a intervalos de cada nth registros. De manera predeterminada, se vuelven a registrar los datos de cada registro.

  • Puede especificar que sus registros de salida incluyan registros anteriores a la hora de inicio (es decir, /b) para proporcionar datos a los contadores que requieren valores de proceso del valor con formato. El archivo de salida tendrá los últimos registros de los archivos de entrada con marcas de tiempo inferiores al parámetro /e (es decir, la hora de finalización).

  • El contenido del archivo de configuración usado con la opción /config debe tener el siguiente formato: <commandoption>\<value>, donde <commandoption> es una opción de línea de comandos y <value> especifica su valor.

Ejemplos de ##Q#

Para volver a muestrear los registros de seguimiento existentes a intervalos fijos de 30, enumerar las rutas de acceso a los contadores, los archivos de salida y los formatos, escriba:

relog c:\perflogs\daily_trace_log.blg /cf counter_file.txt /o c:\perflogs\reduced_log.csv /t 30 /f csv

Para volver a muestrear los registros de seguimiento existentes a intervalos fijos de 30, enumerar las rutas de acceso a los contadores y el archivo de salida, escriba:

relog c:\perflogs\daily_trace_log.blg /cf counter_file.txt /o c:\perflogs\reduced_log.blg /t 30

Para volver a muestrear los registros de seguimiento existentes en una base de datos, escriba:

relog "c:\perflogs\daily_trace_log.blg" -f sql -o "SQL:sql2016x64odbc!counter_log"