[comment]: # ({b7726307-b7726307})
# 14 Relatórios agendados
[comment]: # ({/b7726307-b7726307})
[comment]: # ({565fa10d-ebee5a26})
#### Visão geral
Com o recurso *Relatórios agendados*, você pode configurar o envio de uma versão em PDF de um determinado dashboard para destinatários especificados em intervalos recorrentes.
{width="600"}
Pré-requisitos:
- O serviço web do Zabbix deve estar instalado e configurado corretamente para permitir a geração de relatórios agendados - consulte [Configurando relatórios agendados](/manual/appendix/install/web_service) para instruções.
- Um usuário deve ter uma [função de usuário](/manual/web_interface/frontend_sections/users/user_roles) do tipo *Admin* ou *Super admin* com as seguintes permissões:
- *Relatórios agendados* no bloco *Acesso aos elementos da interface* (para visualizar as configurações do relatório)
- *Gerenciar relatórios agendados* no bloco *Acesso às ações* (para criar/editar relatórios)
Para criar um relatório agendado no frontend do Zabbix, faça o seguinte:
- Vá para: *Relatórios* > *Relatórios agendados*.
- Clique em *Criar relatório* no canto superior direito da tela.
- Insira os parâmetros do relatório no formulário.
Você também pode criar um relatório abrindo um já existente, clicando no botão *Clonar* e, em seguida, salvando-o com um nome diferente.
[comment]: # ({/565fa10d-ebee5a26})
[comment]: # ({b5bcc454-3569c870})
#### Configuração
A aba *Relatórios agendados* contém os atributos gerais do relatório.
{width="600"}
Todos os campos obrigatórios estão marcados com um asterisco vermelho.
|Parâmetro|Descrição|
|--|--------|
|*Proprietário*|Usuário que cria o relatório. Usuários com nível *Super admin* podem alterar o proprietário. Para usuários com nível *Admin*, este campo é somente leitura.|
|*Nome*|Nome do relatório; deve ser único.|
|*Dashboard*|Dashboard no qual o relatório é baseado; apenas um dashboard pode ser selecionado por vez. Para selecionar um dashboard, comece a digitar o nome - uma lista de dashboards correspondentes aparecerá; role para baixo para selecionar. Alternativamente, você pode clicar em *Selecionar* ao lado do campo e selecionar um dashboard da lista exibida.|
|*Período*|Período de tempo para o qual o relatório será preparado. Selecione o dia, semana, mês ou ano anterior.|
|*Ciclo*|Frequência de geração do relatório. Os relatórios podem ser enviados diariamente, semanalmente, mensalmente ou anualmente. O modo "Semanal" permite selecionar os dias da semana em que o relatório será enviado.|
|*Hora de início*|Hora do dia no formato hh:mm em que o relatório será preparado. Observe que será usado o fuso horário do Zabbix server.|
|*Repetir em*|Dias da semana em que o relatório será enviado. Este campo está disponível apenas se o *Ciclo* estiver definido como "Semanal".|
|*Data de início*|Data em que a geração regular do relatório deve ser iniciada.|
|*Data de término*|Data em que a geração regular do relatório deve ser interrompida.|
|*Assunto*|Assunto do e-mail do relatório. Suporta a macro {TIME}.|
|*Mensagem*|Corpo do e-mail do relatório. Suporta a macro {TIME}.|
|*Assinaturas*|Lista de destinatários do relatório. Por padrão, inclui apenas o proprietário do relatório. Qualquer usuário do Zabbix com mídia de e-mail configurada pode ser especificado como destinatário do relatório.
Clique em *Adicionar usuário* ou *Adicionar grupo de usuários* para adicionar mais destinatários.
Clique no nome de usuário para editar as configurações:
*Gerar relatório por* - se os dados do relatório devem ser gerados com base nas permissões do dashboard do usuário atual ou do destinatário.
*Status* - selecione "Incluir" para enviar o relatório ao usuário ou "Excluir" para impedir o envio do relatório a esse usuário. Pelo menos um usuário deve ter o status "Incluir". O status "Excluir" pode ser usado para excluir usuários específicos de um grupo de usuários que está incluído.
Observe que usuários com permissões insuficientes (ou seja, usuários com uma função baseada no tipo de usuário *Admin* que não são membros do mesmo grupo de usuários que o destinatário ou proprietário do relatório) verão "Usuário inacessível" ou "Grupo de usuários inacessível" em vez dos nomes reais nos campos *Destinatário* e *Gerar relatório por*; os campos *Status* e *Ação* serão exibidos como somente leitura.|
|*Habilitado*|Status do relatório. Desmarcar esta caixa desabilitará o relatório.|
|*Descrição*|Uma descrição opcional do relatório. Esta descrição é para uso interno e não será enviada aos destinatários do relatório.|
[comment]: # ({/b5bcc454-3569c870})
[comment]: # ({6a8c7767-85d102d6})
##### Botões do formulário
Os botões na parte inferior do formulário permitem realizar várias operações.
| | |
|--|--------|
||Adicionar um relatório. Este botão está disponível apenas para novos relatórios.|
||Atualizar as propriedades de um relatório.|
||Criar outro relatório com base nas propriedades do relatório atual.|
||Testar se a configuração do relatório está correta enviando um relatório para o usuário atual.|
||Excluir o relatório.|
||Cancelar a edição das propriedades do relatório.|
[comment]: # ({/6a8c7767-85d102d6})
[comment]: # ({49ae1620-89bf58f3})
##### Testando
Para testar um relatório, clique no botão *Test* na parte inferior do formulário de configuração do relatório.
::: noteclassic
O botão *Test* não está disponível se o formulário de configuração do relatório tiver sido aberto a partir do [menu de ações](/manual/web_interface/frontend_sections/dashboards#viewing-and-editing-a-dashboard) do dashboard.
:::
Se a configuração estiver correta, o relatório de teste será enviado imediatamente ao usuário atual.
Para relatórios de teste, os assinantes e as configurações de usuário de *Generate report by* são ignorados.
Se a configuração estiver incorreta, será exibida uma mensagem de erro descrevendo a possível causa.
[comment]: # ({/49ae1620-89bf58f3})
[comment]: # ({af04cf0d-f360cc6f})
##### Atualizando um relatório
Para atualizar um relatório existente, clique no nome do relatório, faça as alterações de configuração necessárias e clique no botão *Atualizar*.
Se um relatório existente for atualizado por outro usuário e esse usuário alterar o Dashboard, ao clicar no botão *Atualizar*, será exibida uma mensagem de aviso "O relatório gerado por outros usuários será alterado para o usuário atual".
Clicar em *OK* nesta etapa levará às seguintes alterações:
- As configurações de *Gerar relatório por* serão atualizadas para exibir o usuário que editou o relatório por último (a menos que *Gerar relatório por* esteja definido para o destinatário).
- Usuários que foram exibidos como "Usuário inacessível" ou "Grupo de usuários inacessível" serão excluídos da lista de assinantes do relatório.
Clicar em *Cancelar* fechará o formulário de configuração e cancelará a atualização do relatório.
[comment]: # ({/af04cf0d-f360cc6f})
[comment]: # ({ada09629-58eab3c1})
##### Clonando um relatório
Para clonar rapidamente um relatório existente, clique no botão *Clonar* na parte inferior de um formulário de configuração de relatório existente.
Ao clonar um relatório criado por outro usuário, o usuário atual se torna o proprietário do novo relatório.
As configurações do relatório serão copiadas para o novo formulário de configuração do relatório, respeitando as permissões do usuário:
- Se o usuário que clona um relatório não tiver permissões para um dashboard, o campo *Dashboard* será limpo.
- Se o usuário que clona um relatório não tiver permissões para alguns usuários ou grupos de usuários na lista de *Assinaturas*, os destinatários inacessíveis não serão clonados.
- As configurações de *Gerar relatório por* serão atualizadas para exibir o usuário atual (a menos que *Gerar relatório por* esteja definido para o destinatário).
Altere as configurações necessárias e o nome do relatório e clique em *Adicionar*.
[comment]: # ({/ada09629-58eab3c1})