
simplesmente nós e grafos
Veja sua infraestrutura. Zero Config.
Aponte o graph-go para sua stack e obtenha um mapa interativo e ao vivo de cada banco de dados, tabela, serviço e bucket de armazenamento — com monitoramento de saúde em tempo real.
graph-go é um mapeador de infraestrutura CLI-first. Ele descobre automaticamente sua infraestrutura conectando-se ao daemon do Docker, inspecionando containers em execução e sondando bancos de dados e serviços de armazenamento. A UI é servida pelo backend e reflete o estado real do backend — nenhum inventário manual é necessário.
| Capacidade | Detalhes |
|---|---|
| Descoberta automática | Detecta infraestrutura a partir de containers Docker e clusters Kubernetes — nenhum inventário manual é necessário |
| Kubernetes | Namespaces, Deployments, StatefulSets, DaemonSets, Pods, Services — com observação em tempo real baseada em informers |
| Docker | Classifica containers em execução, extrai credenciais, observa eventos do Docker, respeita labels graphgo.* para sobrescrever tipo/DSN/node-type/nome ou ignorar um container |
| PostgreSQL | Tabelas, relacionamentos de chave estrangeira, topologia de schema |
| MongoDB | Bancos de dados e coleções |
| MySQL | Tabelas, relacionamentos de chave estrangeira |
| Redis | Keyspaces e distribuição de chaves |
| Elasticsearch | Índices, saúde do cluster, status de shards |
| S3 / MinIO | Buckets e prefixos de nível superior |
| Serviços HTTP | Endpoints de saúde, mapeamento de dependências entre serviços |
| Saúde em tempo real | Atualizações de status ao vivo via WebSocket a cada 5 segundos |
| Grafo interativo | Layout em swimlane, containers de agrupamento por namespace, pan/zoom, filtro por tipo/saúde, busca de nós |
O graph-go respeita um pequeno conjunto de labels graphgo.* de container (defina-as em qualquer container que você queira controlar):
| Label | Efeito |
|---|---|
graphgo.ignore=true | Ignora este container completamente |
graphgo.type=postgres | Força o tipo de adaptador (postgres, mongodb, mysql, redis, elasticsearch, s3, http) |
graphgo.dsn=... | Injeta uma string de conexão (DSN para postgres/mysql, URI para mongodb, caso contrário recorre a dsn) |
graphgo.node-type=gateway | Sobrescreve o tipo visual do nó (service, gateway, auth, api, queue, cache) |
graphgo.name=... | Sobrescreve o nome do nó exibido no grafo e usado em IDs de nó / logs |
Use estas labels para resgatar containers classificados incorretamente, apontar o graph-go para um DSN personalizado ou ocultar um container do grafo sem removê-lo.
Inicie a stack de demonstração pré-configurada com a CLI. Esta é a maneira mais rápida de ver o graph-go em um ambiente realista e o caminho de onboarding pretendido para usuários de primeira viagem:
git clone https://github.com/guilherme-grimm/graph-go.git
cd graph-go
go run ./cmd/app demo
Abra http://localhost:8080. O comando é executado de forma anexada via Docker Compose. Pressione Ctrl+C para interromper a sessão anexada.
A primeira execução pode levar vários minutos em uma máquina fria, pois o Docker pode precisar baixar imagens base e compilar as imagens de demonstração locais. As execuções seguintes são muito mais rápidas.
A stack de demonstração espera que estas portas do host estejam livres: 8080, 5432, 27017, 9000 e 9001.
Se você precisar de um encerramento explícito depois:
docker compose -f docker-compose.demo.yml down
Um contêiner, uma porta. Monte o socket do Docker como somente leitura e o graph-go descobre automaticamente tudo o que está em execução no host:
docker run -d -p 8080:8080 \
-v /var/run/docker.sock:/var/run/docker.sock:ro \
--group-add "$(stat -c %g /var/run/docker.sock)" \
ghcr.io/guilherme-grimm/graph-go:latest
A imagem é executada como um usuário não-root, portanto
--group-addconcede a ela o grupo do socket (stat -cé Linux; no macOS comece com--group-add 0). Se a descoberta do Docker ainda recorrer apenas ao YAML, o log de inicialização indica o que alterar (incluindo o valor exato de--group-addquando essa for a solução).O graph-go apenas lê da API do Docker (list, inspect, events). O
:ronão restringe chamadas à API, porém: qualquer coisa que consiga alcançar o socket pode controlar o daemon. Para privilégio mínimo, coloque um proxy de API somente leitura, como otecnativa/docker-socket-proxy, na frente do socket e aponte o graph-go para ele comDOCKER_HOST=tcp://<proxy>:2375(sem necessidade de montar o socket ou usar--group-add). Odocker-compose.demo.ymlmostra uma configuração funcional.
Abra http://localhost:8080. A descoberta automática lida com contêineres Docker e (quando um kubeconfig ou uma service account no cluster aponta para um cluster acessível) recursos do Kubernetes sem nenhum arquivo de configuração.
Para serviços que residem fora do Docker/Kubernetes (bancos de dados remotos, serviços de nuvem gerenciados), monte um arquivo de configuração — consulte Configuração.
Binário único e autocontido — a UI é embutida, mas o ponto de entrada continua sendo a CLI.
# Linux amd64 (requires the GitHub CLI; browse Releases for other platforms)
gh release download --repo guilherme-grimm/graph-go --pattern 'graph-go_*_linux_amd64.tar.gz' --clobber
tar xzf graph-go_*_linux_amd64.tar.gz
./graph-go serve # or just `./graph-go` - same thing
Abra http://localhost:8080. Outras plataformas na página de Releases.
| Comando | O que faz |
|---|---|
graph-go demo | Inicia a stack de demonstração Docker Compose pré-configurada a partir do repositório e transmite a sua saída em primeiro plano. |
graph-go serve | Inicia o servidor HTTP com descoberta automática e atualizações em tempo real (padrão - o mesmo que executar sem argumentos). Assim que a primeira descoberta termina, imprime uma linha ✓/✗ por adaptador em stderr, com o que encontrou ou porque falhou (omitido com --log-format json). |
graph-go scan | Executa a descoberta uma vez e emite o grafo para stdout. --format json (padrão) para encaminhar para jq ou verificações de CI; mermaid, markdown (Mermaid num bloco delimitado, renderiza no GitHub) ou dot (Graphviz) para diagramas. graph-go export é um alias. |
graph-go validate | Verifica o ficheiro de configuração e termina com código não-zero se for inválido. Reporta todos os campos em falta, tipos de ligação desconhecidos e chaves desconhecidas (que o serve ignora silenciosamente). Nenhum servidor é iniciado. |
graph-go mcp | Serve a topologia a agentes de IA através do Model Context Protocol (stdio). Ver Utilização com agentes de IA (MCP). |
graph-go version | Imprime a versão, o commit e a data de compilação. |
graph-go --health-check | Acede ao /health local e termina com 0/1. Usado pelo HEALTHCHECK do contentor; não é para uso interativo. |