Automação¶
A página Automação traz o catálogo de runbooks Ansible e o histórico de execuções.

Runbooks disponíveis¶
| Runbook | Chave | Alvo | Risco | Aprovação (padrão) | O que faz |
|---|---|---|---|---|---|
| Abrir chamado no ITSM | open_ticket |
qualquer / achado | baixo | não | cria incidente no ServiceNow (Table API) com título, detalhe e recomendação do achado. Usa o primeiro canal de alerta ServiceNow habilitado |
| Coletar logs de suporte do switch | collect_supportsave |
switch | baixo | não | Brocade: supportsave para o destino supportftp do switch. Cisco: show tech-support details salvo no volume de automação |
| Implantar coletor remoto | deploy_collector |
— (host informado) | médio | sim | instala Docker e o container coletor via SSH, gerando um novo token para o coletor escolhido |
| Reiniciar porta de switch (disable/enable) | port_toggle |
porta de switch | alto | sempre | Brocade (REST) ou Cisco (NX-API), com espera configurável. Interrompe o tráfego da porta |
| Rescan de HBAs no ESXi | rescan_host_paths |
hipervisor | médio | sim | esxcli storage core adapter rescan --all via SSH no host (requer SSH habilitado no ESXi) |
| Zerar contadores de erro da porta | clear_port_counters |
porta de switch | baixo | sim | zera estatísticas para confirmar se os erros persistem após manutenção |
Quem tem automation.manage pode ativar/desativar cada runbook e mudar a exigência de
aprovação (exceto nos de risco alto, que sempre exigem).
Solicitar (permissão automation.request)¶
- Pelo catálogo (Executar) ou pelo detalhe de um insight (Runbooks aplicáveis), que já preenche o objeto alvo e o achado.
- Preencha os parâmetros (gerados a partir do runbook) e confirme. Sem aprovação, o botão diz Executar runbook e a execução entra direto na fila. Com aprovação, diz Solicitar execução e fica Aguardando aprovação.
Aprovar (permissão automation.approve)¶
Na aba Execuções, filtre Aguardando aprovação, revise o runbook, o alvo e os parâmetros e clique em Aprovar ou Rejeitar (comentário opcional, por exemplo número da mudança ou janela). O solicitante não pode aprovar a própria execução (segregação de funções), exceto superadministradores.
Acompanhar¶
Estados: Aguardando aprovação → Aprovada → Em execução → Concluída ou Falha (ou Rejeitada). A execução mostra a saída do Ansible (até 200 mil caracteres), o código de retorno, quem solicitou e quem aprovou. Execuções com sucesso a partir de um achado adicionam uma nota ao achado. Tudo é registrado na auditoria.
Regras de alerta também podem solicitar um runbook automaticamente
(Alertas). Essas execuções aparecem com solicitante
regra:<nome> e respeitam a exigência de aprovação.