
simplemente nodos y grafos
Ve tu infraestructura. Cero configuración.
Apunta graph-go a tu stack y obtén un mapa interactivo y en vivo de cada base de datos, tabla, servicio y bucket de almacenamiento — con monitoreo de salud en tiempo real.
graph-go es un mapeador de infraestructura con enfoque CLI. Descubre tu infraestructura automáticamente conectándose al daemon de Docker, inspeccionando contenedores en ejecución y sondeando bases de datos y servicios de almacenamiento. La UI es servida por el backend y refleja el estado real del backend — sin necesidad de inventario manual.
| Capacidad | Detalles |
|---|---|
| Autodescubrimiento | Detecta infraestructura a partir de contenedores Docker y clústeres de Kubernetes — sin necesidad de inventario manual |
| Kubernetes | Namespaces, Deployments, StatefulSets, DaemonSets, Pods, Services — con observación en tiempo real basada en informers |
| Docker | Clasifica contenedores en ejecución, extrae credenciales, observa eventos de Docker, respeta las etiquetas graphgo.* para sobrescribir tipo/DSN/tipo de nodo/nombre o ignorar un contenedor |
| PostgreSQL | Tablas, relaciones de clave foránea, topología del esquema |
| MongoDB | Bases de datos y colecciones |
| MySQL | Tablas, relaciones de clave foránea |
| Redis | Keyspaces y distribución de claves |
| Elasticsearch | Índices, salud del clúster, estado de los shards |
| S3 / MinIO | Buckets y prefijos de nivel superior |
| Servicios HTTP | Endpoints de salud, mapeo de dependencias entre servicios |
| Salud en tiempo real | Actualizaciones de estado en vivo impulsadas por WebSocket cada 5 segundos |
| Grafo interactivo | Diseño de swimlanes, contenedores de agrupación por namespace, pan/zoom, filtro por tipo/salud, búsqueda de nodos |
graph-go respeta un pequeño conjunto de etiquetas de contenedor graphgo.* (configúralas en cualquier contenedor que quieras controlar):
| Etiqueta | Efecto |
|---|---|
graphgo.ignore=true | Omite este contenedor por completo |
graphgo.type=postgres | Fuerza el tipo de adaptador (postgres, mongodb, mysql, redis, elasticsearch, s3, http) |
graphgo.dsn=... | Inyecta una cadena de conexión (DSN para postgres/mysql, URI para mongodb, en caso contrario recurre a dsn) |
graphgo.node-type=gateway | Sobrescribe el tipo visual del nodo (service, gateway, auth, api, queue, cache) |
graphgo.name=... | Sobrescribe el nombre del nodo mostrado en el grafo y usado en los IDs de nodo / logs |
Úsalas para rescatar contenedores mal clasificados, apuntar graph-go a un DSN personalizado u ocultar un contenedor del grafo sin eliminarlo.
Arranca el stack de demostración con datos precargados usando la CLI. Esta es la forma más rápida de ver graph-go contra un entorno realista y la ruta de incorporación prevista para usuarios primerizos:
git clone https://github.com/guilherme-grimm/graph-go.git
cd graph-go
go run ./cmd/app demo
Abre http://localhost:8080. El comando se ejecuta de forma adjunta mediante Docker Compose. Pulsa Ctrl+C para detener la sesión adjunta.
La primera ejecución puede tardar varios minutos en una máquina en frío, ya que Docker puede necesitar descargar las imágenes base y compilar las imágenes locales de la demo. Las ejecuciones posteriores son mucho más rápidas.
El stack de la demo requiere que estos puertos del host estén libres: 8080, 5432, 27017, 9000 y 9001.
Si necesitas un desmontaje explícito después:
docker compose -f docker-compose.demo.yml down
Un contenedor, un puerto. Monta el socket de Docker en modo de solo lectura y graph-go descubre automáticamente todo lo que se ejecuta en el 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
La imagen se ejecuta como un usuario no root, por lo que
--group-addle concede el grupo del socket (stat -ces de Linux; en macOS comienza con--group-add 0). Si el descubrimiento de Docker sigue recurriendo solo a YAML, el registro de inicio indica qué cambiar (incluido el valor exacto de--group-addcuando esa es la solución).graph-go solo lee de la API de Docker (list, inspect, events). Sin embargo,
:rono restringe las llamadas a la API: cualquier cosa que pueda alcanzar el socket puede controlar el daemon. Para aplicar el mínimo privilegio, coloca un proxy de API de solo lectura comotecnativa/docker-socket-proxydelante del socket y apunta graph-go a él conDOCKER_HOST=tcp://<proxy>:2375(no se necesita montar el socket ni usar--group-add).docker-compose.demo.ymlmuestra una configuración funcional.
Abre http://localhost:8080. El descubrimiento automático gestiona contenedores de Docker y (cuando un kubeconfig o una cuenta de servicio dentro del clúster apunta a un clúster accesible) recursos de Kubernetes sin necesidad de ningún archivo de configuración.
Para servicios que residen fuera de Docker/Kubernetes (bases de datos remotas, servicios en la nube gestionados), monta un archivo de configuración — consulta Configuration.
Binario único autocontenido — la interfaz de usuario está integrada, pero el punto de entrada sigue siendo 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
Abre http://localhost:8080. Otras plataformas en la página de Releases.