Relatórios do Agente no Portal Nyverra: relatórios no piloto automático

Existe uma ironia no mundo dos relatórios de TI: quanto mais úteis, mais trabalho dão. Coletar, montar, formatar e enviar — toda semana. O Agente de Relatórios do Portal Nyverra ITSM existe para transformar esse ciclo em uma operação automática, disparada por playbooks.

Este guia explica o que o módulo faz, como disparar e reexecutar relatórios e por que o histórico de execuções é essencial para confiar no processo.

Interface do módulo no Portal Nyverra ITSM.

O que é o Agente de Relatórios

É o componente do Portal que executa o trabalho dos relatórios: dispara um playbook (um roteiro de geração), monta os relatórios e registra cada execução. Em vez de uma pessoa clicar em “gerar”, o agente cuida do ciclo.

Conceito	O que é
Playbook	Roteiro que descreve o que o agente deve gerar
Execução	Uma rodada do agente (manual ou agendada)
Histórico	Registro das execuções e seus resultados

Para que serve no dia a dia

• Relatórios recorrentes: gerar, periodicamente, os mesmos conjuntos de dados.
• Distribuição: integrar-se aos relatórios agendados e enviar por e-mail.
• Reexecução: refazer uma geração que falhou, sem esperar o próximo ciclo.
• Visibilidade: acompanhar o que rodou, quando e com que resultado.

Recursos do módulo

Recurso	O que faz
Disparar playbook	Inicia uma execução do agente
Reexecutar	Repete uma geração específica
Histórico de execuções	Lista rodadas, status e resultados
Integração	Conecta-se aos relatórios agendados e ao histórico de relatórios

Quem usa

Perfil	Uso típico
Administrador	Configurar o agente e os playbooks
Gestor	Receber relatórios recorrentes automaticamente
Operação	Reexecutar gerações que falharam

Como usar: passo a passo

1. Configure o agente e os relatórios que ele deve produzir.
2. Dispare o playbook (ou deixe-o agendado).
3. Acompanhe as execuções no histórico do módulo.
4. Reexecute em caso de falha ou de necessidade pontual.
5. Combine com relatórios agendados para a rotina de distribuição.

Regras de negócio e cuidados

Ponto	Explicação
Falhas	Uma execução pode falhar (dados, permissão, integração) — monitore.
Reexecução	Útil para recuperar gerações sem esperar o próximo ciclo.
Dados	Os números refletem o banco no momento da execução.
Janela	Gerações pesadas devem rodar em horário de menor carga.

Boas práticas

• Monitore falhas para não deixar relatórios pendentes silenciosamente.
• Use reexecução para recuperar rapidamente uma geração com erro.
• Combine agente + relatórios agendados para automatizar a entrega.
• Programe execuções pesadas em janela de baixa carga.
• Mantenha um inventário de quais playbooks geram quais relatórios.

Erros comuns

Situação	O que fazer
Relatório não chegou	Verifique o histórico de execuções e a auditoria de entregas.
Execução falhou	Confira o erro e use a reexecução após corrigir.
Geração lenta	Reprograme para horário de menor carga.

Perguntas frequentes

O agente substitui os relatórios agendados?
Complementa: o agente gera; o agendamento distribui.

Posso reexecutar só um relatório?
Sim, pela ação de reexecução.

Como sei se rodou?
Pelo histórico de execuções do módulo.

Automatize via API

O agente é exposto por API (/api/report-agent e correlatos), permitindo disparar e monitorar execuções. Referência em developer.nyverra.com.

Cenários de uso: informação no piloto automático

1. Relatórios recorrentes. Toda segunda-feira, o playbook gera os relatórios da semana e o agendamento os entrega. O gestor começa o dia com informação, sem ninguém “montar” nada.

2. Recuperação de falha. Uma geração falha por erro de integração. Corrigido o problema, a reexecução refaz o relatório sem esperar o próximo ciclo.

3. Auditoria de execuções. O histórico mostra o que rodou, quando e com que resultado — útil para provar que relatórios obrigatórios foram gerados.

KPIs do agente

Indicador	O que revela
Execuções com sucesso vs falha	Confiabilidade do processo
Tempo médio de execução	Eficiência
Reexecuções necessárias	Estabilidade
Relatórios gerados por período	Cobertura da automação

Como operar bem o agente

Monitore as falhas — uma geração que falha em silêncio é um relatório que “sumiu”. Programe execuções pesadas em janela de baixa carga. Mantenha o inventário de quais playbooks geram quais relatórios. E combine com os relatórios agendados: o agente é a fábrica, o agendamento é a entrega. Juntos, eliminam o trabalho manual que costuma transformar “gestão de relatórios” em tempo perdido toda semana.

Checklist do agente

1. Configure os playbooks e relatórios.
2. Agende ou dispare manualmente.
3. Monitore o histórico de execuções.
4. Reexecute em caso de falha.
5. Programe cargas pesadas em baixa demanda.
6. Combine com relatórios agendados.

Perguntas frequentes adicionais

O agente substitui o agendamento?
Complementa: o agente gera; o agendamento distribui.

Como recupero uma geração que falhou?
Pela reexecução.

Onde vejo o resultado?
No histórico de execuções e no histórico de relatórios.

Conclusão

Com o Agente de Relatórios, o Portal Nyverra ITSM entrega informação no piloto automático. Menos tempo montando relatório, mais tempo usando o que ele revela — e um histórico que mostra, a cada execução, que o processo funcionou.