relog
Estrae i contatori delle prestazioni da registri contatori delle prestazioni in altri formati, ad esempio testo-TSV (per il testo delimitato da tabulazione), CSV (da testo delimitato da virgole), BIN binario o SQL.
Nota
Per ulteriori informazioni sull'incorporazione di relog negli script di Strumentazione gestione Windows (WMI), vedere il blog sugli script.
Sintassi
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]
Parametri
| Parametro | Descrizione |
|---|---|
filename [filename ...] |
Specifica il percorso di un log dei contatori delle prestazioni esistente. È possibile specificare più file di input. |
| -a | Accoda output file anziché sovrascrivere. Questa opzione non è applicabile al formato SQL in cui il valore predefinito è sempre da accodare. |
-c path [path ...] |
Specifica il percorso del contatore delle prestazioni da registrare. Per specificare più percorsi dei contatori, separarli con uno spazio e racchiuderli tra virgolette (ad esempio, "path1 path2"). |
| nome file -cf | Specifica il percorso del file di testo in cui sono elencati i contatori delle prestazioni da includere in un file di relog. Utilizzare questa opzione per elencare i percorsi dei contatori in un file di input, uno per riga. Impostazione predefinita è che tutti i contatori nel file di registro originale vengano nuovamente registrati. |
-f {bin | csv | tsv | SQL} |
Specifica il percorso del formato di file di output. Il formato predefinito è bin. Per un database SQL, il file di output specifica l'oggetto DSN!CounterLog. È possibile specificare il percorso del database utilizzando la gestione di ODBC per configurare il DSN (Database System Name). |
| valore -t | Specifica gli intervalli di campionamento nei record n. Include ogni punto dati ennesima nel file di relog. Valore predefinito è ogni punto dati. |
-o {Outputfile | SQL:DSN!Counter_Log} |
Specifica il percorso del file di output o database SQL in cui verranno scritti i contatori. Nota: per le versioni a 64 bit e a 32 bit di relog.exe, è necessario definire un DSN nell'origine dati ODBC (rispettivamente a 64 bit e a 32 bit) nel sistema. Usare il driver ODBC "SQL Server" per definire un DSN. |
-b <M/D/YYYY> [[<HH>:]<MM>:]<SS>] |
Specifica l'ora iniziale per copiare il primo record dal file di input. La data e l'ora devono essere esattamente nel formato M/G/AAAAHH:MM:SS. |
-e <M/D/YYYY> [[<HH>:]<MM>:]<SS>] |
Specifica l'ora finale per copiare l'ultimo record dal file di input. La data e l'ora devono essere esattamente nel formato M/G/AAAAHH:MM:SS. |
-config {filename | i} |
Specifica il percorso del file di impostazioni che contiene i parametri della riga di comando. Se si utilizza un file di configurazione, è possibile utilizzare -i come segnaposto per un elenco di file di input che può essere inserito nella riga di comando. Se si usa la riga di comando, non usare -i. È anche possibile usare caratteri jolly, ad esempio *.blg per specificare più nomi di file di input contemporaneamente. |
| -q | Visualizza i contatori delle prestazioni e gli intervalli di tempo dei file di log specificati nel file di input. |
| -y | Ignora la richiesta rispondendo a "sì" a tutte le domande. |
| /? | Visualizza la guida al prompt dei comandi. |
Osservazioni:
Il formato generale per i percorsi dei contatori è il seguente:
[\<computer>] \<object>[<parent>\<instance#index>] \<counter>]dove i componenti padre, istanza, indice e contatore del formato possono contenere un nome valido o un carattere jolly. I componenti computer, padre, istanza e indice non sono necessari per tutti i contatori.Determinare i percorsi dei contatori da utilizzare in base al contatore stesso. Ad esempio, l'oggetto LogicalDisk dispone di un'istanza
<index>, pertanto è necessario specificare<#index>o un carattere jolly. Pertanto, è possibile utilizzare il seguente formato:\LogicalDisk(*/*#*)\\*.In confronto, l'oggetto Process non richiede un'istanza
<index>. Pertanto, è possibile utilizzare il seguente formato:\Process(*)\ID Process.Se viene specificato un carattere jolly nel nome Padre, verranno restituite tutte le istanze dell'oggetto specificato che corrispondono ai campi del contatore e istanza specificata.
Se viene specificato un carattere jolly nel nome dell'istanza, tutte le istanze dell'oggetto specificato e dell'oggetto genitore verranno restituite se tutti i nomi di istanza corrispondenti all'indice specificato corrispondono al carattere jolly.
Se viene specificato un carattere jolly nel nome del contatore, vengono restituiti tutti i contatori dell'oggetto specificato.
Le corrispondenze parziali della stringa di percorso del contatore (ad esempio, pro*) non sono supportate.
I file dei contatori sono file di testo in cui sono elencati uno o più dei contatori delle prestazioni nel registro esistente. Copiare il nome completo del contatore dal registro o /q output in formato
<computer>\<object>\<instance>\<counter>. Percorso di un contatore di elenco per ogni riga.Quando in esecuzione, il comando relog copia i contatori specificati da ogni record nel file di input, convertendo il formato se necessario. Percorsi con caratteri jolly sono consentiti nel file del contatore.
Utilizzare il parametro /t per specificare che i file di input vengono inseriti nei file di output a intervalli di ogni record
nth. Per impostazione predefinita, sono registrati di nuovo dati da ogni record.È possibile specificare che i log di output includano i record precedenti all'ora di inizio (ovvero, /b) per fornire dati per i contatori che richiedono valori di calcolo del valore formattato. Il file di output avrà gli ultimi record dai file di input con timestamp minore di /e (vale a dire, ora di fine) parametro.
Il contenuto del file di impostazione usato con l'opzione /config deve avere il formato seguente:
<commandoption>\<value>, dove<commandoption>è un'opzione della riga di comando e<value>ne specifica il valore.
Esempi ##Q#
Per ricampionare i log di traccia esistenti a intervalli fissi di 30, elencare i percorsi dei contatori, i file di output e i formati, digitare:
relog c:\perflogs\daily_trace_log.blg /cf counter_file.txt /o c:\perflogs\reduced_log.csv /t 30 /f csv
Per ricampionare i log di traccia esistenti a intervalli fissi di 30 ed elencare i percorsi dei contatori e il file di output, digitare:
relog c:\perflogs\daily_trace_log.blg /cf counter_file.txt /o c:\perflogs\reduced_log.blg /t 30
Per ricampionare i log di traccia esistenti in un database, digitare:
relog "c:\perflogs\daily_trace_log.blg" -f sql -o "SQL:sql2016x64odbc!counter_log"