Table of Contents
14 Exportação/importação de configuração
Visão geral
A funcionalidade de exportação/importação do Zabbix possibilita a troca de várias entidades de configuração entre um sistema Zabbix e outro.
Casos de uso típicos para essa funcionalidade:
- compartilhar templates ou mapas de rede - os usuários do Zabbix podem compartilhar seus parâmetros de configuração
- fazer upload de um template para o Zabbix Community templates. Assim, outros podem baixar o template e importar o arquivo para o Zabbix.
- integrar com ferramentas de terceiros - os formatos universais YAML, XML e JSON tornam possível a integração e a importação/exportação de dados com ferramentas e aplicativos de terceiros
O que pode ser exportado/importado
Objetos que podem ser exportados/importados são:
- Grupos de hosts (apenas através da Zabbix API)
- Grupos de templates (apenas através da Zabbix API)
- Templates
- Hosts
- Mapas de rede
- Tipos de mídia
- Imagens
Formato de exportação
Os dados podem ser exportados usando o frontend web do Zabbix ou a API do Zabbix. Os formatos de exportação suportados são YAML, XML e JSON.
Detalhes sobre a exportação
- Todos os elementos suportados são exportados em um único arquivo.
- Entidades de host e template (itens, triggers, gráficos, regras de descoberta) que são herdadas de templates vinculados não são exportadas. Quaisquer alterações feitas nessas entidades no nível do host (como alteração do intervalo do item, expressão regular modificada ou protótipos adicionados à regra de descoberta de baixo nível) serão perdidas ao exportar; ao importar, todas as entidades dos templates vinculados são recriadas conforme no template original vinculado.
- Entidades criadas por descoberta de baixo nível e quaisquer entidades dependentes delas não são exportadas. Por exemplo, um trigger criado para um item gerado por uma regra LLD não será exportado.
- Quando o host/template exportado contém entidades que suportam timeouts, os valores de timeout serão exportados se essas entidades tiverem seus próprios timeouts configurados.
Detalhes sobre a importação
- A importação é interrompida no primeiro erro.
- Ao atualizar imagens existentes durante a importação de imagens, o campo "imagetype" é ignorado, ou seja, não é possível alterar o tipo de imagem via importação.
- Ao importar hosts/templates usando a opção "Excluir ausentes", macros de host/template que não estejam presentes no arquivo de importação serão excluídas do host/template após a importação.
- Tags vazias para items, triggers, gráficos, discoveryRules, itemPrototypes, triggerPrototypes, graphPrototypes são irrelevantes, ou seja, é o mesmo que se estivessem ausentes.
- Se as entidades do host/template importado tiverem seus próprios timeouts configurados, eles serão aplicados; caso contrário, os timeouts do proxy/global serão aplicados.
- A importação suporta YAML, XML e JSON, o arquivo de importação deve ter a extensão correta: .yaml e .yml para YAML, .xml para XML e .json para JSON. Veja informações de compatibilidade sobre as versões de XML suportadas.
- A importação suporta arquivos de configuração apenas na codificação UTF-8 (com ou sem BOM); outras codificações (UTF16LE, UTF16BE, UTF32LE, UTF32BE, etc.) resultarão em erro de conversão de importação.
Formato base YAML
O formato de exportação YAML contém os seguintes nós:
- Nó raiz para exportação YAML do Zabbix
- Versão da exportação
Outros nós dependem dos objetos exportados.
Formato XML
O formato de exportação XML contém as seguintes tags:
- Cabeçalho padrão para documentos XML
- Tag raiz para exportação XML do Zabbix
- Versão da exportação
Outras tags dependem dos objetos exportados.
Formato JSON
O formato de exportação JSON contém os seguintes objetos:
- Objeto raiz para exportação JSON do Zabbix
- Versão da exportação
Outros objetos dependem dos objetos exportados.