Import-Counter

Artigo
07/28/2010

Aplica-se a: Windows PowerShell 2.0

Importa arquivos de log de contador de desempenho (.blg, .csv, .tsv) e cria os objetos que representam cada exemplo de contador no log.

Sintaxe

Import-Counter [-Path] <string[]> [-Counter <string[]>] [-EndTime <DateTime>] [-MaxSamples <Int64>] [-StartTime <DateTime>] [<CommonParameters>]

Import-Counter [-Path] <string[]> -ListSet <string[]> [<CommonParameters>]

Import-Counter [-Path] <string[]> -Summary <switch> [<CommonParameters>]

Descrição

O cmdlet Import-Counter importa dados de contador de desempenho de arquivos de log de contadores de desempenho e cria objetos para cada exemplo do contador no arquivo. Os objetos PerformanceCounterSampleSet que ele cria são idênticos aos objetos que Get-Counter retorna quando coleta dados de contador de desempenho.

Você pode importar dados de arquivos de log de desempenho separados por vírgulas (.csv), separados por tabulação (.tsv) e de log de desempenho binário (.blg). Se você estiver usando arquivos .blg, poderá importar vários arquivos (até 32 arquivos diferentes) em cada comando. E pode usar os parâmetros de Import-Counter para filtrar os dados importados.

Junto com Get-Counter e Export-Counter, esse recurso permite coletar, exportar, importar, combinar, filtrar, manipular e reexportar dados de contador de desempenho no Windows PowerShell.

Parâmetros

-Counter <string[]>

Importa dados apenas para os contadores de desempenho especificados. Por padrão, Import-Counter importa todos os dados de todos os contadores nos arquivos de entrada. Insira um ou mais caminhos de contador. Curingas são permitidos na parte Instance do caminho.

Cada caminho de contador tem o seguinte formato: Observe que o valor ComputerName é obrigatório no caminho, até mesmo no computador local.

"\\<ComputerName>\<CounterSet>(<Instance>)\<CounterName>"

Por exemplo:

"\\Server01\Processador(2)\% tempo de usuário"

"\Processador(*)\% tempo de processador

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	true

-EndTime <DateTime>

Importa apenas dados de contador com um carimbo de data/hora menor ou igual à data e à hora especificadas. Insira um objeto DateTime, como aquele retornado pelo cmdlet Get-Date. Por padrão, Import-Counter importa todos os dados de contador nos arquivos especificados pelo parâmetro Path.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-ListSet <string[]>

Obtém os conjuntos de contadores de desempenho representados nos arquivos exportados. Os comandos com esse parâmetro não importam nenhum dado.

Insira um ou mais nomes de conjuntos de contadores. Os caracteres curinga são permitidos. Para obter todos os conjuntos de contadores no arquivo, digite "import-counter - listset *".

Necessário?	true
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	true

-MaxSamples <Int64>

Especifica o número máximo de exemplos de cada contador para importação. Por padrão, Get-Counter importa todos os dados nos arquivos especificados pelo parâmetro Path.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Path <string[]>

Especifica os caminhos dos arquivos que serão importados. Esse parâmetro é obrigatório.

Insira o caminho e o nome de um arquivo .csv, .tsv ou .blg que você exportou usando o cmdlet Export-Counter. É possível especificar somente um arquivo .csv ou .tsv, mas pode-se especificar vários arquivos .blg (até 32) em cada comando. Você também pode enviar por pipe cadeias de caracteres de caminho de arquivo (entre aspas) para Import-Counter.

Necessário?	true
Posição?	2
Valor padrão
Aceitar entrada do pipeline?	true (ByValue)
Aceitar caracteres curinga?	true

-StartTime <DateTime>

Importa apenas dados do contador com um carimbo de data/hora maior ou igual à data e à hora especificadas. Insira um objeto DateTime, como aquele retornado pelo cmdlet Get-Date. Por padrão, Import-Counter importa todos os dados de contador nos arquivos especificados pelo parâmetro Path.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Summary <switch>

Obtém um resumo dos dados importados, em vez de obter amostras de dados de contador individuais.

Necessário?	true
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.String

Você pode canalizar caminhos de log do contador para Import-Counter.

Saídas

Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet, Microsoft.PowerShell.Commands.GetCounter.CounterSet, Microsoft.PowerShell.Commands.GetCounter.CounterFileInfo

Por padrão, Import-Counter retorna Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet. Se você usar o parâmetro ListSet, Import-Command retornará um objeto Microsoft.PowerShell.Commands.GetCounter.CounterSet. Se você usar o parâmetro Summary, Import-Command retornará um objeto Microsoft.PowerShell.Commands.GetCounter.CounterFileInfo.

Observações

O cmdlet Import-Counter não tem um parâmetro ComputerName. Porém, se o computador for configurado para comunicação remota do Windows PowerShell, você poderá usar o cmdlet Invoke-Command para executar um comando Import-Counter em um computador remoto.

Exemplo 1

C:\PS># Import-Counter

Descrição
-----------
Este comando importa todos os dados de contador do arquivo ProcessorData.csv para a variável $data.

C:\PS> $data = import-counter -path ProcessorData.csv

Exemplo 2

C:\PS># Import-Counter

Descrição
-----------
Este comando importa apenas os dados de contador Processador(_Total)\Interrupções/s do arquivo ProcessorData.blg para a variável $i.

C:\PS> $i = import-counter -path ProcessorData.blg -counter "\\SERVER01\Processador(_Total)\Interrupções/s"

Exemplo 3

C:\PS># Import-Counter

Descrição
-----------
Este exemplo mostra como selecionar dados de um arquivo de log de contador de desempenho (.blg) e exportar os dados selecionados para um arquivo .csv. 

Os primeiros quatro comandos obtêm os caminhos do contador do arquivo e os salva em uma variável. Os dois últimos comandos importam dados selecionados e exportam apenas os dados selecionados.


O primeiro comando usa Import-Counter para importar todos os dados de contador de desempenho dos arquivos ProcessorData.blg. O comando salva os dados na variável $data.

C:\PS> $data = import-counter .\processordata.blg



O segundo comando exibe os caminhos de contador na variável $data. A exibição é mostrada na saída do comando.

C:\PS> $data[0].countersamples | format-table path

Path
----
\\SERVER01\Processador(_Total)\Taxa de DPC
\\SERVER01\Processador(1)\Taxa de DPC
\\SERVER01\Processador(0)\Taxa de DPC
\\SERVER01\Processador(_Total)\% tempo ocioso
\\SERVER01\Processador(1)\% tempo ocioso
\\SERVER01\Processador(0)\% tempo ocioso
\\SERVER01\Processador(_Total)\% tempo C3
\\SERVER01\Processador(1)\% tempo C3
...


O terceiro comando obtém os caminhos do contador que terminam em "Interrupções/s" e salva os caminhos na variável $IntCtrs.

C:\PS> $IntCtrs = $data[0].countersamples | where {$_.path -like "*interrupções/s"} | foreach {$_.path}



O quarto comando exibe os caminhos de contador selecionados.

C:\PS> $IntCtrs

\\SERVER01\Processador(_Total)\Interrupções/s
\\SERVER01\Processador(1)\Interrupções/s
\\SERVER01\Processador(0)\Interrupções/s



O quinto comando usa o cmdlet Import-Counter para importar os dados. Ele usa o parâmetro Counter com a variável $IntCtrs para importar apenas dados para os caminhos de contador em $IntCtrs.

C:\PS> $i = import-counter -path .\processordata.blg -counter $intCtrs
    


O sexto comando usa o cmdlet Export-Counter para exportar os dados. 

C:\PS> $i | export-counter -path .\interrupts.csv -format CSV

Exemplo 4

C:\PS># Import-Counter

Descrição
-----------
Este exemplo mostra como exibir todos os caminhos de contador em um grupo de conjuntos de contadores importados. 

O primeiro comando usa o parâmetro ListSet para obter todos os conjuntos de contador que são representados em um arquivo de dados de contador.

C:\PS> import-counter -path processordata.csv -listset * 

CounterSetName     : Processor
MachineName        : \\SERVER01
CounterSetType     : MultiInstance
Description        :
Paths              : {\\SERVER01\Processador(*)\Taxa de DPC, \\SERVER01\Processador(*)\% tempo ocioso, \\SERVER01
                     \Processador(*)\% tempo C3, \\SERVER01\Processador(*)\% tempo de interrupção...}
PathsWithInstances : {\\SERVER01\Processador(_Total)\Taxa de DPC, \\SERVER01\Processador(1)\Taxa de DPC, \\SERVER01
                     \Processador(0)\Taxa de DPC, \\SERVER01\Processador(_Total)\% tempo ocioso...}
Counter            : {\\SERVER01\Processador(*)\Taxa de DPC, \\SERVER01\Processador(*)\% tempo ocioso, \\SERVER01
                     \Processador(*)\% tempo C3, \\SERVER01\Processador(*)\% tempo de interrupção...}



O segundo comando obtém todos os caminhos de contador do conjunto de listas.

C:\PS> import-counter -path processordata.csv -listset * | foreach {$_.paths}

\\SERVER01\Processador(*)\Taxa de DPC
\\SERVER01\Processador(*)\% tempo ocioso
\\SERVER01\Processador(*)\% tempo C3
\\SERVER01\Processador(*)\% tempo de interrupção
\\SERVER01\Processador(*)\% tempo C2
\\SERVER01\Processador(*)\% tempo de usuário
\\SERVER01\Processador(*)\% tempo C1
\\SERVER01\Processador(*)\% tempo de processador
\\SERVER01\Processador(*)\Transições C1/s
\\SERVER01\Processador(*)\% tempo de DPC
\\SERVER01\Processador(*)\Transições C2/s
\\SERVER01\Processador(*)\% tempo privilegiado
\\SERVER01\Processador(*)\Transições C3/s
\\SERVER01\Processador(*)\DPCs enfileirados/s
\\SERVER01\Processador(*)\Interrupções/s

Exemplo 5

C:\PS># Import-Counter

Descrição
-----------
Este exemplo importa apenas os dados de contador que têm um carimbo de data/hora entre os intervalos de início e término especificados no comando.

O primeiro comando lista os carimbos de data/hora de todos os dados no arquivo ProcessorData.blg.

  C:\PS> import-counter -path .\disk.blg | format-table timestamp


O segundo e o terceiro comandos salvam carimbos de data/hora específicos nas variáveis $start e $end. As cadeias de caracteres são convertidas em objetos DateTime.

  C:\PS> $start = [datetime]"7/9/2008 3:47:00 PM"
  C:\PS> $end = [datetime]"7/9/2008 3:47:59 PM"


O quarto comando usa Import-Counter para obter somente dados de contador que têm um carimbo de data/hora entre as horas de início e término (inclusive). O comando usa os parâmetros StartTime e EndTime para especificar o intervalo.

  C:\PS> $t-data = import-counter -path disk.blg -starttime $start -endtime $end

Exemplo 6

C:\PS># Import-Counter

Descrição
-----------
Este exemplo mostra como importar as cinco amostras mais antigas e as cinco mais recentes de um arquivo de log de contador de desempenho.

O primeiro comando usa o cmdlet Import-Counter para importar dados do arquivo Disk.blg. O comando usa o parâmetro MaxSamples para limitar a importação a cinco amostras de contador. Este comando obtém as primeiras cinco amostras (mais antigas) no arquivo.

C:\PS> import-counter -path disk.blg -maxSamples 5

O segundo comando usa notação matricial e o operador de intervalo do Windows PowerShell (..) para obter as últimas cinco amostras de contador do arquivo. Estas são as cinco amostras mais recentes.

C:\PS> (import-counter -path disk.blg)[-1 .. -5]

Exemplo 7

C:\PS># Import-Counter

Descrição
-----------
Este comando usa o parâmetro Summary para obter um resumo dos dados de contador do arquivo Memory.blg.

C:\PS> import-counter D:\Samples\memory.blg -summary

OldestRecord            NewestRecord            SampleCount
------------            ------------            -----------
7/10/2008 2:59:18 PM    7/10/2008 3:00:27 PM    1000

Exemplo 8

C:\PS># Import-Counter

Descrição
-----------
Este exemplo atualiza um arquivo de log de contador de desempenho. 

O primeiro comando usa o parâmetro ListSet de Import-Counter para obter os contadores em OldData.blg, um arquivo de log de contador existente. O comando usa um operador de pipeline (|) para enviar dados a um comando Foreach-Object que obtém somente os valores da propriedade PathsWithInstances de cada objeto.

C:\PS> $counters = import-counter olddata.blg -ListSet * | foreach {$_.PathsWithInstances}


O segundo comando usa esses mesmos contadores em um novo comando Get-Counter para obter uma amostra atual e exportá-la para o arquivo NewData.blg.

C:\PS> get-counter -counter $counters -maxSamples 20 | export-counter c:\Logs\newdata.blg

Exemplo 9

C:\PS># Import-Counter

Descrição
-----------
Este comando importa dados de log de desempenho de dois logs e salva os dados na variável $counters. O comando usa um operador de pipeline para enviar caminhos de log de desempenho para Import-Counter. 

C:\PS> $counters = "d:\test\pdata.blg", "d:\samples\netlog.blg" | import-counter

Observe que cada caminho está entre aspas e que os caminhos são separados um do outro por uma vírgula.

Consulte também

Conceitos

Get-Counter
Export-Counter

Compartilhar via