Qualificadores de propriedade para classes de contador de desempenho

  • Artigo

Os qualificadores de propriedade especificam informações sobre o contador de desempenho para o qual a propriedade é mapeada.

O contador de desempenho faz parte de um objeto de desempenho representado por uma classe de contador de desempenho do WMI Os qualificadores específicos do contador de desempenho são anexados automaticamente pelo provedor WbemPerfClass para classes e propriedades Win32_PerfRawData em Root\CIMv2.

Essas informações se aplicam a todas as instâncias da classe de desempenho. Alguns qualificadores com valores boolianos que são sempre falsos podem não estar presentes em classes específicas.

Qualificadores de propriedade para classes de desempenho brutas e formatadas

A lista a seguir relaciona os qualificadores que se aplicam a propriedades em classes derivadas de Win32_PerfRawData ou Win32_PerfFormattedData.

CounterType

sint32

Valor inteiro na enumeração de tipo de contador, conforme definido em Winperf.h ou Perflib.h. O qualificador CounterType indica a fórmula ou algoritmo usado para calcular o valor mostrado no monitor do sistema para o contador que a propriedade representa.

DisplayName

cadeia de caracteres

O nome do contador de desempenho, conforme especificado pelo PDH (Auxiliar de Dados de Desempenho).

HelpIndex

sint32

Não usado. Sempre contém 0.

PerfIndex

sint32

Não usado. Sempre contém 0.

Qualificadores de propriedade para classes de desempenho bruto

A lista a seguir relaciona os qualificadores que se aplicam a todas as propriedades de classes derivadas de Win32_PerfRawData.

PerfDefault

booleano

Indica se essa propriedade é o contador padrão a ser usado em caixas de listagem. Esse qualificador usa como padrão False para Contadores de Desempenho versão 6.0 porque eles não fornecem dados para ele. Para obter mais informações, consulte Performance Counters.

DefaultScale

sint32

Potência de 10 a ser usada para exibição do contador. Para zero, o máximo estimado é 10^0 ou 1.

PerfDetail

sint32

Nível de conhecimento do público. Não usado. O valor é sempre 100.

Qualificadores de propriedade para classes de desempenho formatadas

A lista a seguir relaciona os qualificadores que se aplicam a todas as propriedades de classes derivadas de Win32_PerfFormattedData.

CookingType

cadeia de caracteres

Tipo de fórmula usado para produzir o resultado. Cada tipo de contador usa os outros qualificadores de propriedade para calcular o resultado mostrado como valor da propriedade atual. Os qualificadores Counter, PerfTimeStamp e PerfTimeFreq são mapeados para propriedades em uma classe bruta que fornece os dados.

Para obter mais informações, consulte Qualificador CounterType.

Contador

cadeia de caracteres

Nome de uma propriedade necessária na classe bruta correspondente a ser usada como valor do contador na fórmula de cozimento. O valor deve ser o nome da propriedade da fonte de dados na classe bruta correspondente.

PerfTimeStamp

cadeia de caracteres

Nome de uma propriedade em uma classe bruta a ser usada como uma frequência na fórmula de cozimento. O valor padrão apropriado no nível da classe será usado se esse qualificador não estiver presente para a propriedade. A frequência representa os tiques por segundo do carimbo de data/hora.

PerfTimeFreq

cadeia de caracteres

Nome de uma propriedade em uma classe bruta a ser usada como um carimbo de data/hora na fórmula de cozimento. O valor padrão apropriado no nível da classe é usado se esse qualificador não estiver presente para a propriedade. Um carimbo de data/hora gerado automaticamente pode introduzir um erro em um cálculo por ser uma aproximação e não levar em conta a sobrecarga gerada pelo marshaling e pela coleta real de dados.

Como interpretar qualificadores de propriedade

As propriedades nas classes Win32_PerfFormattedData contêm os dados calculados fornecidos pelo Provedor de Dados de Desempenho Formatados. O valor da propriedade é o resultado final calculado. Os qualificadores fornecem uma receita.

Os qualificadores Counter e Base apontam para as fontes de dados e CookingType especifica a fórmula usada para produzir o resultado. O carimbo de data/hora e a frequência da amostra também vêm da classe bruta correspondente e são nomeados em PerfTimeStamp e PerfTimeFreq.

Por exemplo, uma das classes formatadas fornecidas pelo WMI, Win32_PerfFormattedData_PerfDisk_LogicalDisk, contém uma propriedade chamada AvgDiskBytesPerRead. O nome da propriedade na classe formatada deve ser o mesmo que o da propriedade na classe bruta. A propriedade AvgDiskBytesPerRead tem os qualificadores a seguir.

A lista a seguir relaciona os qualificadores de propriedade disponíveis para propriedades de todas as classes derivadas de Win32_PerfFormattedData.

Qualificador Valor
CookingType PERF_AVERAGE_BULK
Contador AvgDiskBytesPerRead
PerfTimeStamp Timestamp_PerfTime
PerfTimeFreq Frequency_PerfTime
PerfIndex 408
HelpIndex 409
Base AvgDiskBytesPerRead_Base

 

A propriedade AvgDiskBytesPerRead relata o número médio de bytes transferidos do disco durante operações de leitura. A fórmula para PERF_AVERAGE_BULK é:

(Sample2 – Sample1) / (Base Sample2 – Base Sample1)

A operação de leitura é amostrada na frequência especificada por PerfTimeFreq com o valor PerfTimeStamp indicando o exemplo mais recente. Os dados brutos do contador em bytes são obtidos da propriedade AvgDiskBytesPerRead na classe Win32_PerfRawData_PerfDisk_LogicalDisk. O número base de dados de operações é obtido da propriedade AvgDiskBytesPerRead_Base nessa mesma classe.

Para obter mais informações, consulte Obter dados estatísticos de desempenho e Monitorar dados de desempenho.

Monitorar dados de desempenho

Qualificadores específicos para classes de desempenho do WMI

Classes do contador de desempenho

Acessar classes de desempenho pré-instaladas do WMI

Tarefas do WMI: monitoramento de desempenho