Hosts

Resumen

Los hosts se exportan con muchos objetos relacionados y relaciones entre objetos.

La exportación de host contiene:

• Grupos de host vinculados
• Datos del host
• Vinculación de template
• Vinculación de grupo de host
• Interfaces del host
• Items vinculados directamente
• Triggers vinculados directamente
• Reglas de descubrimiento vinculadas directamente con todos los prototipos
• Escenarios web vinculados directamente
• Macros del host
• Datos de inventario del host
• Mapas de valores
• Gráficos vinculados

Exportación

Para exportar hosts, haga lo siguiente:

1. Vaya a Data collection > Hosts.
2. Marque las casillas de verificación de los hosts que desea exportar.
3. Haga clic en Export debajo de la lista.

Según el formato seleccionado, los hosts se exportan a un archivo local con un nombre predeterminado:

• zabbix_export_hosts.yaml - en exportación YAML (opción predeterminada para exportar);
• zabbix_export_hosts.xml - en exportación XML;
• zabbix_export_hosts.json - en exportación JSON.

Importación

Para importar hosts, haga lo siguiente:

1. Vaya a Data collection > Hosts.
2. Haga clic en Import en la esquina superior derecha.
3. Seleccione el archivo de importación.
4. Haga clic en Import en la esquina inferior derecha del formulario de configuración.

Si marca la casilla Advanced options, se mostrará una lista detallada de todos los elementos importables; marque o desmarque cada regla de importación según sea necesario.

Si hace clic en la casilla de la fila All, se marcarán o desmarcarán todos los elementos que estén debajo.

Reglas de importación:

En el frontend se mostrará un mensaje de éxito o de error de la importación.

Formato de exportación

Cuando se exporta un host, Zabbix genera un formato estructurado YAML, JSON o XML. La exportación incluye elementos del host, como metadatos del host, items, macros, triggers y más.

Cada elemento cumple una función específica y puede contener elementos anidados.

Las siguientes secciones describen cada elemento del formato de exportación. Los ejemplos usan un host con la template MySQL by Zabbix agent 2. Con fines de demostración de los elementos, la template se desvincula después de crear el host. Desvincular conserva todos los elementos en la configuración (a diferencia de desvincular y limpiar, que los elimina).

Una elipsis (...) indica elementos omitidos por brevedad. La nota (see table below) se usa cuando el elemento se explica con más detalle en secciones posteriores.

Metadatos del host

zabbix_export:
  version: '8.0'
  host_groups:
    - uuid: 748ad4d098d447d492bb935c907f652f
      name: Databases
  hosts: (see table below)
  graphs: (see table below)

Hosts

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 user password.'
        (...)
      valuemaps: (see table below)
  (...)

Interfaces del host

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

Items del host

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: 'Binlog cache disk use'
          type: DEPENDENT
          key: mysql.binlog_cache_disk_use
          value_type: FLOAT
          description: 'Número de transacciones que usaron una caché temporal en disco porque no cabían en la caché binaria de registro regular, al ser mayores que `binlog_cache_size`.'
          preprocessing: (see table below)
          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: 'Proporción de páginas usadas respecto al total en el buffer pool.'
          tags:
            - tag: component
              value: memory
          triggers: (see table below)
        (...)
        - name: Uptime
          type: DEPENDENT
          key: mysql.uptime
          units: uptime
          description: 'Número de segundos que el server ha estado en funcionamiento.'
          preprocessing: (see table below)
          master_item:
            key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          tags:
            - tag: component
              value: application
          triggers: (see table below)
        (...)

Pasos de preprocesamiento del valor del item del host

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
          (...)

Triggers de item del host

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 no ha recibido ningún dato para los items durante los últimos 30 minutos.'
              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: 'El tiempo de actividad de MySQL es inferior a 10 minutos.'
              tags:
                - tag: scope
                  value: notice
        (...)

Reglas de descubrimiento de bajo nivel de host

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
        (...)

Filtros de la regla de descubrimiento de bajo nivel de host

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
          (...)

Operaciones de anulación de reglas de descubrimiento de bajo nivel de host

Escenarios web del host

Pasos del escenario web del host

Gráficos de host

zabbix_export:
  (...)
  graphs:
    - name: 'MySQL: Bandwidth'
      graph_items: (see table below)
    (...)

Elementos del gráfico del host

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
    (...)

Mapas de valores del host

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

Notas al pie

¹ Los valores enteros de la API entre paréntesis, por ejemplo, ENABLED (0), se mencionan solo como referencia. Para obtener más información, consulte la página del objeto de API enlazada en la entrada de la tabla o al final de cada sección.