relog
Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2 e Windows Server 2012
Extrai contadores de desempenho de logs do contador de desempenho em outros formatos, como text-TSV (para texto delimitado por tabulação), text-CSV (para texto delimitado por vírgula), binário-BIN ou SQL.
Observação
Para obter mais informações sobre como incorporar relog em seus scripts WMI (Instrumentação de Gerenciamento do Windows), consulte o Blog Script.
Sintaxe
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 | Descrição |
|---|---|
filename [filename ...] |
Especifica o nome do caminho de um log de contador de desempenho existente. Podem ser especificados vários arquivos de entrada. |
| -a | Acrescenta o arquivo de saída em vez de substituir. Essa opção não se aplica ao formato SQL em que o padrão é sempre acrescentar. |
-c path [path ...] |
Especifica o caminho do contador de desempenho a ser registrado. Para especificar vários caminhos de contador, separe-os com um espaço e coloque os caminhos do contador entre aspas (por exemplo, "path1 path2"). |
| -cf filename | Especifica o nome do caminho do arquivo de texto que lista os contadores de desempenho a serem incluídos em um arquivo relog. Use essa opção para listar caminhos de contador em um arquivo de entrada, um por linha. A configuração padrão é que todos os contadores no arquivo de log original são registrados novamente. |
-f {bin | csv | tsv | SQL} |
Especifica o nome do caminho do formato de arquivo de saída. O formato padrão é bin. Para um banco de dados SQL, o arquivo de saída especifica o DSN!CounterLog. Você pode especificar o local do banco de dados usando o gerenciador ODBC para configurar o DSN (Nome do Sistema de Banco de Dados). |
| -t value | Especifica intervalos de exemplo em n registros. Inclui cada enésimo ponto de dados no arquivo relog. O padrão é cada ponto de dados. |
-o {Outputfile | SQL:DSN!Counter_Log} |
Especifica o nome do caminho do arquivo de saída ou do banco de dados SQL onde os contadores serão gravados. Observação: para as versões de 64 bits e 32 bits do relog.exe, você deve definir um DSN na Fonte de Dados ODBC (64 bits e 32 bits, respectivamente) no sistema. Use o driver ODBC do "SQL Server" para definir um DSN. |
-b <M/D/YYYY> [[<HH>:]<MM>:]<SS>] |
Especifica a hora de início para copiar o primeiro registro do arquivo de entrada. A data e a hora devem estar nesse formato exato M/D/AAAAH:MM:SS. |
-e <M/D/YYYY> [[<HH>:]<MM>:]<SS>] |
Especifica a hora de término para copiar o último registro do arquivo de entrada. A data e a hora devem estar nesse formato exato M/D/AAAAH:MM:SS. |
-config {filename | i} |
Especifica o nome do caminho do arquivo das configurações que contém parâmetros de linha de comando. Se você estiver usando um arquivo de configuração, use -i como um espaço reservado para uma lista de arquivos de entrada que podem ser colocados na linha de comando. Se você estiver usando a linha de comando, não use -i. Você também pode usar curingas, como *.blg para especificar vários nomes de arquivo de entrada ao mesmo tempo. |
| -Q | Exibe os contadores de desempenho e intervalos de tempo dos arquivos de log especificados no arquivo de entrada. |
| -y | Ignora a solicitação respondendo "sim" a todas as perguntas. |
| /? | Exibe a ajuda no prompt de comando. |
Comentários
O formato geral para caminhos de contador é o seguinte:
[\<computer>] \<object>[<parent>\<instance#index>] \<counter>]onde os componentes pai, instância, índice e contador do formato podem conter um nome válido ou um caractere curinga. Os componentes de computador, pai, instância e índice não são necessários para todos os contadores.Você determina os caminhos do contador a serem usados com base no próprio contador. Por exemplo, o objeto LogicalDisk tem uma instância
<index>, portanto, você deve fornecer o<#index>ou um caractere curinga. Portanto, você pode usar o seguinte formato:\LogicalDisk(*/*#*)\\*.Em comparação, o objeto Process não requer uma instância
<index>. Portanto, você pode usar o seguinte formato:\Process(*)\ID Process.Se um caractere curinga for especificado no nome Pai, todas as instâncias do objeto especificado que correspondem aos campos de instância e contador especificados serão retornadas.
Se um caractere curinga for especificado no nome Instância, todas as instâncias do objeto especificado e do objeto pai serão retornadas se todos os nomes de instância correspondentes ao índice especificado corresponderem ao caractere curinga.
Se um caractere curinga for especificado no nome Contador, todos os contadores do objeto especificado serão retornados.
Não há suporte para correspondências parciais de cadeia de caracteres de caminho do contador (por exemplo, pro*).
Arquivos de contador são arquivos de texto que listam um ou mais contadores de desempenho no log existente. Copie o nome completo do contador do log ou da saída /q no formato
<computer>\<object>\<instance>\<counter>. Liste um caminho de contador em cada linha.Quando executado, o comando relog copia os contadores especificados de cada registro no arquivo de entrada, convertendo o formato, se necessário. Caminhos curinga são permitidos no arquivo de contador.
Use o parâmetro /t para especificar que os arquivos de entrada foram inseridos em arquivos de saída em intervalos de cada registro
nth. Por padrão, os dados são colocados novamente no log de cada registro.Você pode especificar que os logs de saída incluam registros de antes da hora de início (ou seja, /b) para fornecer dados para contadores que exigem valores de computação do valor formatado. O arquivo de saída terá os últimos registros de arquivos de entrada com carimbos de data/hora menores que o parâmetro /e (ou seja, hora de término).
O conteúdo do arquivo de configuração usado com a opção /config deve ter o seguinte formato:
<commandoption>\<value>, em que<commandoption>é uma opção de linha de comando e<value>especifica seu valor.
Exemplos ##Q#
Para criar uma nova amostra dos logs de rastreamento existentes em intervalos fixos de 30, listar os caminhos do contador, arquivos de saída e formatos, digite:
relog c:\perflogs\daily_trace_log.blg /cf counter_file.txt /o c:\perflogs\reduced_log.csv /t 30 /f csv
Para criar uma nova amostra dos logs de rastreamento existentes em intervalos fixos de 30, listar os caminhos do contador e arquivos de saída, digite:
relog c:\perflogs\daily_trace_log.blg /cf counter_file.txt /o c:\perflogs\reduced_log.blg /t 30
Para criar uma nova amostra dos logs de rastreamento existentes em um banco de dados, digite:
relog "c:\perflogs\daily_trace_log.blg" -f sql -o "SQL:sql2016x64odbc!counter_log"