Oxynote porta grafici live nelle pagine di documentazione interna
Testo scritto con l’intelligenza artificiale a partire da una fonte citata, senza revisione umana prima della pubblicazione.
Wiki open source Apache‑2.0 che esegue query live su Prometheus, PostgreSQL, MySQL e MariaDB e introduce draft, diff e approvazione come una pull request.
Apri un runbook. A sinistra i passaggi per gestire il lag di replica. A destra un grafico che esegue la query contro Prometheus o il database e mostra il valore in tempo reale. Tutto nella stessa pagina di wiki. Questo fa Oxynote: unisce testo operativo e grafici alimentati da query verso Prometheus, PostgreSQL, MySQL o MariaDB. Le modifiche passano da bozza, diff e approvazione, con un flusso simile a una pull request1.
L’obiettivo è pratico: leggere e aggiornare la documentazione mentre si lavora. Ogni pagina può includere un grafico che lancia la sua query accanto alla spiegazione. Chi segue una procedura vede i dati aggiornati e capisce subito se intervenire. Le pagine aperte ogni giorno restano vive, non si impolverano1.
Con PostgreSQL l’integrazione punta alla continuità. Il sistema supporta i placeholder $__timeFilter, $__timeGroup e $__timeFrom, così si possono riusare le query dei dashboard senza riscriverle. La configurazione suggerisce default_transaction_read_only attivo, o l’uso di una replica in standby. Ogni sessione gira in sola lettura, per non toccare i dati operativi1.
Un caso d’uso tipico è il runbook. Per esempio, si può mostrare il ritardo di replica o il conteggio delle query lente accanto ai passaggi per gestirli. Grafico e testo restano nello stesso contesto. Chi interviene non salta tra strumenti diversi, riduce i tempi e gli errori1.
L’impostazione mira a rompere il circolo della documentazione obsoleta. Se una pagina offre dati aggiornati ogni giorno, chi la consulta trova valore immediato e torna più spesso. La frequenza di lettura spinge a correggere imprecisioni e a tenere allineati i passaggi operativi alla realtà del sistema1.
Il controllo delle modifiche è incorporato. Chi propone un aggiornamento crea una bozza, chi revisa vede il diff e approva. La cronologia delle revisioni resta chiara. Il modello è vicino a quello che i team usano già nel codice, quindi richiede poca formazione1.
Oxynote è un progetto open source con licenza Apache-2.0. Si rivolge a team di ingegneria che vogliono tenere procedure e misure operative nello stesso posto. Integra origini dati diffuse come Prometheus, PostgreSQL, MySQL e MariaDB, e offre un percorso naturale per i runbook e le guide operative1.
In pratica, serve a chi gestisce infrastrutture, database e servizi in produzione. Risolve il vuoto tra dashboard e wiki: mette i numeri dove si prendono le decisioni, nella pagina che spiega cosa fare quando quei numeri cambiano1.
Fonti
Come è nato questo articolo Scritto da un sistema di intelligenza artificiale, con controlli automatici
Millebit non ha giornalisti che scrivono gli articoli: li scrive un motore editoriale basato su modelli di intelligenza artificiale, a partire dalle fonti elencate qui sopra. Prima di uscire, ogni testo passa questi controlli:
- Fedeltà alle fonti. Un secondo passaggio toglie ogni affermazione che le fonti non sostengono. Valutazione su questo pezzo: 9,5/10.
- Anti-cliché. Un filtro scarta frasi fatte, enfasi e tic della prosa artificiale: superato.
- Giudizio editoriale. Un modello valuta il pezzo su sette criteri (apertura, chiarezza, economia, concretezza, voce, struttura, fedeltà) e sotto 7,8/10 non si pubblica. Questo articolo ha preso 8,0/10 dopo 1 revisione.
I controlli riducono gli errori ma non li eliminano: un modello può fraintendere una fonte. Per le decisioni importanti, risali alla fonte originale. Se trovi un errore, segnalacelo.
Per vedere Millebit nelle notizie principali di Google, aggiungilo alle tue fonti preferite. Oppure segui l’edizione di oggi, il feed RSS o La Sintesi.