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 para exportar en el formato YAML predeterminado, o haga clic en la flecha para seleccionar un formato de exportación diferente.

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

• zabbix_export_hosts.yaml - en la exportación YAML;
• zabbix_export_hosts.xml - en la exportación XML;
• zabbix_export_hosts.json - en la exportación JSON.

Importación

Para importar hosts, siga estos pasos:

1. Vaya a Recopilación de datos > Hosts.
2. Haga clic en Importar en la esquina superior derecha.
3. Seleccione el archivo de importación.
4. Marque las casillas de las reglas de importación que desea aplicar (consulte más abajo).
5. Haga clic en Importar en la esquina inferior derecha del formulario de configuración.

Si marca la casilla Opciones avanzadas, se mostrará una lista detallada de todos los elementos que se pueden importar; marque o desmarque cada regla de importación según sea necesario.

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

Reglas de importación:

No puede revisar los cambios realizados en los hosts durante la 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 de host

zabbix_export:
  (...)
  hosts:
    - host: 'MySQL server'
      (...)
      items:
        (...)
        - name: 'Uso de disco de la caché del binlog'
          type: DEPENDENT
          key: mysql.binlog_cache_disk_use
          value_type: FLOAT
          description: 'Número de transacciones que utilizaron una caché de disco temporal porque no cabían en la caché normal del registro binario, al ser mayores que `binlog_cache_size`.'
          preprocessing: (consulte la tabla siguiente)
          master_item:
            key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          tags:
            - tag: component
              value: cache
        (...)
        - name: 'Utilización del pool de búferes'
          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 utilizadas respecto al total de páginas del pool de búferes.'
          tags:
            - tag: component
              value: memory
          triggers: (consulte la tabla siguiente)
        (...)
        - name: Tiempo de actividad
          type: DEPENDENT
          key: mysql.uptime
          units: uptime
          description: 'Número de segundos que el server ha estado activo.'
          preprocessing: (consulte la tabla siguiente)
          master_item:
            key: 'mysql.get_status_variables["{$MYSQL.DSN}","{$MYSQL.USER}","{$MYSQL.PASSWORD}"]'
          tags:
            - tag: component
              value: application
          triggers: (consulte la tabla siguiente)
        (...)

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.