Integrazioni Marketplace: Dati Live dai Tuoi Strumenti, sulla Tua Architettura
Il mese scorso ho visto un team fare debug di un incidente in produzione attraverso sette schede del browser. Datadog per le metriche. GitHub per lo storico dei deploy. SonarQube per il quality gate che qualcuno potrebbe aver bypassato. ArgoCD per confermare che il pod stesse effettivamente eseguendo la versione che pensavano. E da qualche parte sullo sfondo, il loro diagramma di architettura in un'altra scheda, perfettamente accurato, perfettamente statico, perfettamente inutile per il problema in questione.
Il diagramma diceva cosa fosse il sistema. Non poteva dire come stesse andando.
Questo non è un fallimento degli strumenti. Ognuno di quegli strumenti è eccellente in quello che fa. Il problema è il divario tra di essi — il continuo cambio di contesto, il modello mentale che devi ricostruire ogni volta che salti da una dashboard all'altra, la domanda implicita che nessuno fa ad alta voce: "Quale di questi sette strumenti mi sta mostrando ciò che ho davvero bisogno di vedere in questo momento?"
Abbiamo costruito le Integrazioni Marketplace per colmare quel divario.
L'Idea
La premessa è semplice: il tuo diagramma di architettura è già la mappa del tuo sistema. È dove vai per capire cosa esiste, come le cose si collegano, quali protocolli parlano. Perché non dovrebbe essere anche il posto dove vedi come le cose stanno funzionando?
Il Marketplace di Archyl ti permette di collegare servizi esterni — Datadog, GitHub, GitLab, Prometheus, SonarQube, ArgoCD, PagerDuty — e mostrare i loro dati come widget live nelle dashboard del tuo progetto. Non screenshot. Non link. Dati reali live, aggiornati ogni 30 secondi, accanto ai tuoi diagrammi C4.
Un badge di stato del deploy accanto al container che deploya. Un contatore di copertura del codice collegato al servizio che misura. Una lista di allarmi che mostra cosa sta bruciando, nel contesto dell'architettura in fiamme.
Cosa Puoi Collegare
Abbiamo lanciato con sette prodotti, scelti perché coprono la toolchain che la maggior parte dei team già usa:
Datadog — Monitora la salute, query di metriche, allarmi attivi, dashboard integrate. Se stai già usando Datadog per monitorare la tua infrastruttura, puoi mostrare gli stessi dati nel tuo workspace architetturale senza duplicare una singola query.
GitHub — Stato dei workflow, pull request aperte, statistiche del repository, allarmi Dependabot, scansione dei segreti, scansione del codice. I widget di sicurezza da soli valgono la configurazione — invece di controllare la scheda sicurezza di ogni repository individualmente, vedi i risultati contestualizzati nell'architettura.
GitLab — Stato delle pipeline, merge request, statistiche del progetto e la suite completa di scanner di sicurezza: analisi delle vulnerabilità, SAST, rilevamento segreti, DAST. Stessa idea di GitHub, nativa nell'ecosistema GitLab.
Prometheus — Query istantanee per valori di metriche correnti, query range renderizzate come grafici di serie temporali e monitoraggio della salute dei target. Se hai già query PromQL per le tue metriche chiave, puoi mostrarle direttamente nel tuo workspace architetturale.
SonarQube — Stato del quality gate, misure del progetto (copertura, bug, vulnerabilità, debito tecnico), issue per severità, hotspot di sicurezza e rating di sicurezza. Il widget del quality gate è particolarmente utile: un badge verde o rosso per servizio ti dice istantaneamente se il codice soddisfa i tuoi standard.
ArgoCD — Salute delle applicazioni e stato di sincronizzazione, inventari delle applicazioni, liste di risorse Kubernetes e conteggi delle applicazioni con filtraggio. Per i team che girano su Kubernetes, questo trasforma il tuo diagramma C4 in una dashboard di deployment.
PagerDuty — Stato degli incidenti, liste di incidenti attivi, turni di reperibilità, salute dei servizi e conteggio degli incidenti. Per i team che gestiscono la risposta agli incidenti, questo mette i tuoi allarmi operativi nel contesto dell'architettura che influenzano — niente più salti tra PagerDuty e il tuo diagramma di sistema per capire quale servizio sta effettivamente bruciando.
Ogni prodotto supporta più tipi di widget — contatori, badge di stato, liste, grafici di serie temporali e iframe integrati — così scegli la visualizzazione giusta per i dati.
Come Funziona
Il sistema ha tre livelli:
Connessioni vivono a livello organizzativo. Un admin crea una connessione fornendo le credenziali (una chiave API, un token, un URL del server). Una connessione può alimentare widget in ogni progetto dell'organizzazione. Puoi creare più connessioni allo stesso prodotto — ad esempio, una per il tuo account Datadog di produzione e un'altra per lo staging.
Widget vivono a livello di progetto (o di elemento, o di organizzazione). Aggiungi un widget scegliendo una connessione, selezionando un tipo di widget e configurando la query. Un widget GitHub "Pull Request Aperte" ha bisogno di un owner e un nome repository. Un widget Prometheus "Range Query" ha bisogno di un'espressione PromQL e un intervallo temporale. Un widget SonarQube "Quality Gate" ha bisogno di una chiave progetto.
La griglia è dove i widget vivono visivamente. È un layout a 12 colonne drag-and-drop con sezioni nominate. Puoi creare sezioni come "Monitoraggio", "Sicurezza", "CI/CD", comprimerle, riordinarle e ridimensionare i singoli widget. Tutto si salva automaticamente.
La configurazione di un widget tipico richiede circa 30 secondi. Scegli la connessione, scegli il tipo, incolla la configurazione, fatto. Il widget inizia a recuperare dati immediatamente.
Perché Widget, Non Dashboard
Avremmo potuto costruire un prodotto dashboard tradizionale. Righe di grafici, una sidebar di filtri, il solito.
Non l'abbiamo fatto, perché esiste già. Datadog ha le dashboard. Grafana ha le dashboard. Non hai bisogno di un altro strumento di dashboard. Ciò di cui hai bisogno è un modo per vedere i dati giusti nel contesto giusto — e il contesto è la tua architettura.
Una dashboard Grafana che mostra metriche CPU per dieci servizi è utile. Ma non ti dice quale di quei servizi è l'API gateway, quale il processore di pagamenti e quale il sistema di notifiche. Il tuo diagramma di architettura sì. Mettere la metrica CPU *sull'*architettura, accanto al container a cui appartiene, significa che non devi mai fare quella mappatura mentale da solo.
Questo è lo stesso principio dietro tutto ciò che costruiamo ad Archyl: la documentazione dell'architettura dovrebbe essere l'unico posto dove vai per capire un sistema. Non solo la sua struttura — le sue decisioni (ADR), le sue specifiche (API Contract), il suo storico di deployment (Release) e ora la sua realtà operativa (Integrazioni Marketplace).
Sezioni e Organizzazione
Sapevamo fin dall'inizio che un muro piatto di widget non avrebbe scalato. Quando hai quindici widget su un progetto — alcuni per il monitoraggio, alcuni per la sicurezza, alcuni per CI/CD — hai bisogno di struttura.
I widget sono organizzati in sezioni nominate. Le crei, le nomini, le riordini trascinando i loro header e comprimi quelle che non ti servono ora. Ogni sezione funziona come un pannello che puoi aprire o chiudere.
In modalità modifica puoi:
- Trascinare widget per riposizionarli all'interno di una sezione
- Spostare widget tra sezioni
- Ridimensionare widget da un badge compatto a un grafico a larghezza piena
- Trascinare gli header delle sezioni per riordinare interi gruppi
- Creare, rinominare e cancellare sezioni
La griglia compatta verticalmente, quindi non ci sono spazi vuoti. Quando hai finito di organizzare, clicca "Fatto" e il layout si blocca.
Ambito: Organizzazione, Progetto, Elemento
Non tutti i dati appartengono allo stesso livello.
Widget a livello organizzativo sono visibili in tutti i progetti. Usali per metriche che contano globalmente — conteggio totale dei deployment, stato quality gate SonarQube aziendale, risultati di sicurezza GitHub a livello organizzativo.
Widget a livello progetto appaiono solo nella scheda Integrazioni di un progetto specifico. Sono i più comuni — dashboard di monitoraggio, stato CI/CD, metriche di qualità del codice per i servizi in quel progetto.
Widget a livello elemento si attaccano direttamente a un elemento C4. Apri il pannello dettaglio di un container e vedi i suoi widget accanto alle sue relazioni, ADR e API contract. Questo è l'ambito più potente: dati operativi contestualizzati all'elemento architetturale a cui appartengono.
Cosa Cambia
Prima delle Integrazioni Marketplace, capire lo stato operativo di un sistema significava aprire più strumenti, incrociare dati e tenere a mente la mappatura tra "dashboard di monitoraggio" e "diagramma di architettura".
Dopo: apri un workspace. L'architettura ti dice cosa esiste. I widget ti dicono come sta andando. Le release ti dicono cosa è stato rilasciato. Gli ADR ti dicono perché è stato costruito così. Gli API contract ti dicono come sono le interfacce.
Un posto. Un contesto. Niente cambio di schede.
Questa è la visione che stiamo costruendo fin dal primo giorno. Documentazione dell'architettura che risponde a domande reali — non solo "cos'è questo sistema?" ma "questo sistema è sano?", "questo servizio è sicuro?", "quando è stato l'ultimo deploy?", e "qual è lo stato del quality gate di questo codice?"
Le Integrazioni Marketplace sono un grande passo verso quella visione. E siamo solo all'inizio — altri prodotti stanno arrivando.
Per Iniziare
- Vai in Impostazioni Organizzazione > Marketplace
- Collega un prodotto (ti servirà una chiave API o un token)
- Apri la scheda Integrazioni di qualsiasi progetto
- Clicca Personalizza, poi Aggiungi Widget
- Scegli una connessione, seleziona un tipo di widget, configura, fatto
L'intera configurazione richiede meno di cinque minuti. I tuoi diagrammi di architettura non saranno mai più gli stessi.
Vuoi vedere come altre funzionalità danno vita alla tua architettura? Dai un'occhiata a Gestione Release per il tracciamento dei deployment, o API Contract per collegare le tue specifiche API al diagramma.