Nesta página
Exportação/importação de configuração
Visão geral
A funcionalidade de exportação/importação do Zabbix torna possível trocar 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
- enviar um template para Zabbix Community templates. Então, 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
Os objetos que podem ser exportados/importados são:
- Host groups (somente por meio da Zabbix API)
- Template groups (somente por meio da Zabbix API)
- Templates
- Hosts
- Network maps
- Media types
- Imagens
Formato de exportação
Os dados podem ser exportados usando o web frontend do Zabbix ou a Zabbix API. 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.
- As entidades de host e template (items, triggers, gráficos, regras de descoberta) 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, modificação da expressão regular ou adição de protótipos à regra de descoberta de baixo nível) serão perdidas ao exportar; ao importar, todas as entidades dos templates vinculados são recriadas como no template vinculado original.
- As entidades criadas por descoberta de baixo nível e quaisquer entidades que dependam 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 contiver 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 da imagem por meio da importação.
- Ao importar hosts/templates usando a opção "Delete missing",
macros de host/template que não estiverem presentes no arquivo de importação serão excluídas do
host/template após a importação. - Tags vazias para items, triggers, graphs, discoveryRules, itemPrototypes, triggerPrototypes, graphPrototypes não têm significado, 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 uma extensão correta: .yaml e .yml para YAML, .xml para XML e .json para JSON. Consulte compatibility information sobre as versões de XML suportadas.
- A importação suporta arquivos de configuração somente em codificação UTF-8 (com ou sem BOM); outras codificações (UTF16LE, UTF16BE, UTF32LE, UTF32BE, etc.) resultarão em um erro de conversão na 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 de exportação
zabbix_export:
version: '8.0'
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
<?xml version="1.0" encoding="UTF-8"?>
<zabbix_export>
<version>8.0</version>
</zabbix_export>
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
{
"zabbix_export": {
"version": "8.0"
}
}
Outros objetos dependem dos objetos exportados.