Grafici XY in Confluence

Un grafico XY disegna barre e linee su due assi, a partire dai numeri scritti nel codice.

Ultimo aggiornamento

Quando usarlo

Usa un grafico XY per una piccola serie di numeri che sta bene accanto al testo: il risultato di un test di carico, il consumo dell’error budget, i ricavi per mese. I numeri vivono nella pagina, quindi chi revisiona può leggerli e correggerli senza aprire un foglio di calcolo.

Esempio

Questo è il codice del modello Load test: richieste riuscite al secondo e latenza p99 al crescere del carico.

xychart-beta
  title "Load test: throughput vs latency"
  x-axis "Requests per second" [100, 200, 300, 400, 500, 600, 700, 800, 900, 1000]
  y-axis "Requests / latency (ms)" 0 --> 1200
  bar "Successful requests" [100, 200, 300, 400, 500, 600, 700, 790, 850, 820]
  bar "Failed requests" [0, 0, 0, 0, 0, 0, 0, 10, 50, 180]
  line "p99 latency (ms)" [40, 42, 45, 50, 58, 70, 95, 180, 420, 1100]

Vellnar Diagrams lo disegna così:

Cambia una riga e il diagramma cambia con lei. A nessuno serve il file originale del disegno, perché non esiste: il codice è il diagramma.

Aggiungerlo a una pagina di Confluence

  1. Modifica una pagina di Confluence e scrivi /mermaid dove vuoi il diagramma.
  2. Seleziona Mermaid diagram. Si apre l’editor con l’elenco dei modelli.
  3. Scegli un modello, oppure Start blank e incolla il codice qui sopra. L’anteprima segue ogni tasto.
  4. Scegli Save. Il diagramma compare nella pagina.

La documentazione spiega l’editor, le impostazioni e le esportazioni.

Modelli

Il pulsante Templates dell’editor ha 2 modelli pronti per questo tipo:

  • Load test: Richieste riuscite al secondo e latenza p99 al crescere del carico.
  • Error budget: Il consumo reale dell’error budget rispetto a quello atteso in 30 giorni.

Sintassi

Il codice inizia con xychart-beta. La documentazione di Mermaid (in inglese) descrive ogni elemento della sintassi. Vellnar Diagrams lo disegna con Mermaid 12.3; se una riga ha un errore, l’editor segna la riga e tiene a schermo l’ultimo diagramma valido.

Altro

  • Mermaid in Confluence: come funzionano i diagrammi scritti come codice in una pagina, e tutti i tipi di diagramma.
  • Sicurezza: l’app non chiede nessun permesso e non manda nulla fuori da Atlassian.