Além dos silos: a alma por trás do OSIRIS JSON
Por vinte anos, minha missão tem sido fechar a lacuna entre o conhecimento tribal isolado em silos e a clareza operacional. Evoluí da era manual de mapear topologias fragmentadas com extremo cuidado para construir uma solução que entrega um retrato abrangente, de ponta a ponta, do panorama da infraestrutura. Meu objetivo ao criar o OSIRIS JSON é simples: fornecer a visibilidade do panorama geral que capacita profissionais de IT e OT a tomar as decisões certas com confiança.
No mundo da infraestrutura, muitas vezes nos contentamos com fragmentos. Vemos um servidor aqui, uma instância em nuvem ali, um sensor de facility em outro lugar. Mas meu objetivo, não importa com quem e para quem eu tenha trabalhado, sempre foi alcançar uma visão de ponta a ponta de toda a infraestrutura, vendo como cada peça respira junto em um único mapa interconectado, por uma razão muito simples: atingir múltiplos objetivos:
- erradicar silos, pensamento feudal e contexto crítico que vive na cabeça das pessoas, adotando uma cultura de Documentation as Code (Docs as Code) baseada em padrões abertos
- oferecer uma maneira simples para que arquitetos e profissionais de IT/OT entendam a infraestrutura de ponta a ponta em um estado temporal atualizado
- permitir troubleshooting rápido mantendo uma documentação e topologia de infraestrutura claras e atualizadas
- permitir snapshots rápidas de ponta a ponta da infraestrutura sem complicações ou softwares de varredura de terceiros, tornando o OSIRIS JSON um grande aliado durante sessões de auditoria
- fornecer uma linha de base padronizada e precisa para LLMs, permitindo compreender o panorama da infraestrutura e oferecendo reasoning e automação aprimorados
O lado humano da luta na infraestrutura
Em dezembro de 2025, com uma grande ambição e um pouco de loucura, comecei a escrever a Especificação OSIRIS JSON. Ela é o resultado da experiência adquirida ao viajar, explorar, manter conversas com Senior Managers e profissionais de IT/OT, mas também ao me aproximar e trabalhar com operários de fábrica e seus gerentes, com quem tive uma grande oportunidade de aprender sobre diferentes contextos que me enriqueceram pessoalmente e ajudaram a moldar a ideia original, ao ter a oportunidade de ver e entender que esse tipo de organização e visibilidade fazia falta não apenas na área de Information Technology, mas também no lado OT sob sistemas de facility ou em cenários cruzados, e até mesmo ao projetar, manter e, às vezes, falhar dentro de stacks heterogêneos, desde nuvens públicas hyperscale até as complexas e duras interseções entre IT e Facility OT.
Ao longo dessa jornada, encontrei um problema recorrente e profundamente humano: a intransponível montanha do conhecimento tribal. Algumas frases que todos nós já ouvimos: Oh, não mexa nisso por favor, sabemos que está desatualizado, mas foi o Oscar que fez e ele saiu da empresa! Documentação não é importante, vamos focar nas necessidades do negócio ou a falsa crença de que está tudo bem Todos os serviços estão perfeitamente configurados no Microsoft Azure, não há nada com que se preocupar. Ou você é chamado para uma reunião de aprovação ARM ou SBB e alguém desenha algumas linhas no Microsoft Paint para representar a topologia buscando aprovação imediata porque os stakeholders estão com pressa! Algumas semanas depois, quando você é chamado para analisar com operations uma grande indisponibilidade, descobre que alguém configurou algo errado na arquitetura do sistema e você não sabe por onde começar o troubleshooting porque não existe documentação ou topologia precisa. Todos nós tivemos ou temos um Oscar na organização.
Lutamos contra silos corporativos que fazem uma visão unificada parecer quase impossível! Construímos integrações sob medida e frágeis que quebram no momento em que um fornecedor muda de ideia, e sabemos que especialmente em IT isso acontece com regularidade.
Mesmo em cenários em que produzi documentação rigorosa, a presença de silos entre equipes frequentemente significava que a “verdade” da infraestrutura permanecia oculta ou fragmentada. Percebi que, se não conseguimos ver o nosso mundo, não conseguimos realmente cuidar dele tomando as decisões certas com confiança.
Acredito firmemente que a clareza da infraestrutura de sistemas NÃO DEVE depender de quem você é, de quem você conhece ou de qual departamento você faz parte. Ela é e DEVE ser uma verdade compartilhada que pertence a todos. - Tia Zanella - Founder and Lead Maintainer of OSIRIS JSON
O que é o OSIRIS JSON?
OSIRIS JSON é um esquema de intercâmbio JSON vendor-neutral projetado para ser uma linguagem universal para topologia de infraestrutura, pensado para incluir ambientes de IT e OT.
Em vez de desperdiçar tempo e dinheiro desenvolvendo cada integração de software do zero para aprender uma centena de dialetos específicos de fornecedores, o OSIRIS JSON separa as responsabilidades:
- Os produtores de OSIRIS JSON traduzem os dados bagunçados e fragmentados do mundo real em um documento OSIRIS JSON limpo.
- Os consumidores de OSIRIS JSON leem esse documento para fornecer uma visão clara, pontual no tempo, do que existe e de como tudo se relaciona. Com o documento OSIRIS JSON, os consumidores podem produzir topologias, diff, documentação automatizada de alta qualidade e muito mais.
Um primeiro passo humilde
Nesta primeira versão, o OSIRIS JSON é intencionalmente um formato de snapshot estática. Ele é uma “polaroid digital” da sua infraestrutura em um momento no tempo. Você pode executá-lo diretamente do seu notebook ou, em cenários complexos, delegá-lo a uma automação para produzir resultados agendados. Ele não tenta fazer tudo de uma vez, mas fornece algo essencial: uma base consistente. Ao definir como os recursos e seus relacionamentos são documentados independentemente das fronteiras entre equipes ou do vendor lock-in. Em uma cultura de comunidade aberta, damos o primeiro passo rumo a esse sonho de ponta a ponta.
OSIRIS JSON é mais do que código; é um compromisso perseverante com transparência, documentação de alta qualidade e a firme convicção de que até os sistemas mais complexos podem ser compreendidos se usarmos os óculos certos.