Specifying a Counter Path (Указание пути счетчика)
Система использует счетчики для сбора данных о производительности. Каждый счетчик однозначно идентифицируется по имени, пути или расположению. Синтаксис пути счетчика:
\\Computer\PerfObject(ParentInstance/ObjectInstance#InstanceIndex)\Counter
Элемент Computer указывает имя или IP-адрес компьютера, с которого требуется запрашивать данные о производительности. Имя компьютера является необязательным, если счетчик находится на локальном компьютере.
Элемент PerfObject указывает объект производительности для запроса. Объект производительности может быть физическим компонентом, таким как процессоры, диски и память, или системным объектом, например процессами и потоками. Каждый системный объект связан с функциональным элементом на компьютере и ему назначен набор стандартных счетчиков. На каждом компьютере может быть установлен отдельный набор объектов производительности и счетчиков, так как приложения могут устанавливать собственные объекты производительности и счетчики. Список объектов производительности и счетчиков, установленных на компьютере, см. в диалоговом окне Добавление счетчиков в средстве производительности на компьютере. Эти объекты также перечислены в диалоговом окне обзора PDH (см. раздел Просмотр счетчиков). Список системных объектов производительности и счетчиков см. в разделе Счетчики по объектам.
ParentInstance, ObjectInstance и InstanceIndex включаются в путь, если может существовать несколько экземпляров объекта. Например, процессы и потоки являются несколькими объектами экземпляров, так как несколько процессов или потоков могут выполняться одновременно. Если объект может иметь несколько экземпляров, путь счетчика должен указывать экземпляр объекта.
Формат элементов, связанных с экземпляром, зависит от типа объекта. Если объект содержит простые экземпляры, то форматом является только имя экземпляра, заключенное в круглые скобки. Пример:
(Explorer)
Если экземпляру этого объекта также требуется имя родительского экземпляра, имя родительского экземпляра должно находиться перед экземпляром объекта и отделяться символом косой черты. Например, потоки принадлежат процессам. При запросе объекта потока необходимо также указать процесс, которому он принадлежит, как показано в следующем примере:
(Explorer/0)
Если объект содержит несколько экземпляров с одинаковыми строками имен, их можно индексировать последовательно, указав индекс экземпляра с префиксом символа фунта. Индексы экземпляров основаны на 0. Если вы хотите запросить первый экземпляр, не включайте #0— просто укажите имя экземпляра. Чтобы указать второй экземпляр, используйте #1; чтобы указать третий экземпляр, используйте #2; и так далее. Пример:
(Explorer/0#1)
Элемент Counter указывает счетчик производительности, который требуется запросить для заданного объекта производительности.
PDH использует следующие специальные символы в пути счетчика. Поставщики не должны использовать эти символы в своих именах. Если поставщик использует эти специальные символы, PDH не может проанализировать полный путь счетчика для получения имен счетчиков и экземпляров.
| Знак | Описание |
|---|---|
| \ | Универсальный разделитель для компьютера, объекта и счетчика. |
| ( | Начало имени экземпляра. |
| ) | Окончание имени экземпляра. |
| / | Разделяет экземпляр и родительский экземпляр. |
| #n | Идентифицирует определенное вхождение экземпляра с таким же именем. |
| * | Подстановочный знак. |
В следующих примерах показаны возможные форматы для путей счетчиков.
- \\computer\object(parent/instance#index)\counter
- \\computer\object(parent/instance)\counter
- \\computer\object(instance#index)\counter
- \\computer\object(instance)\counter
- \\computer\object\counter
- \object(parent/instance#index)\counter
- \object(parent/instance)\counter
- \object(instance#index)\counter
- \object(экземпляр)\counter
- \object\counter
Использование подстановочных знаков
Пути счетчиков могут содержать подстановочный знак только для имени экземпляра, как показано в следующем примере.
\Process(*)\% Processor Time
Чтобы развернуть подстановочный знак в список путей счетчиков, содержащих экземпляры, найденные на компьютере или в файле журнала, вызовите PdhExpandWildCardPath.