Экспортер Prometheus для Windows Machines.
| Имя | Описание | Включено по умолчанию |
|---|---|---|
| объявление | Active Directory Domain Services | |
| АЦП | Сертификаты сертификации активного каталога | |
| ADFS | Служба федерации активных каталогов | |
| кеш | Метрики кеша | |
| Процессор | Использование процессора | ✓ |
| CPU_INFO | Информация процессора | |
| CS | Метрики «Компьютерная система» (свойства системы, Num процессоры/общая память) | |
| контейнер | Метрики контейнера | |
| дискрив | Дисковые метрики | |
| DFSR | Метрики DFSR | |
| DHCP | DHCP -сервер | |
| DNS | DNS -сервер | |
| обмен | Обменные метрики | |
| FILETIME | FileTime метрики | |
| fsrmquota | Microsoft File Server Resourdce Manager (FSRM) Коллектор | |
| гиперв | Hyper-V-хозяева | |
| IIS | Сайты и приложения IIS | |
| лицензия | Статус лицензии Windows | |
| logical_disk | Логические диски, диск ввод/вывод | ✓ |
| вход в систему | Пользовательские сеансы входа | |
| память | Метрики использования памяти | ✓ |
| MSCluster | Метрики MSCluster | |
| MSMQ | Очереди MSMQ | |
| MSSQL | Метрики объектов производительности SQL Server | |
| netframework | .Net Framework Metrics | |
| сеть | Сетевой интерфейс ввод/вывод | ✓ |
| ОС | Метрики ОС (память, процессы, пользователи) | ✓ |
| Pagefile | Метрики Pagefile | |
| PerformanceCounter | Пользовательские метрики счетчиков производительности | |
| физический_диск | Физические показатели диска | ✓ |
| принтер | Метрики принтера | |
| процесс | Метрики для процесса | |
| remote_fx | Метрики протокола DEMOTEFX (RDP) | |
| graduled_task | Запланированные метрики задач | |
| услуга | Метрики государства обслуживания | ✓ |
| малый | SMB Server | |
| SMBClient | SMB Client | |
| SMTP | IIS SMTP -сервер | |
| система | Системные вызовы | ✓ |
| TCP | Соединения TCP | |
| Terminal_services | Терминальные услуги (RDS) | |
| текстовыйфил | Читать метрики Prometheus из текстового файла | |
| Термальзона | Тепловая информация | |
| время | Windows Time Service | |
| UDP | UDP соединения | |
| обновлять | Сервис обновления Windows | |
| VMware | Счетчики производительности установлены гостевым агентом VMware |
См. Связанную документацию на каждом коллекционере для получения дополнительной информации о показанных показателях, настройках конфигурации и примерах использования.
windows_exporter по умолчанию выставит все метрики от включенных коллекционеров. Это рекомендуемый способ сбора метрик, чтобы избежать ошибок при сравнении метрик разных семей.
Для Advanced использовать windows_exporter может быть передан дополнительный список коллекционеров для фильтрации метрик. Параметр collect[] может использоваться несколько раз. В конфигурации Prometheus вы можете использовать этот синтаксис под конфигурацией Scrape.
params:
collect[]:
- foo
- bar
Это может быть полезно для того, чтобы различные серверы Prometheus собирали определенные метрики из узлов.
Windows_exporter принимает флаги для настройки определенного поведения. Те, настройку глобального поведения экспортера, перечислены ниже, в то время как специфичные для коллекционера документированы в соответствующей коллекционной документации выше.
| Флаг | Описание | Значение по умолчанию |
|---|---|---|
--web.listen-address | Хост: порт для экспортера. | :9182 |
--telemetry.path | Путь URL для всплеска собрания метрик. | /metrics |
--telemetry.max-requests | Максимальное количество параллельных запросов. 0, чтобы отключить. | 5 |
--collectors.enabled | Запятый список коллекционеров для использования. Используйте [defaults] в качестве заполнителя, который расширяется, содержащий все коллекционеры, включенные по умолчанию ». | [defaults] |
--collectors.print | Если это правда, распечатайте доступные коллекционеры и выходят. | |
--scrape.timeout-margin | Секунды, чтобы вычесть из тайм -аута, разрешенного клиентом. Настройтесь, чтобы обеспечить накладные или высокие нагрузки. | 0.5 |
--web.config.file | Веб -конфигурация для настройки TLS и AUTH | Никто |
--config.file | Использование файла конфигурации из пути или URL -адреса | Никто |
--config.file.insecure-skip-verify | Пропустить TLS при загрузке файла конфигурации из URL -адреса | ЛОЖЬ |
--log.file | Вывод файл сообщений журнала. Один из [stdout, stderr, eventlog, <path to log file>] Примечание. Установщик MSI добавит аргумент по умолчанию в установленную службу настройку этого в EventLog | Stderr |
Последний релиз можно загрузить со страницы релизов.
Каждый релиз предоставляет установщик .msi. Установщик настроит Windows_exporter в качестве службы Windows, а также создаст исключение в брандмауэре Windows.
Если установщик запускается без каких -либо параметров, экспортер будет работать с настройками по умолчанию для включенных коллекционеров, портов и т. Д.
Установщик предоставляет файл конфигурации для настройки экспортера.
Файл конфигурации
--config.file .Доступны следующие параметры:
| Имя | Описание |
|---|---|
ENABLED_COLLECTORS | В качестве флага --collectors.enabled предоставьте список с открытыми коллекционерами, разделяемый запятыми. |
CONFIG_FILE | Используйте флаг --config.file , чтобы указать файл конфигурации. Если пуст, файл конфигурации не будет установлен. Специальное значение config.yaml Установите путь на config.yaml при установлении dir |
LISTEN_ADDR | IP -адрес для привязки. По умолчанию в пустую строку. (любой местный адрес) |
LISTEN_PORT | Порт для привязки. По умолчанию до 9182 . |
METRICS_PATH | Путь, по которому можно служить метрик. По умолчанию /metrics |
TEXTFILE_DIRS | Используйте флаг --collector.textfile.directories , чтобы указать один или несколько каталогов, разделенных запятыми, где коллекционер должен читать текстовые файлы, содержащие метрики |
REMOTE_ADDR | Позволяет настройки отдельных IP -адресов для настройки запятой для исключения брандмауэра Windows (разрешить список). По умолчанию в пустую строку (любой удаленный адрес). |
EXTRA_FLAGS | Позволяет проходить полные флаги CLI. По умолчанию в пустую строку. Для --collectors.enabled и --config.file , используйте специализированные свойства ENABLED_COLLECTORS и CONFIG_FILE |
ADDLOCAL | Включает функции в установке Windows_exporter. Поддерживаемые значения: FirewallException |
REMOVE | Отключает функции в установке Windows_exporter. Поддерживаемые значения: FirewallException |
Параметры отправляются установщику через msiexec . На PowerShell --% следует пройти перед определением свойств.
Пример призывы:
msiexec / i < path - to - msi - file > --% ENABLED_COLLECTORS=os,iis LISTEN_PORT=5000Пример сервисного коллекционера с пользовательским запросом.
msiexec / i < path - to - msi - file > --% ENABLED_COLLECTORS=os,service EXTRA_FLAGS="--collectors.exchange.enabled=""ADAccessProcesses"""Определите файл конфигурации.
msiexec / i < path - to - msi - file > --% CONFIG_FILE="D:config.yaml"На некоторых старых версиях Windows вам может потребоваться окружить значения параметров с двойными кавычками, чтобы правильно анализировать команду установки:
msiexec / i C:UsersAdministratorDownloadswindows_exporter.msi --% ENABLED_COLLECTORS="ad,iis,logon,memory,process,tcp,textfile,thermalzone" TEXTFILE_DIRS="C:custom_metrics"Чтобы установить экспортер с созданием исключения брандмауэра, используйте следующую команду:
msiexec / i < path - to - msi - file > --% ADDLOCAL=FirewallException Версии PowerShell 7.3 и выше требуют, чтобы PSNativeCommandargumentPassing для Legacy при использовании --% EXTRA_FLAGS :
$PSNativeCommandArgumentPassing = ' Legacy '
msiexec / i < path - to - msi - file > ENABLED_COLLECTORS = os , service --% EXTRA_FLAGS="--collectors.exchange.enabled=""ADAccessProcesses""" Windows_exporter можно запустить в качестве контейнера Docker. Изображение Docker доступно на
docker.io/prometheuscommunity/windows-exporterghcr.io/prometheus-community/windows-exporter Изображение Docker помечено версией экспортера. latest тег также доступен и указывает на последний выпуск.
Кроме того, аромат hostprocess с -hostprocess в качестве суффикса основан на https://github.com/microsoft/windows-host-process-containers-base-image, который предназначен для работы в качестве контейнера для хоста Windows. Размер этих изображений меньше по умолчанию.
Смотрите подробные шаги для установки на Windows Kubernetes здесь.
windows_exporter поддерживает версии Windows Server 2016 и позже, а также настольные версии Windows 10 и 11 (21H2 или более поздней).
Windows Server 2012 и 2012R2 поддерживаются только как лучшие, но не гарантированно будут работать.
go get -u github.com/prometheus/promu
go get -u github.com/prometheus-community/windows_exporter
cd $env:GOPATH/src/github.com/prometheus-community/windows_exporter
promu build -v
.windows_exporter.exe
Метрики Prometheus будут выставлены на Localhost: 9182
Windows_exporter предоставляет следующие http -конечные точки:
/metrics : обнажает метрики в формате текста Prometheus./health : возвращает 200 OK, когда экспортер работает./debug/pprof/ : Раскрывает конечные точки PPROF. Только, если установлен --debug.enabled . .windows_exporter.exe --collectors.enabled "service" --collector.service.include="windows_exporter"
.windows_exporter.exe --collectors.enabled "process" --collector.process.include="firefox.+"
Когда существует несколько процессов с одним и тем же именем, WMI представляет собой те, кто после первого экземпляра как process-name#index . Таким образом, чтобы получить их всех, а не только первое, регулярное выражение должно использовать .+ . Смотрите процесс для получения дополнительной информации.
--collectors.enabled Использование [defaults] с аргументом --collectors.enabled который расширяется со всеми коллекционерами по умолчанию.
.windows_exporter.exe --collectors.enabled "[defaults],process,container"
Это позволяет дополнительным коллекционерам процесса и контейнеров поверх значения по умолчанию.
Файлы конфигурации YAML могут быть указаны с помощью флага --config.file . например .windows_exporter.exe --config.file=config.yml . Если вы используете абсолютный путь, обязательно процитируйте путь, например .windows_exporter.exe --config.file="C:Program Fileswindows_exporterconfig.yml"
Также возможно загрузить конфигурацию из URL. например .windows_exporter.exe --config.file="https://example.com/config.yml"
Если вам нужно пропустить проверку TLS, вы можете использовать флаг- --config.file.insecure-skip-verify . например .windows_exporter.exe --config.file="https://example.com/config.yml" --config.file.insecure-skip-verify
collectors :
enabled : cpu,net,service
collector :
service :
include : windows_exporter
log :
level : warnПример файла конфигурации можно найти здесь.
Значения файлов конфигурации могут быть смешаны с флагами CLI. НАПРИМЕР
.windows_exporter.exe --collectors.enabled=cpu,logon
log :
level : debugФлаги CLI пользуются более высоким приоритетом по сравнению с значениями, указанными в файле конфигурации.
Под MIT