IKuznetsov в 15:20, 21 января 2026

2026-01-21T15:20:26Z

IKuznetsov: Новая страница: «Расширение '''SNMP Autodiscovery''' сканирует подсети и помогает пользователям обнаружить весь с...»

2026-01-20T01:13:49Z

Новая страница: «Расширение '''SNMP Autodiscovery''' сканирует подсети и помогает пользователям обнаружить весь с...»

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

Расширение '''SNMP Autodiscovery''' сканирует подсети и помогает пользователям обнаружить весь свой список сетевых устройств с поддержкой '''SNMP'''. Кроме того, это расширение также включает в себя топологическую модель, которая призвана быть достаточно универсальной, чтобы большинство источников данных, относящихся к сетевым устройствам, могли быть представлены с помощью простого набора общих сущностей: сетевое устройство, сетевой порт и сетевой интерфейс.

== Сценарий ==
В этом руководстве подробно описаны концепции, связывающие данную топологию воедино, и объясняется, как вы — как разработчик расширений или интегратор данных — можете использовать ту же модель.

Поскольку это техническое руководство, мы рассмотрим полный пример, основанный на урезанной версии расширения F5 BIG-IP.

К данному руководству прилагаются три манифеста расширений:

* <code>1_initial.yaml</code> это неизменное расширение. Оно отслеживает балансировщик нагрузки '''F5''', отправляя данные в Ключ-АСТРОМ, но не имея представления о модели устройства.
* <code>2_basic.yaml</code> демонстрирует базовые возможности использования. Теперь Ключ-АСТРОМ распознает балансировщик нагрузки '''F5''' как сетевое устройство с интерфейсами и портами. Другие приложения также будут его отображать.
* <code>3_advanced.yaml</code> демонстрирует расширенные возможности использования. Теперь сетевое устройство и интерфейс имеют доступ к большему объему данных. Сетевому устройству также были добавлены дополнительные атрибуты и диаграммы для отображения.

Подробнее об этих файлах см. в разделе '''Файлы манифеста''' ниже.
{| class="wikitable"
|Для более детального изучения изменений между тремя вариантами манифеста можно использовать онлайн-инструмент, например, [https://www.diffchecker.com/text-compare/ diffchecker].
|}

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

Давайте рассмотрим топологические сущности и взаимосвязи.

=== Сетевое устройство ===
(<code>network:device</code>)

* Сетевое устройство — это физическое устройство в сети. Это основная сущность, на которой размещена операционная система и работают технологии, необходимые для обеспечения сетевой связи и других возможностей.
* Сетевое устройство идентифицируется по своему управляющему IP-адресу и обозначается системным именем.

=== Сетевой порт ===
(<code>network:port</code>)

* Сетевой порт — это физический аппаратный сетевой порт на сетевом устройстве.
* Сетевой порт идентифицируется и обозначается своим MAC-адресом.

=== Сетевой интерфейс ===
(<code>network:interface</code>)

* Сетевой интерфейс — это физический или виртуальный сетевой интерфейс (NIC). Как правило, это первая точка отсчета в сетевых коммуникациях между устройствами.
* Сетевой интерфейс идентифицируется комбинацией MAC-адреса и имени интерфейса и обозначается своим именем.

=== Связи ===
Эти типы сущностей связаны между собой следующими отношениями:

* <code>network:port</code> <code>-runsOn-></code> <code>network:device</code>
* <code>network:interface</code> <code>-runsOn-></code> <code>network:device</code>
* <code>network:interface</code> <code>-isChildOf-></code> <code>network:port</code>

== Основное применение ==
Как уже упоминалось ранее, другим расширениям и интеграциям достаточно отправлять данные в правильном формате, чтобы использовать эту топологию. Обязательные измерения должны присутствовать во всех метриках, тогда как необязательные измерения можно добавить к одной метрике, чтобы уменьшить ненужное разделение данных.

=== Параметры и метрики для сетевых устройств ===
Для сетевых устройств доступны следующие метрики и параметры.

* Обязательные параметры:
** Ключ: <code>device.address</code> Применение: идентифицирует каждое устройство и определяет, когда следует создавать новые экземпляры сущностей.
** Ключ: <code>monitoring.mode</code> Применение: должно иметь фиксированное значение "'''Extension'''". Это влияет на пользовательский интерфейс и сообщает Ключ-АСТРОМ, что данный объект отслеживается.
** Ключ: <code>sys.name</code> Применение: присваивает устройству метку, указывая его имя.
** Ключ: <code>device.type</code> Применение: строка, представляющая тип устройства. Может быть названием технологии, маркой/моделью или просто меткой, например, "'''L3 Switch'''". Заполнит атрибут сущности <code>devType</code>.
* Дополнительные (рекомендуемые) параметры:
** Ключ: <code>device.port</code> Применение: регистрирует порт прослушивания на устройстве. Дополнительные сущности не создаются, но атрибут <code>dt.listen\ports</code> будет заполнен на основе уже созданного порта.
** Ключ: <code>sys.description</code> Применение: регистрирует описание устройства в атрибуте <code>devDescription</code>. Может содержать информацию о производителе или любой описательный текст.
* Метрики :
** Ключ: <code>com.astromkey.extension.network_device.sysuptime</code> Описание: Время в системных тиках (1/100 секунды), прошедшее с момента последней перезагрузки системы.
** Ключ: <code>com.astromkey.extension.network_device.cpu_usage</code> Описание: Применение ЦП системой, выраженное в процентах.
** Ключ: <code>com.astromkey.extension.network_device.cpu_ratio</code> Описание: Применение ЦП системой, выраженное в виде отношения.
** Ключ: <code>com.astromkey.extension.network_device.memory_used</code> Описание: Объем памяти в килобайтах, используемый устройством.
** Ключ: <code>com.astromkey.extension.network_device.memory_free</code> Описание: Объем памяти в килобайтах, в данный момент свободный на устройстве.
** Ключ: <code>com.astromkey.extension.network_device.memory_total</code> Описание: Общий (используемый и свободный) объем памяти в килобайтах, доступный на устройстве.
** Ключ: <code>com.astromkey.extension.network_device.memory_usage</code> Описание: Текущий объем памяти, используемый устройством, выраженный в процентах от общего объема памяти.

=== Параметры и метрики для сетевых интерфейсов ===
Ниже перечислены метрики и параметры, доступные для сетевых интерфейсов.

* Обязательные параметры:
** Ключ: <code>mac.address</code> Применение: в сочетании с именем идентифицирует каждый интерфейс и указывает, когда следует создавать новые экземпляры сущностей. Отдельно также идентифицирует сетевые порты и указывает, когда следует создавать новые экземпляры.
** Ключ: <code>if.name</code> Применение: в сочетании с MAC-адресом идентифицирует каждый интерфейс. Также присваивает каждому интерфейсу имя.
* Метрики :
** Ключ: <code>com.astromkey.extension.network_device.if.status</code> Описание: Метрика состояния, представляющая сетевой интерфейс, значение которой всегда равно 1, а её параметры указывают на детали состояния. Дополнительные параметры (извлекаемые в виде атрибутов сущности):
** Ключ: <code>oper.status</code> Применение: Рабочее состояние интерфейса (включен/выключен и т. д.).
** Ключ: <code>admin.status</code> Применение: Административное состояние интерфейса (включено/выключено и т. д.).
** Ключ: <code>if.speed</code> Применение: Скорость/пропускная способность интерфейса.
** Ключ: <code>com.astromkey.extension.network_device.if.bytes_in.count</code> Описание: Объем трафика в байтах, входящий на сетевой интерфейс.
** Ключ: <code>com.astromkey.extension.network_device.if.bytes_out.count</code> Описание: Объем трафика в байтах, исходящий с сетевого интерфейса.

=== Что можно ожидать на этом этапе? ===
Это должно гарантировать корректное создание сущностей сетевого устройства, сетевого порта и сетевого интерфейса на основе ваших данных. На этом этапе вы можете использовать либо приложение '''Technologies''', либо приложение '''Инфраструктура и операции''' для визуализации этих устройств.

* В приложении '''Technologies''' перейдите в <code>../ui/apps/astromkey.classic.technologies/ui/entity/list/network:interface</code>
* В приложении '''Инфраструктура и операции''' выберите вкладку '''Сетевые устройства'''.

== Расширенное применение ==
В этом разделе, основываясь на предыдущих изменениях, рассматривается вопрос расширения сетевой модели за счет добавления дополнительных метрик, связей с существующими сущностями и настройки пользовательского интерфейса.

Во многих случаях у вас, вероятно, уже есть расширение или интеграция, которая отправляет специализированные данные о конкретном типе сетевого устройства. В таких ситуациях модель может быть использована для установления связей «аналогично» между существующими сущностями и общими, фактически добавляя к ним новые метрики, настраивая их атрибуты и внедряя некоторые из существующих диаграмм в их пользовательский интерфейс.

После внедрения предложенных изменений выполните следующие дополнительные шаги:

Общая топология сети - История изменений

IKuznetsov в 15:20, 21 января 2026

IKuznetsov: Новая страница: «Расширение '''SNMP Autodiscovery'''﻿ сканирует подсети и помогает пользователям обнаружить весь с...»

IKuznetsov: Новая страница: «Расширение '''SNMP Autodiscovery''' сканирует подсети и помогает пользователям обнаружить весь с...»