Узлы сети

Обзор

Узлы сети экспортируются вместе со многими связанными объектами и связями между объектами.

Экспорт узла сети содержит:

• Связанные группы узлов сети
• Данные узла сети
• Связи с шаблонами
• Связи с группами узлов сети
• Интерфейсы узла сети
• Непосредственно связанные элементы данных
• Непосредственно связанные триггеры
• Непосредственно связанные правила обнаружения со всеми прототипами
• Непосредственно связанные веб-сценарии
• Макросы узла сети
• Данные инвентаризации узла сети
• Карты значений
• Связанные графики

Экспорт

Чтобы экспортировать узлы сети, выполните следующие действия:

1. Перейдите в Сбор данных > Узлы сети.
2. Отметьте флажками узлы сети, которые нужно экспортировать.
3. Нажмите Экспорт под списком, чтобы экспортировать в формате YAML по умолчанию, или нажмите стрелку, чтобы выбрать другой формат экспорта.

В зависимости от выбранного формата узлы сети экспортируются в локальный файл с именем по умолчанию:

• zabbix_export_hosts.yaml - при экспорте в YAML;
• zabbix_export_hosts.xml - при экспорте в XML;
• zabbix_export_hosts.json - при экспорте в JSON.

Импортирование

Чтобы импортировать узлы сети, выполните следующие действия:

1. Перейдите в раздел Сбор данных > Узлы сети.
2. Нажмите Импорт в правом верхнем углу.
3. Выберите файл импорта.
4. Установите флажки правил импорта, которые необходимо применить (см. ниже).
5. Нажмите Импорт в правом нижнем углу формы настройки.

Если установить флажок Расширенные параметры, отобразится подробный список всех доступных для импорта элементов - установите или снимите флажок каждого правила импорта по необходимости.

Если установить флажок в строке Все, будут установлены или сняты флажки всех расположенных ниже элементов.

Правила импорта:

Во время импорта невозможно просмотреть изменения узлов сети. Сообщение об успешном или неудачном импорте будет отображено в веб-интерфейсе.

Формат экспорта

Когда узел сети экспортируется, Zabbix генерирует структурированный формат YAML, JSON или XML. Экспорт включает элементы узла сети, такие как метаданные узла сети, элементы данных, макросы, триггеры и многое другое.

Каждый элемент служит определенной цели и может содержать вложенные элементы.

В следующих разделах описан каждый элемент в формате экспорта. В примерах используется узел сети с шаблоном MySQL by Zabbix agent 2. Для демонстрации элементов шаблон отвязывается после создания узла сети. При отвязке все элементы остаются в конфигурации (в отличие от отвязки и очистки, которая удаляет их).

Многоточие (...) обозначает элементы, опущенные для краткости. Примечание (см. таблицу ниже) используется, когда элемент более подробно объясняется в последующих разделах.

Метаданные узла сети

zabbix_export:
  version: '8.2'
  host_groups:
    - uuid: 748ad4d098d447d492bb935c907f652f
      name: Databases
  hosts: (см. таблицу ниже)
  graphs: (см. таблицу ниже)

Узлы сети

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      name: 'MySQL server'
      groups:
        - name: Databases
      interfaces: (see table below)
      items: (see table below)
      discovery_rules: (see table below)
      tags:
        - tag: location
          value: Riga
      macros:
        (...)
        - macro: '{$MYSQL.DSN}'
          value: 192.0.2.1
        (...)
        - macro: '{$MYSQL.PASSWORD}'
          type: SECRET_TEXT
          description: 'Пароль пользователя MySQL.'
        (...)
      valuemaps: (see table below)
  (...)

Интерфейсы узла сети

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      interfaces:
        - ip: 192.0.2.1
          interface_ref: if1
      (...)

Элементы данных узла сети

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: 'Использование диска кэшем бинарного журнала'
          type: DEPENDENT
          key: mysql.binlog_cache_disk_use
          value_type: FLOAT
          description: 'Количество транзакций, использовавших временный дисковый кэш, поскольку они не помещались в обычный кэш бинарного журнала и были больше `binlog_cache_size`.'
          preprocessing: (см. таблицу ниже)
          master_item:
            key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          tags:
            - tag: component
              value: cache
        (...)
        - name: 'Использование буферного пула'
          type: CALCULATED
          key: mysql.buffer_pool_utilization
          value_type: FLOAT
          units: '%'
          params: |
            ( last(//mysql.innodb_buffer_pool_pages_total) - 
            last(//mysql.innodb_buffer_pool_pages_free) ) / 
            ( last(//mysql.innodb_buffer_pool_pages_total) + 
            ( last(//mysql.innodb_buffer_pool_pages_total) = 0 ) ) * 100 * 
            ( last(//mysql.innodb_buffer_pool_pages_total) > 0 )
          description: 'Отношение количества использованных страниц к общему количеству страниц в буферном пуле.'
          tags:
            - tag: component
              value: memory
          triggers: (см. таблицу ниже)
        (...)
        - name: Время работы
          type: DEPENDENT
          key: mysql.uptime
          units: uptime
          description: 'Количество секунд, в течение которых сервер работает.'
          preprocessing: (см. таблицу ниже)
          master_item:
            key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          tags:
            - tag: component
              value: application
          triggers: (см. таблицу ниже)
        (...)

Шаги предварительной обработки значения элемента данных узла сети

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: 'Binlog cache disk use'
          (...)
          preprocessing:
            - type: JSONPATH
              parameters:
                - $.Binlog_cache_disk_use
            - type: DISCARD_UNCHANGED_HEARTBEAT
              parameters:
                - 6h
          (...)

Триггеры элемента данных узла сети

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: Uptime
          (...)
          triggers:
            - expression: 'nodata(/MySQL server/mysql.uptime,30m)=1'
              name: 'MySQL: Не удалось получить данные'
              event_name: 'MySQL: Не удалось получить данные (или нет данных за 30m)'
              priority: INFO
              description: 'Zabbix не получал никаких данных для элементов данных в течение последних 30 минут.'
              dependencies:
                - name: 'MySQL: Служба недоступна'
                  expression: 'last(/MySQL server/mysql.ping["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"])=0'
              tags:
                - tag: scope
                  value: availability
            - expression: 'last(/MySQL server/mysql.uptime)<10m'
              name: 'MySQL: Служба была перезапущена'
              event_name: 'MySQL: Служба была перезапущена (uptime < 10m)'
              priority: INFO
              description: 'Время работы MySQL меньше 10 минут.'
              tags:
                - tag: scope
                  value: notice
        (...)

Правила низкоуровневого обнаружения узла сети

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      discovery_rules:
        - name: 'Database discovery'
          key: 'mysql.db.discovery["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          delay: 1h
          filter: (см. таблицу ниже)
          description: 'Сканирование баз данных в СУБД.'
          interface_ref: if1
          item_prototypes:
            - name: 'Размер базы данных {#DATABASE}'
              key: 'mysql.db.size["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}","{#DATABASE}"]'
              delay: 5m
              units: B
              description: 'Размер базы данных.'
              preprocessing:
                - type: DISCARD_UNCHANGED_HEARTBEAT
                  parameters:
                    - 1h
              interface_ref: if1
              tags:
                - tag: component
                  value: storage
                - tag: database
                  value: '{#DATABASE}'
          lld_macro_paths:
            - lld_macro: '{#DATABASE}'
              path: $.Database
          preprocessing:
            - type: DISCARD_UNCHANGED_HEARTBEAT
              parameters:
                - 1d
        (...)

Фильтры правила низкоуровневого обнаружения узла сети

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      discovery_rules:
        - name: 'Database discovery'
          (...)
          filter:
            evaltype: AND
            conditions:
              - macro: '{#DATABASE}'
                value: '{$MYSQL.DBNAME.MATCHES}'
              - macro: '{#DATABASE}'
                value: '{$MYSQL.DBNAME.NOT_MATCHES}'
                operator: NOT_MATCHES_REGEX
          (...)

Операции переопределения правила низкоуровневого обнаружения узла сети

Веб-сценарии узла сети

Шаги веб-сценария узла сети

Графики узла сети

zabbix_export:
  (...)
  graphs:
    - name: 'MySQL: Bandwidth'
      graph_items: (см. таблицу ниже)
    (...)

Элементы графика узла сети

zabbix_export:
  (...)
  graphs:
    - name: 'MySQL: Bandwidth'
      graph_items:
        - drawtype: GRADIENT_LINE
          color: 199C0D
          item:
            host: 'MySQL server'
            key: mysql.bytes_received.rate
        - sortorder: '1'
          drawtype: GRADIENT_LINE
          color: F63100
          item:
            host: 'MySQL server'
            key: mysql.bytes_sent.rate
    (...)

Карты значений узла сети

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      valuemaps:
        - name: Example value map
          mappings:
            - value: '1'
              newvalue: Example value
  (...)

Сноски

¹ Целочисленные значения API в скобках, например ENABLED (0), приведены только для справки. Для получения дополнительной информации см. связанную страницу объекта API в записи таблицы или в конце каждого раздела.