Vai al contenuto

Monitoraggio — pagina Status

URL: /ui/admin/status

Mostra in tempo reale lo stato di tutti i componenti critici. Ricarica manualmente per aggiornare.

Servizi core

Indicatore Valori Azione se non OK
Database OK / ERROR Il PostgreSQL non è raggiungibile. Verifica container postgres e rete Docker
Cruncher RUNNING / STOPPED Vedi sezione "Cruncher STOPPED"
Claude API OK / ERROR / MISSING OK = ping verso l'API riuscito · ERROR = chiave presente ma ping fallito · MISSING = ANTHROPIC_API_KEY non settata
n8n OK / FAIL n8n raggiungibile dall'order-processor. Ultima verifica timestampata sotto il badge
Tenant attivi numero Link rapido alla gestione tenant

Il Cruncher mostra inoltre: data e ora dell'ultimo tick, totale documenti processati e totale errori dall'avvio del container.

Coda documenti

Tre contatori:

  • In attesa — documenti pending non ancora presi in carico dal cruncher
  • In elaborazione — documenti che il cruncher sta processando in questo momento
  • Completati oggi — documenti chiusi nelle ultime 24 ore

Un banner rosso compare se ci sono documenti bloccati da più di 15 minuti — con link diretto alla lista.

Situazione normale: il contatore "In attesa" scende a 0 entro pochi secondi dall'arrivo di un documento. Se rimane alto per minuti, controlla il Cruncher.

Infrastruttura VPS

Card con metriche del VPS:

  • Disco — percentuale usata e spazio libero (badge rosso sopra 80%)
  • RAM — percentuale e spazio usato/totale
  • DB size — dimensione del database PostgreSQL, migration corrente applicata, connessioni attive
  • Tabelle — dimensione per tabella (quando disponibile)

Docker

Card con occupazione:

  • Build cache — badge rosso se sopra 5 GB
  • Immagini — dimensione totale su disco
  • Volumi — dimensione totale

Tabella dei container con stato (running / exited) e timestamp di avvio.

Azioni operative

Pulsanti in fondo alla sezione Docker:

  • Pulisci build cache → docker builder prune. Non tocca container, immagini attive o volumi. Il prossimo build sarà più lento.
  • Rimuovi immagini dangling → docker image prune. Non tocca l'immagine del container attivo.
  • Backup DB ora → esegue pg_dump, salva .sql.gz in /app/data/backups, mantiene gli ultimi 7 backup.
  • Scarica ultimo backup → download del file .sql.gz più recente.

Cruncher STOPPED

Il Cruncher è il processo che elabora i PDF in coda. Se si ferma, i nuovi documenti rimangono in stato "in attesa" indefinitamente.

Passaggi di verifica:

  1. Controlla i log del container: bash docker logs order-processor-legami-dev --tail=50

  2. Se serve, ricrea il container: bash cd /home/denebor/n8n-infra docker compose up -d --no-deps --build order-processor-legami-dev

Importante: usa sempre docker compose up -d --no-deps, mai docker restart. docker restart non ricarica le variabili d'ambiente e può lasciare il container in stato inconsistente.

Claude API MISSING

La chiave API Anthropic è necessaria per l'estrazione AI. Se manca:

  1. Verifica che ANTHROPIC_API_KEY sia impostata in .env.order-processor-legami-dev
  2. Ricrea il container con docker compose up -d --no-deps order-processor-legami-dev
  3. Ricontrolla la pagina Status

n8n FAIL

Il check n8n verifica che l'istanza n8n sia raggiungibile dal container order-processor. Se FAIL:

  1. Verifica che il container n8n sia running
  2. Verifica la rete Docker internal (entrambi i container devono appartenervi)
  3. Verifica che la variabile N8N_BASE_URL punti al nome container giusto

Prossimi passi

Torna all'introduzione