Diagrammi di Ishikawa in Confluence
Un diagramma di Ishikawa, detto anche a lisca di pesce, ordina in categorie le possibili cause di un problema.
Ultimo aggiornamento
Quando usarlo
Usa un diagramma di Ishikawa in un post-mortem o in una revisione di qualità. Il problema è la testa del pesce; ogni lisca è una categoria, come persone, processo o strumenti, con le sue cause. Spinge il team a guardare ogni categoria prima di scegliere una causa.
Esempio
Questo è il codice del modello Outage root causes: il post-mortem a lisca di pesce di un’interruzione, con le cause in sei categorie.
ishikawa-beta
Checkout down for 18 minutes
Code
Null pointer in cart total
Retry loop without backoff
Database
Connection pool exhausted
Missing index on orders table
Configuration
Wrong timeout in production
Feature flag left enabled
Monitoring
No alert on error rate
Dashboard showed stale data
External dependencies
Payment gateway slow
DNS resolver timeouts
Release process
Deployed on Friday evening
Canary stage skipped
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
- Modifica una pagina di Confluence e scrivi
/mermaiddove vuoi il diagramma. - Seleziona Mermaid diagram. Si apre l’editor con l’elenco dei modelli.
- Scegli un modello, oppure Start blank e incolla il codice qui sopra. L’anteprima segue ogni tasto.
- Scegli Save. Il diagramma compare nella pagina.
La documentazione spiega l’editor, le impostazioni e le esportazioni.
Modelli
Il pulsante Templates dell’editor ha un modello pronto per questo tipo:
- Outage root causes: Il post-mortem a lisca di pesce di un’interruzione, con le cause in sei categorie.
Sintassi
Il codice inizia con ishikawa-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.