4. Узлы сети

Обзор

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

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

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

Экспорт

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

1. Перейдите к: Сбор данных → Узлы сети (Data collection → Hosts).
2. Отметьте флажками узлы сети для экспорта.
3. Нажмите Экспорт (Export) ниже списка.

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

• zabbix_export_hosts.yaml — при экспорте в YAML (опция по умолчанию для экспорта);
• zabbix_export_hosts.xml — при экспорте в XML;
• zabbix_export_hosts.json — при экспорте в JSON.

Импорт

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

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

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

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

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

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

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

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

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

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

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

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

zabbix_export:
  version: '7.4'
  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: 'Использование дискового кэша binlog'
          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: 'Обнаружение баз данных'
          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: (see table below)
    (...)

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

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, указанной в таблице или в конце каждого раздела.