4 Узлы сети

Обзор

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

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

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

Экспорт

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

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

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

• 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. Для демонстрации элементов шаблон отвязывается после создания узла сети. Отвязка сохраняет все элементы в конфигурации (в отличие от отвязки с очисткой, которая удаляет их).

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

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

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

Узлы сети

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      name: 'MySQL server'
      groups:
        - name: Databases
      interfaces: (см. таблицу ниже)
      items: (см. таблицу ниже)
      discovery_rules: (см. таблицу ниже)
      tags:
        - tag: location
          value: Riga
      macros:
        (...)
        - macro: '{$MYSQL.DSN}'
          value: 192.0.2.0
        (...)
        - macro: '{$MYSQL.PASSWORD}'
          type: SECRET_TEXT
          description: 'Пароль пользователя MySQL.'
        (...)
      valuemaps: (см. таблицу ниже)
  (...)

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

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

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

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: 'Binlog cache disk use'
          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: 'Buffer pool utilization'
          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: Uptime
          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: Failed to fetch info data'
              event_name: 'MySQL: Failed to fetch info data (or no data for 30m)'
              priority: INFO
              description: 'Zabbix has not received any data for items for the last 30 minutes.'
              dependencies:
                - name: 'MySQL: Service is down'
                  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: Service has been restarted'
              event_name: 'MySQL: Service has been restarted (uptime < 10m)'
              priority: INFO
              description: 'MySQL uptime is less than 10 minutes.'
              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: (see table below)
          description: 'Scanning databases in DBMS.'
          interface_ref: if1
          item_prototypes:
            - name: 'Size of database {#DATABASE}'
              key: 'mysql.db.size["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}","{#DATABASE}"]'
              delay: 5m
              units: B
              description: 'Database size.'
              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: 'Обнаружение баз данных'
          (...)
          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: Пример карты значений
          mappings:
            - value: '1'
              newvalue: Пример значения
  (...)

Сноски

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