Integraciones del Marketplace: datos en vivo de tus herramientas, en tu arquitectura
El mes pasado vi a un equipo debuggear un incidente de producción a través de siete pestañas del navegador. Datadog para las métricas. GitHub para el historial de deploys. SonarQube para el quality gate que alguien podría haber ignorado. ArgoCD para confirmar que el pod realmente estaba corriendo la versión que creían. Y en algún lugar del fondo, su diagrama de arquitectura en otra pestaña, perfectamente preciso, perfectamente estático, perfectamente inútil para el problema en cuestión.
El diagrama les decía qué era el sistema. No podía decirles cómo estaba.
No es un fallo de herramientas. Cada una de esas herramientas es excelente en lo que hace. El problema es la brecha entre ellas — el constante cambio de contexto, el modelo mental que tienes que reconstruir cada vez que saltas de un dashboard a otro, la pregunta implícita que nadie hace en voz alta: "¿Cuál de estas siete herramientas me está mostrando lo que realmente necesito ver ahora mismo?"
Construimos las Integraciones del Marketplace para cerrar esa brecha.
La idea
La premisa es simple: tu diagrama de arquitectura ya es el mapa de tu sistema. Es donde vas para entender qué existe, cómo se conectan las cosas, qué protocolos usan. ¿Por qué no debería ser también el lugar donde ves cómo están funcionando?
El Marketplace de Archyl te permite conectar servicios externos — Datadog, GitHub, GitLab, Prometheus, SonarQube, ArgoCD, PagerDuty — y mostrar sus datos como widgets en tiempo real en los dashboards de tus proyectos. No capturas de pantalla. No enlaces. Datos reales en vivo, actualizados cada 30 segundos, justo al lado de tus diagramas C4.
Un badge de estado de despliegue junto al contenedor que despliega. Un contador de cobertura de código vinculado al servicio que mide. Una lista de alertas que muestra qué se está incendiando, en el contexto de la arquitectura que arde.
Lo que puedes conectar
Lanzamos con siete productos, elegidos porque cubren la cadena de herramientas que la mayoría de los equipos ya usan:
Datadog — Salud de monitores, consultas de métricas, alertas activas, dashboards embebidos. Si ya usas Datadog para vigilar tu infraestructura, puedes hacer que esos mismos datos aparezcan en tu espacio de arquitectura sin duplicar una sola consulta.
GitHub — Estado de workflows, pull requests abiertas, estadísticas de repositorio, alertas de Dependabot, secret scanning, code scanning. Solo los widgets de seguridad justifican la configuración — en lugar de revisar la pestaña de seguridad de cada repo individualmente, ves los hallazgos contextualizados contra la arquitectura.
GitLab — Estado de pipelines, merge requests, estadísticas de proyecto y la suite completa de escáneres de seguridad: análisis de vulnerabilidades, SAST, detección de secretos, DAST. La misma idea que GitHub, nativo del ecosistema GitLab.
Prometheus — Consultas instantáneas para valores de métricas actuales, consultas de rango renderizadas como gráficos de series temporales, y monitoreo de la salud de los targets. Si ya tienes consultas PromQL para tus métricas clave, puedes mostrarlas directamente en tu espacio de arquitectura.
SonarQube — Estado del quality gate, medidas del proyecto (cobertura, bugs, vulnerabilidades, deuda técnica), issues por severidad, security hotspots y calificaciones de seguridad. El widget de quality gate es particularmente útil: un badge verde o rojo por servicio te dice instantáneamente si el código cumple con tus estándares.
ArgoCD — Salud y estado de sincronización de aplicaciones, inventarios de aplicaciones, listas de recursos Kubernetes y contadores de aplicaciones con filtros. Para equipos que corren en Kubernetes, esto convierte tu diagrama C4 en un dashboard de despliegue.
PagerDuty — Estado de incidentes, lista de incidentes activos, turnos de guardia, salud de servicios y contadores de incidentes. Para equipos que gestionan la respuesta a incidentes, esto pone tus alertas operacionales en el contexto de la arquitectura que afectan — sin más saltos entre PagerDuty y tu diagrama de sistema para descubrir qué servicio realmente está en llamas.
Cada producto soporta múltiples tipos de widgets — contadores, badges de estado, listas, gráficos de series temporales e iframes embebidos — para que elijas la visualización correcta para cada dato.
Cómo funciona
El sistema tiene tres capas:
Las conexiones viven a nivel de organización. Un admin crea una conexión proporcionando credenciales (una clave API, un token, una URL de servidor). Una conexión puede alimentar widgets en todos los proyectos de la organización. Puedes crear múltiples conexiones al mismo producto — digamos, una para tu cuenta de Datadog de producción y otra para staging.
Los widgets viven a nivel de proyecto (o de elemento, o de organización). Agregas un widget eligiendo una conexión, un tipo de widget y configurando la consulta. Un widget de GitHub "Pull Requests abiertas" necesita un propietario y nombre de repo. Un widget de Prometheus "Consulta de rango" necesita una expresión PromQL y un período. Un widget de SonarQube "Quality Gate" necesita una clave de proyecto.
La cuadrícula es donde los widgets viven visualmente. Es un layout drag-and-drop de 12 columnas con secciones nombradas. Puedes crear secciones como "Monitoreo", "Seguridad", "CI/CD", colapsarlas, reordenarlas y redimensionar widgets individuales. Todo se guarda automáticamente.
La configuración de un widget típico toma unos 30 segundos. Elegir conexión, elegir tipo, pegar la config, listo. El widget empieza a obtener datos inmediatamente.
Por qué widgets, no dashboards
Podríamos haber construido un producto de dashboard tradicional. Filas de gráficos, una barra lateral de filtros, lo habitual.
No lo hicimos, porque eso ya existe. Datadog tiene dashboards. Grafana tiene dashboards. No necesitas otra herramienta de dashboards. Lo que necesitas es una forma de ver los datos correctos en el contexto correcto — y el contexto es tu arquitectura.
Un dashboard de Grafana mostrando métricas de CPU para diez servicios es útil. Pero no te dice cuál de esos servicios es el API gateway, cuál es el procesador de pagos y cuál es el sistema de notificaciones. Tu diagrama de arquitectura sí. Poner la métrica de CPU en la arquitectura, junto al contenedor al que pertenece, significa que nunca tienes que hacer esa correspondencia mental tú mismo.
Es el mismo principio detrás de todo lo que construimos en Archyl: la documentación de arquitectura debería ser el lugar único donde vas para entender un sistema. No solo su estructura — sus decisiones (ADRs), sus especificaciones (Contratos API), su historial de despliegue (Releases) y ahora su realidad operacional (Integraciones del Marketplace).
Secciones y organización
Sabíamos desde el inicio que un muro plano de widgets no escalaría. Cuando tienes quince widgets en un proyecto — algunos para monitoreo, algunos para seguridad, algunos para CI/CD — necesitas estructura.
Los widgets se organizan en secciones con nombre. Las creas, las nombras, las reordenas arrastrando sus encabezados, y colapsas las que no necesitas ahora. Cada sección actúa como un panel que puedes abrir o cerrar.
En modo edición, puedes:
- Arrastrar widgets para reposicionarlos dentro de una sección
- Mover widgets entre secciones
- Redimensionar widgets desde un badge compacto hasta un gráfico de ancho completo
- Arrastrar encabezados de sección para reordenar grupos enteros
- Crear, renombrar y eliminar secciones
La cuadrícula se compacta verticalmente, así que no hay espacios. Cuando termines de organizar, haz clic en "Listo" y el layout se fija.
Alcance: Organización, Proyecto, Elemento
No todos los datos pertenecen al mismo nivel.
Los widgets de organización son visibles en todos los proyectos. Úsalos para métricas que importan globalmente — conteo total de despliegues, estado de quality gate de SonarQube a nivel de empresa, hallazgos de seguridad de GitHub a nivel de organización.
Los widgets de proyecto aparecen solo en la pestaña Integraciones de un proyecto específico. Son los más comunes — dashboards de monitoreo, estado de CI/CD, métricas de calidad de código para los servicios de ese proyecto.
Los widgets de elemento se adjuntan directamente a un elemento C4. Abre el panel de detalle de un contenedor y verás sus widgets junto a sus relaciones, ADRs y contratos API. Este es el alcance más poderoso: datos operacionales contextualizados en el elemento arquitectónico al que pertenecen.
Lo que esto cambia
Antes de las Integraciones del Marketplace, entender el estado operacional de un sistema significaba abrir múltiples herramientas, cruzar datos y mantener la correspondencia entre "dashboard de monitoreo" y "diagrama de arquitectura" en tu cabeza.
Después: abres un espacio. La arquitectura te dice qué existe. Los widgets te dicen cómo está. Los releases te dicen qué se envió. Los ADRs te dicen por qué se construyó así. Los contratos API te dicen cómo son las interfaces.
Un lugar. Un contexto. Sin cambiar de pestaña.
Esa es la visión que hemos estado construyendo desde el primer día. Documentación de arquitectura que responde preguntas reales — no solo "¿qué es este sistema?" sino "¿está sano este sistema?", "¿es seguro este servicio?", "¿cuándo fue el último despliegue?" y "¿cuál es el estado del quality gate de este código?"
Las Integraciones del Marketplace son un gran paso hacia esa visión. Y apenas estamos empezando — más productos están por venir.
Para empezar
- Ve a Configuración de la organización > Marketplace
- Conecta un producto (necesitarás una clave API o token)
- Abre la pestaña Integraciones de cualquier proyecto
- Haz clic en Personalizar, luego Agregar widget
- Elige una conexión, selecciona un tipo de widget, configura, listo
Toda la configuración toma menos de cinco minutos. Tus diagramas de arquitectura nunca volverán a sentirse igual.
¿Quieres ver cómo otras funcionalidades dan vida a tu arquitectura? Descubre la Gestión de Releases para el seguimiento de despliegues, o los Contratos API para vincular tus especificaciones API al diagrama.