Documentação de TI: Como Organizar a da Sua Empresa

Por Que a Falta de Documentação de TI é um Risco Operacional

Toda empresa tem aquele profissional que "sabe tudo": conhece a senha do firewall, lembra qual servidor roda o ERP, sabe que o backup do sistema fiscal precisa ser reiniciado manualmente na primeira segunda-feira do mês. Enquanto essa pessoa está presente, tudo funciona. O problema aparece quando ela tira férias, sai da empresa ou simplesmente não atende o telefone às 22h de um domingo, quando o sistema caiu.

Esse cenário — chamado de "bus factor 1" no jargão técnico — significa que uma única pessoa carrega conhecimento crítico que não existe em nenhum outro lugar. Segundo levantamentos do setor, a maior parte do tempo gasto em incidentes de TI não é resolvendo o problema, mas descobrindo como o ambiente foi configurado. Sem documentação, cada incidente vira uma investigação arqueológica: descobrir qual IP responde por qual serviço, quem tem acesso a quê, qual foi a última alteração feita no ambiente.

O custo dessa desorganização é mensurável. Downtime prolongado por falta de informação, retrabalho em configurações já feitas antes, dificuldade de auditoria em processos de conformidade (LGPD, ISO 27001), impossibilidade de terceirizar ou escalar o suporte. Documentação de TI não é burocracia — é o que transforma conhecimento individual em ativo da empresa.

Se o seu ambiente de TI só pode ser mantido por quem o construiu, você não tem infraestrutura: tem dependência.

O Que Documentar: Os Sete Pilares Essenciais

Documentar tudo é impossível e contraproducente — documentação excessiva envelhece rápido e ninguém lê. O caminho é priorizar o que tem impacto direto na continuidade operacional. Na prática, sete categorias cobrem a maior parte das necessidades de uma empresa de médio porte.

1. Inventário de ativos — todos os equipamentos físicos e virtuais: servidores, desktops, notebooks, switches, firewalls, nobreaks, impressoras. Registre modelo, número de série, data de aquisição, garantia, localização física e responsável.
2. Inventário de rede — topologia, faixas de IP, VLANs, regras de firewall relevantes, links de internet (operadora, banda, contrato, contato de suporte), VPNs site-to-site e configurações de DNS.
3. Mapa de sistemas e aplicações — qual software roda onde, quais são as dependências entre eles, versões, licenças, datas de renovação e fornecedor responsável.
4. Runbooks operacionais — procedimentos passo a passo para tarefas recorrentes e para recuperação de falhas: como restaurar um backup, como reiniciar um serviço travado, como liberar acesso a um novo colaborador.
5. Gestão de acessos — quem tem permissão em quê, grupos do Active Directory, contas privilegiadas, contas de serviço e política de rotação de credenciais.
6. Política e rotina de backup — o que é copiado, com que frequência, para onde, tempo de retenção e — o item mais esquecido — a data do último teste de restauração bem-sucedido.
7. Contatos e contratos — fornecedores, provedores de nuvem, suporte de software, número de contrato, SLA acordado e canal correto de abertura de chamado.

Uma regra prática ajuda a decidir o que entra: se a informação for necessária às 3h da manhã durante uma parada crítica e não estiver na cabeça de quem está de plantão, ela precisa estar documentada.

Runbook: O Documento Que Mais Economiza Tempo

Entre todos os artefatos, o runbook é o que gera retorno mais rápido. Ele descreve, em linguagem operacional, como executar um procedimento específico do início ao fim — sem depender de interpretação. Um bom runbook permite que um técnico que nunca viu aquele ambiente consiga executar a tarefa corretamente.

A estrutura mínima de um runbook eficaz tem cinco partes: objetivo (o que este procedimento resolve), pré-requisitos (acessos, ferramentas e janelas necessárias), passos numerados (comandos exatos, caminhos de menu, valores esperados), validação (como confirmar que funcionou) e rollback (o que fazer se der errado). Evite frases como "configure adequadamente" — escreva o valor exato, o caminho exato, o comando exato.

Comece pelos runbooks de maior frequência ou maior impacto: restauração de backup, onboarding e offboarding de colaborador, procedimento de failover de link de internet, reinício ordenado de servidores após queda de energia, e resposta a suspeita de ransomware. Cinco runbooks bem escritos valem mais que cinquenta páginas de manual genérico.

Um detalhe frequentemente ignorado: o runbook precisa estar acessível quando o ambiente está fora do ar. Documentação hospedada exclusivamente em um servidor interno que caiu junto com o resto da infraestrutura é inútil no momento em que mais se precisa dela. Mantenha cópia offline ou em serviço externo à sua rede.

Ferramentas: Da Planilha ao Sistema Dedicado

Não existe ferramenta única correta — existe a ferramenta que a equipe efetivamente usa. Ambientes pequenos frequentemente começam com uma pasta estruturada no SharePoint ou OneDrive e planilhas de inventário. Funciona, desde que exista disciplina de atualização. O erro é escolher uma plataforma sofisticada demais para o tamanho da operação: complexidade excessiva leva ao abandono.

• Base de conhecimento — SharePoint/Microsoft 365, Confluence, Notion, BookStack ou wikis em Markdown versionadas em Git. Priorize busca rápida, controle de versão e permissionamento por grupo.
• Documentação de TI dedicada — Hudu, ITGlue, IT Portal. Trazem estrutura pronta para ativos, relacionamentos, senhas e runbooks. Custo por técnico é maior, mas eliminam a criação de padrão do zero.
• Inventário automatizado — GLPI com agente FusionInventory, Lansweeper, Snipe-IT ou Microsoft Intune/Endpoint Manager. Descobrem e atualizam ativos sozinhos, evitando a defasagem de inventário manual.
• Gestão de credenciais — cofre dedicado com criptografia e auditoria de acesso. Senha nunca deve viver em planilha, e-mail ou documento de texto compartilhado.
• Monitoramento como fonte de verdade — Zabbix, PRTG ou similar. O inventário do monitoramento revela divergências entre o documentado e o real.
• Diagramas — draw.io, Lucidchart ou Visio. Um diagrama de topologia de rede atualizado responde em segundos perguntas que levariam horas de investigação.

Independentemente da escolha, dois critérios são inegociáveis: controle de acesso granular (nem todo mundo precisa ver tudo, especialmente credenciais) e histórico de alterações, para saber quem mudou o quê e quando.

Como Manter a Documentação Viva

Documentação desatualizada é pior que ausência de documentação: ela induz a erro. Um técnico que segue um runbook com IP antigo pode derrubar o serviço errado. Por isso, o desafio real não é criar a documentação — é sustentá-la. E isso só acontece quando a atualização deixa de ser tarefa extra e vira parte do fluxo de trabalho.

O mecanismo mais eficaz é atrelar a documentação ao chamado. Nenhuma mudança é encerrada sem que o registro correspondente seja atualizado — o campo de "documentação atualizada" faz parte do fechamento do ticket, não de um mutirão trimestral. Complementando, vale definir revisões periódicas por criticidade: itens críticos (backup, acessos privilegiados, contatos de emergência) revisados trimestralmente; o restante, semestralmente.

Outras práticas que sustentam o ciclo:

• Definir um responsável nominal por cada documento — o que não tem dono não é atualizado.
• Registrar data da última revisão e do próximo vencimento em cada página, visível no topo.
• Automatizar tudo que for automatizável: inventário via agente, topologia via descoberta de rede, exportação de configurações de equipamentos via script.
• Testar a documentação na prática — pedir que outro técnico execute o runbook sem ajuda. Onde ele travar, o documento está incompleto.
• Usar o onboarding de novos colaboradores como auditoria natural: cada dúvida que não é respondida pela base indica lacuna a preencher.

Documentação boa não é a mais completa: é a que está correta no dia em que alguém precisa dela.

Documentação Como Parte da Gestão de TI

Estruturar documentação exige método e, principalmente, continuidade. Muitas empresas iniciam o processo com energia, produzem material relevante nas primeiras semanas e abandonam quando a rotina operacional aperta. É justamente aí que o suporte especializado faz diferença: um parceiro de TI mantém o inventário atualizado, escreve os runbooks conforme os incidentes acontecem e garante que o conhecimento fique registrado na empresa — não na memória de um indivíduo.

Na Duk Informática & Cloud, documentação faz parte do serviço desde o primeiro dia de contrato. São mais de 18 anos de experiência e 550+ empresas atendidas, com inventário de ativos, mapeamento de rede, runbooks operacionais e gestão de credenciais mantidos de forma contínua. Como Microsoft Gold Partner, integramos a documentação ao ecossistema Microsoft 365 e Intune que a maioria dos clientes já utiliza, evitando ferramentas paralelas e custos adicionais.

O resultado prático aparece nos momentos de crise: quando um servidor cai, o procedimento de recuperação já está escrito e testado; quando um colaborador sai, os acessos são revogados a partir de uma lista existente, não de uma investigação; quando chega uma auditoria de conformidade, as evidências estão organizadas. Se a sua TI hoje depende da memória de alguém, o primeiro passo é mapear o que existe — e a partir daí, transformar conhecimento em processo.