Azubarev: Новая страница: «= SOWA Monitor = Расширение предназначено для сбора метрик SOWA из локального файла статистики, формируемого на контролируемом хосте. Идентификатор: `ru.ruscomtech.sowa-monitor` == Возможности == Расширение выполняет: * чтение метрик профилей SOWA; * сбор состояния сер...»

2026-09-29T00:17:37Z

Новая страница: «= SOWA Monitor = Расширение предназначено для сбора метрик SOWA из локального файла статистики, формируемого на контролируемом хосте. Идентификатор: <code>ru.ruscomtech.sowa-monitor</code> == Возможности == Расширение выполняет: * чтение метрик профилей SOWA; * сбор состояния сер...»

Новая страница

= SOWA Monitor =

Расширение предназначено для сбора метрик SOWA из локального файла статистики, формируемого на контролируемом хосте.

Идентификатор: <code>ru.ruscomtech.sowa-monitor</code>

== Возможности ==

Расширение выполняет:

* чтение метрик профилей SOWA;
* сбор состояния сервисов;
* расчёт количества дней до окончания срока действия сертификатов;
* преобразование логических значений <code>true</code> и <code>false</code> в числовые значения;
* добавление источника, профиля, сервиса и имени метрики в измерения.

Расширение запускается локально на хосте и не устанавливает сетевые подключения к SOWA.

== Требования ==

Перед настройкой расширения убедитесь, что:

* файл статистики создаётся на том же хосте, на котором запускается расширение;
* файл сохранён в кодировке UTF-8;
* для файла используется абсолютный путь;
* процесс ЕдиногоАгента или EEC имеет права на чтение файла;
* каждая метрика записывается отдельной строкой в поддерживаемом формате.

== Формат файла статистики ==

Каждая строка должна иметь следующий формат:

<pre>
<источник> <область_метрики>[<объект>,<метрика>] <значение>
</pre>

Пример:

<pre>
sowa-host-01 sowa.profile[MainProfile,availability] 1
sowa-host-01 sowa.profile[MainProfile,errors] 0
sowa-host-01 sowa.profile.certificate[api.example.local,valid_throw] 1798761600
sowa-host-01 sowa.profile.service.http[frontend,response_time] 125.7
</pre>

{| class="wikitable"
! Элемент
! Описание
|-
| <code>источник</code>
| Имя системы или хоста, сформировавшего метрику.
|-
| <code>область_метрики</code>
| Тип метрики: <code>sowa.profile</code>, <code>sowa.profile.certificate</code> или область, начинающаяся с <code>sowa.profile.service</code>.
|-
| <code>объект</code>
| Имя профиля, сертификата или сервиса.
|-
| <code>метрика</code>
| Имя показателя.
|-
| <code>значение</code>
| Число либо логическое значение <code>true</code> или <code>false</code>.
|}

Значение <code>true</code> преобразуется в <code>1</code>, а <code>false</code> — в <code>0</code>.

Для метрики <code>valid_throw</code> необходимо передавать дату окончания действия сертификата в виде временной метки Unix в секундах. Расширение преобразует её в количество оставшихся дней.

Пустые строки и строки неподдерживаемого формата пропускаются.

== Установка и настройка ==

# Загрузите пакет расширения в Ключ-АСТРОМ.
# Создайте локальную конфигурацию расширения.
# Выберите хост, группу хостов или зону управления, на которых должен выполняться сбор.
# Добавьте источник данных.
# Укажите абсолютный путь к файлу статистики.
# При необходимости включите сбор метрик сервисов.
# Сохраните и активируйте конфигурацию.

=== Параметры конфигурации ===

{| class="wikitable"
! Параметр
! Описание
! Значение по умолчанию
|-
| <code>Stats file path</code>
| Абсолютный путь к файлу статистики SOWA.
| <code>/tmp/zabbix/all_stat.data</code>
|-
| <code>Include sowa.profile.service* metrics</code>
| Включает сбор областей метрик, начинающихся с <code>sowa.profile.service</code>.
| Отключено
|}

В одной конфигурации можно создать несколько источников для чтения разных файлов статистики.

== Собираемые метрики ==

{| class="wikitable"
! Метрика
! Описание
! Единица измерения
|-
| <code>sowa.zabbix.profile.value</code>
| Значение метрики профиля SOWA.
| Количество
|-
| <code>sowa.zabbix.profile.certificate.value</code>
| Значение метрики сертификата, включая количество дней до окончания его действия.
| Дни
|-
| <code>sowa.zabbix.profile.service.value</code>
| Значение метрики сервиса SOWA.
| Количество
|}

== Проверка работы ==

На контролируемом хосте проверьте доступность файла:

<pre>
test -r /tmp/zabbix/all_stat.data
</pre>

После активации конфигурации убедитесь, что в Ключ-АСТРОМ поступают метрики с префиксом <code>sowa.zabbix</code>.

Успешное сохранение конфигурации не подтверждает доступность файла. Если метрики отсутствуют, проверьте журнал выполнения расширения.

== Устранение неисправностей ==

{| class="wikitable"
! Проблема
! Возможная причина и решение
|-
| Метрики не поступают
| Проверьте путь к файлу и права процесса ЕдиногоАгента или EEC на его чтение.
|-
| Обрабатываются не все строки
| Проверьте формат строк, наличие запятой между именем объекта и метрики, а также числовой формат значения.
|-
| Не поступают метрики сервисов
| Включите параметр <code>Include sowa.profile.service* metrics</code>.
|-
| Неверно рассчитан срок действия сертификата
| Передавайте для метрики <code>valid_throw</code> временную метку Unix в секундах, а не в миллисекундах.
|}

== История изменений ==

{| class="wikitable"
! Версия
! Изменения
|-
| 0.1.0
|
* Добавлен локальный сбор метрик профилей SOWA из файла статистики.
* Добавлен сбор метрик сервисов.
* Добавлен расчёт количества дней до окончания срока действия сертификатов.
* Добавлена поддержка логических и числовых значений.
|}

SOWA Monitor - История изменений