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

2026-09-29T00:21:48Z

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

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

= SOWA =

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

Идентификатор: <code>custom:sowa</code>.

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

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

* сбор статистики соединений SOWA;
* мониторинг внешних соединений;
* сбор показателей серверных зон и фильтров;
* сбор статистики ответов HTTP, MQ, Kafka и кеша;
* расчёт средней, минимальной и максимальной продолжительности запросов;
* создание сущностей хостов и профилей SOWA;
* установление связи между профилем и соответствующим хостом;
* формирование готовой обзорной панели.

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

Расширение запускается локально на контролируемом хосте.

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

* локальный интерфейс состояния SOWA доступен через TCP-порт или Unix-сокет;
* интерфейс состояния возвращает данные в формате JSON;
* процесс ЕдиногоАгента или EEC имеет доступ к Unix-сокету SOWA;
* время на хостах синхронизировано;
* для каждого контролируемого профиля известно его имя.

== Подключение к SOWA ==

Способ подключения зависит от версии SOWA.

{| class="wikitable"
! Версия SOWA
! Способ подключения
! Настройка
|-
| Ранее 5.2.1
| Локальный HTTP-интерфейс
| Укажите порт интерфейса <code>/status</code>.
|-
| 5.2.1 и новее
| Unix-сокет
| Оставьте поле порта пустым.
|}

При указании порта расширение обращается по адресу:

<pre>
http://127.0.0.1:<порт>/status
</pre>

Если порт не указан, используется Unix-сокет:

<pre>
/sowarun/<имя_профиля>/service_profile_status.sock
</pre>

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

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

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

{| class="wikitable"
! Параметр
! Обязательный
! Описание
|-
| <code>Profile name</code>
| Да
| Имя контролируемого профиля SOWA. Оно также используется для формирования пути к Unix-сокету и как измерение метрик.
|-
| <code>port</code>
| Нет
| Порт локального интерфейса <code>/status</code>. Используется для версий SOWA ранее 5.2.1. Если поле пустое, расширение подключается через Unix-сокет.
|}

В одной конфигурации можно добавить несколько профилей SOWA.

Пример для подключения через TCP-порт:

<pre>
Profile name: production
port: 8080
</pre>

Для подключения через Unix-сокет укажите имя профиля <code>production</code>, а поле <code>port</code> оставьте пустым.

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

{| class="wikitable"
! Набор
! Описание
|-
| <code>Profile Metrics</code>
| Текущие и суммарные показатели внутренних и внешних соединений SOWA.
|-
| <code>Server Zone Metrics</code>
| Запросы, входящий и исходящий трафик, ответы и продолжительность запросов серверных зон.
|-
| <code>Filter Zone Metrics</code>
| Запросы, трафик, ответы и продолжительность запросов для фильтров и их экземпляров.
|}

== Основные метрики ==

{| class="wikitable"
! Группа
! Примеры метрик
! Описание
|-
| Соединения
| <code>ru.ruscomtech.sowa.connections.active</code> <code>ru.ruscomtech.sowa.connections.requests.total</code>
| Активные соединения и общее количество запросов.
|-
| Внешние соединения
| <code>ru.ruscomtech.sowa.connections_external.active</code> <code>ru.ruscomtech.sowa.connections_external.requests.total</code>
| Состояние соединений внешнего интерфейса.
|-
| Серверные зоны
| <code>ru.ruscomtech.sowa.server_zone.request_counter</code> <code>ru.ruscomtech.sowa.server_zone.in_bytes</code> <code>ru.ruscomtech.sowa.server_zone.out_bytes</code>
| Количество запросов и объём трафика серверной зоны.
|-
| Ответы серверных зон
| <code>ru.ruscomtech.sowa.server_zone.responses.2xx</code> <code>ru.ruscomtech.sowa.server_zone.responses.5xx</code>
| HTTP-ответы, результаты работы MQ, Kafka и кеша.
|-
| Продолжительность запросов
| <code>ru.ruscomtech.sowa.server_zone.request_msecs.avg</code> <code>ru.ruscomtech.sowa.server_zone.request_msecs.high</code>
| Средняя, максимальная, минимальная продолжительность и количество запросов.
|-
| Фильтры
| <code>ru.ruscomtech.sowa.filter_zone.request_counter</code> <code>ru.ruscomtech.sowa.filter_zone.responses.5xx</code>
| Показатели отдельных фильтров и их экземпляров.
|}

Метрики содержат измерения с именем хоста, профилем, версиями SOWA и NGINX. Для зон и фильтров дополнительно передаются их имена.

== Обнаруживаемые сущности ==

Расширение создаёт следующие типы сущностей:

* <code>Sowa Host</code> — контролируемый хост SOWA;
* <code>Sowa profile</code> — отдельный профиль SOWA.

Между профилем и хостом автоматически создаётся связь <code>RUNS_ON</code>.

== Обзорная панель ==

В состав расширения входит панель <code>SOWA Extension Overview</code>. Она содержит список обнаруженных профилей и основные показатели соединений и запросов.

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

Для подключения через TCP-порт проверьте доступность интерфейса состояния непосредственно на хосте:

<pre>
curl http://127.0.0.1:<порт>/status
</pre>

Для подключения через Unix-сокет проверьте наличие файла:

<pre>
ls -l /sowarun/<имя_профиля>/service_profile_status.sock
</pre>

После активации конфигурации убедитесь, что:

* созданы сущности хоста и профиля SOWA;
* поступают метрики с префиксом <code>ru.ruscomtech.sowa</code>;
* на обзорной панели отображается настроенный профиль.

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

{| class="wikitable"
! Проблема
! Возможная причина и решение
|-
| Ошибка подключения к порту
| Проверьте номер порта и доступность адреса <code>http://127.0.0.1:<порт>/status</code>.
|-
| Ошибка подключения к Unix-сокету
| Проверьте имя профиля, наличие сокета и права процесса ЕдиногоАгента или EEC.
|-
| Интерфейс доступен, но метрики отсутствуют
| Убедитесь, что интерфейс состояния возвращает корректный JSON.
|-
| Не собирается продолжительность запросов
| Проверьте синхронизацию времени на контролируемом хосте.
|-
| Не отображается профиль
| Проверьте значение поля <code>Profile name</code> и наличие основных метрик соединений.
|}

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

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

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