
Semplicemente nodi e grafi
Visualizza la tua infrastruttura. Zero Config.
Punta graph-go al tuo stack e ottieni una mappa interattiva e in tempo reale di ogni database, tabella, servizio e bucket di storage — con monitoraggio dello stato in tempo reale.
graph-go è un infrastructure mapper pensato per la CLI. Rileva automaticamente la tua infrastruttura connettendosi al daemon Docker, ispezionando i container in esecuzione e sondando database e servizi di storage. L'interfaccia è servita dal backend e riflette lo stato reale del backend — nessun inventario manuale necessario.
| Funzionalità | Dettagli |
|---|---|
| Rilevamento automatico | Rileva l'infrastruttura dai container Docker e dai cluster Kubernetes — nessun inventario manuale necessario |
| Kubernetes | Namespace, Deployment, StatefulSet, DaemonSet, Pod, Service — con osservazione in tempo reale basata su informer |
| Docker | Classifica i container in esecuzione, estrae le credenziali, osserva gli eventi Docker, rispetta le etichette graphgo.* per sovrascrivere tipo/DSN/tipo di nodo/nome o ignorare un container |
| PostgreSQL | Tabelle, relazioni di chiave esterna, topologia dello schema |
| MongoDB | Database e collezioni |
| MySQL | Tabelle, relazioni di chiave esterna |
| Redis | Keyspace e distribuzione delle chiavi |
| Elasticsearch | Indici, stato del cluster, stato degli shard |
| S3 / MinIO | Bucket e prefissi di primo livello |
| Servizi HTTP | Endpoint di stato, mappatura delle dipendenze tra servizi |
| Stato in tempo reale | Aggiornamenti di stato live via WebSocket ogni 5 secondi |
| Grafo interattivo | Layout a corsie, contenitori di gruppo per namespace, pan/zoom, filtro per tipo/stato, ricerca dei nodi |
graph-go rispetta un piccolo insieme di etichette graphgo.* sui container (impostale su qualsiasi container che vuoi controllare):
| Etichetta | Effetto |
|---|---|
graphgo.ignore=true | Salta completamente questo container |
graphgo.type=postgres | Forza il tipo di adapter (postgres, mongodb, mysql, redis, elasticsearch, s3, http) |
graphgo.dsn=... | Inietta una stringa di connessione (DSN per postgres/mysql, URI per mongodb, altrimenti ricade su dsn) |
graphgo.node-type=gateway | Sovrascrive il tipo visivo del nodo (service, gateway, auth, api, queue, cache) |
graphgo.name=... | Sovrascrive il nome del nodo mostrato nel grafo e usato negli ID dei nodi / nei log |
Usale per recuperare container classificati erroneamente, puntare graph-go a un DSN personalizzato o nascondere un container dal grafo senza rimuoverlo.
Avvia lo stack demo precompilato con la CLI. Questo è il modo più rapido per vedere graph-go in un ambiente realistico e il percorso di onboarding previsto per gli utenti alle prime armi:
git clone https://github.com/guilherme-grimm/graph-go.git
cd graph-go
go run ./cmd/app demo
Apri http://localhost:8080. Il comando viene eseguito in modalità attached tramite Docker Compose. Premi Ctrl+C per interrompere la sessione attached.
La prima esecuzione può richiedere diversi minuti su una macchina a freddo, poiché Docker potrebbe dover scaricare le immagini di base e compilare le immagini demo locali. Le esecuzioni successive sono molto più rapide.
Lo stack demo richiede che queste porte host siano libere: 8080, 5432, 27017, 9000 e 9001.
Se in seguito hai bisogno di un teardown esplicito:
docker compose -f docker-compose.demo.yml down
Un container, una porta. Monta il socket Docker in sola lettura e graph-go scopre automaticamente tutto ciò che è in esecuzione sull'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
L'immagine viene eseguita come utente non-root, quindi
--group-addgli concede il gruppo del socket (stat -cè Linux; su macOS inizia con--group-add 0). Se il rilevamento Docker continua a ricadere solo su YAML, il log di avvio indica cosa modificare (incluso il valore esatto di--group-addquando è questa la soluzione).graph-go legge solo dall'API Docker (list, inspect, events).
:ronon limita però le chiamate API: qualsiasi cosa possa raggiungere il socket può controllare il daemon. Per il privilegio minimo, anteponi al socket un proxy API in sola lettura cometecnativa/docker-socket-proxye punta graph-go ad esso conDOCKER_HOST=tcp://<proxy>:2375(nessun mount del socket o--group-addnecessario).docker-compose.demo.ymlmostra una configurazione funzionante.
Apri http://localhost:8080. Il rilevamento automatico gestisce i container Docker e (quando un kubeconfig o un service account in-cluster punta a un cluster raggiungibile) le risorse Kubernetes senza alcun file di configurazione.
Per i servizi che risiedono al di fuori di Docker/Kubernetes (database remoti, servizi cloud gestiti), monta un file di configurazione — vedi Configuration.
Binario singolo e autonomo — la UI è incorporata, ma l'entrypoint è comunque la 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
Apri http://localhost:8080. Altre piattaforme nella pagina Releases.
| Comando | Cosa fa |
|---|---|
graph-go demo | Avvia lo stack demo Docker Compose preconfigurato dal repository e ne trasmette l'output in primo piano. |
graph-go serve | Avvia il server HTTP con auto-discovery e aggiornamenti live (predefinito - come eseguirlo senza argomenti). Una volta completata la prima discovery, stampa su stderr una riga ✓/✗ per ogni adapter, con ciò che ha trovato o il motivo del fallimento (saltato con --log-format json). |
graph-go scan | Esegue la discovery una volta e invia il grafo su stdout. --format json (predefinito) per il piping in jq o nei controlli CI; mermaid, markdown (Mermaid in un blocco di codice, visualizzato su GitHub) o dot (Graphviz) per i diagrammi. graph-go export è un alias. |
graph-go validate | Verifica il file di configurazione ed esce con codice non-zero se non è valido. Segnala ogni campo mancante, tipo di connessione sconosciuto e chiave sconosciuta (che serve ignora silenziosamente). Non viene avviato alcun server. |
graph-go mcp | Espone la topologia agli agenti AI tramite il Model Context Protocol (stdio). Vedi Uso con agenti AI (MCP). |
graph-go version | Stampa versione, commit e data di build. |
graph-go --health-check | Esegue una richiesta a /health locale ed esce con 0/1. Usato dall'HEALTHCHECK del container; non per uso interattivo. |
Scopri gli strumenti più utilizzati dalla nostra community.
Nessun dato di popolarità ancora.