Prima di dare per scontato che una funzione sia rotta, controlla se il problema è il bot stesso: una pagina Risorse in tempo reale mostra l'uso di RAM e CPU, la latenza del database e del websocket, e quale nodo dell'infrastruttura sta eseguendo il bot per quel server in questo momento, con aggiornamenti circa ogni due secondi. La maggior parte delle segnalazioni «il bot non risponde» dipende da un'impostazione mancante, non da un disservizio; ma quando si tratta davvero di un disservizio o di un picco di lentezza, questa pagina è il posto dove confermarlo invece di tirare a indovinare.
Cosa mostra davvero la pagina Risorse
- Utilizzo in tempo reale: RAM usata rispetto al totale, utilizzo dell'heap e carico della CPU, con un piccolo grafico scorrevole degli ultimi 60 secondi, così un picco è visibile e non solo un singolo valore attuale.
- Uptime e nodo: da quanto tempo è in esecuzione il processo corrente, e il nome del nodo specifico che serve il tuo server. È rilevante perché Noxyr gira su più di un nodo, e un bot personalizzato in particolare gira sul nodo a cui è stato assegnato.
- Pannello della latenza in tempo reale: valori di andata e ritorno separati per il database, la cache Redis, la connessione websocket di Discord, il ritardo dei messaggi e la latenza tra i nodi, ciascuno colorato di verde, ambra o rosso a seconda di quanto è alto in quel momento.
- Stato dei servizi: online/in avvio/offline per il processo principale del bot, MongoDB e Redis in particolare, le tre cose che devono essere tutte in salute perché ogni funzione funzioni.
La pagina si aggiorna da sola tramite una connessione in tempo reale quando il browser lo supporta, altrimenti ricorre al polling ogni due secondi circa; non c'è nulla da aggiornare manualmente.
Leggerla: cosa è normale e cosa è un problema reale
I valori di latenza nella fascia verde per database, websocket e ritardo dei messaggi, con la RAM sotto la soglia in cui il misuratore diventa ambra, sono uno stato sano e normale; aspettati piccole oscillazioni, non una linea piatta. Un singolo valore di latenza che diventa ambra per un attimo non merita un intervento; un servizio che mostra «Offline» per più di qualche secondo, oppure tutti i valori di latenza rossi insieme, merita di aspettare un minuto e ricontrollare prima di supporre che il problema sia nella configurazione del tuo server.
Quando controllare questa pagina e quando controllare le tue impostazioni
- Una funzione non funziona, tutto il resto va bene: quasi sempre è un problema di configurazione (un canale mancante, un problema di gerarchia dei ruoli, un modulo disattivato), non di infrastruttura. Controlla prima la checklist di configurazione della pagina Panoramica.
- Non risponde niente, in nessuna funzione: controlla prima le Risorse. Se il servizio principale del bot risulta offline o ogni valore di latenza è rosso, il problema è lato infrastruttura e nessuna impostazione della dashboard lo cambierà.
- Lento, non rotto: un comando impiega qualche secondo in più ma alla fine funziona. Controlla in particolare il ritardo dei messaggi e la latenza del database; un valore temporaneamente alto che torna normale entro un minuto o due è un'oscillazione, non un disservizio.
Perché il nodo conta, soprattutto per un Custom Bot
Noxyr esegue i processi del bot su più nodi per garantire la capacità. Per la maggior parte dei server questo è invisibile: non devi mai sapere né preoccuparti su quale sei. Diventa rilevante per il Custom Bot in particolare, perché un bot personalizzato viene assegnato a un nodo specifico quando parte, e la pagina Risorse è dove puoi confermare quale nodo è e vedere i numeri di quel nodo invece di una media globale. Se un bot personalizzato si comporta in modo strano, il nome del nodo in questa pagina è utile da indicare quando contatti l'assistenza, perché indica esattamente quale processo lato server controllare.
Cosa questa pagina non può dirti
Riporta lo stato di salute dell'infrastruttura, non la configurazione delle funzioni. Un server con un bot perfettamente sano e latenza verde su tutta la linea può comunque avere un pannello ticket che non pubblica mai perché la categoria non è mai stata impostata, oppure un messaggio di benvenuto che non parte mai perché l'interruttore è spento. Risorse risponde a «il bot in sé sta bene?», mai a «la configurazione del mio server è corretta?»: per questo, la checklist di configurazione della pagina Panoramica e la pagina di impostazioni di ciascuna funzione sono il posto giusto dove guardare.
Domande frequenti
Un uso elevato della RAM significa che il bot sta per andare in crash? Non di per sé: il misuratore diventa ambra e poi rosso quando si superano le soglie, proprio perché una salita costante sia visibile prima che diventi un problema, e non è un segnale sicuro di un crash imminente.
Perché il nome del nodo del mio server è importante se gestisco un solo server? Per un server normale (non personalizzato) conta poco; è solo un'informazione. Conta di più quando usi un Custom Bot, perché il nodo di quel bot determina la sua latenza e il suo uptime indipendentemente dallo stato di salute del bot principale.
È la stessa cosa del comando /status? No, /status riporta i numeri della tua community (membri, ticket, vendite). Risorse riporta lo stato di salute dell'infrastruttura del bot, che è un tipo di «stato» completamente diverso.
Possono vedere questa pagina i membri? No, fa parte della dashboard di amministrazione di un server e richiede lo stesso accesso di qualsiasi altra pagina della dashboard: proprietario del server o Amministratore.
Cosa devo fare se Risorse mostra tutto in salute ma la mia funzione continua a non funzionare? Trattalo come un problema di configurazione, non di infrastruttura. Controlla la checklist di configurazione della pagina Panoramica e la pagina impostazioni della funzione specifica per un canale, un ruolo o un interruttore mancante.
Controlla lo stato in tempo reale del tuo server nella pagina Risorse della tua dashboard, e consulta la documentazione della dashboard per scoprire cos'altro c'è accanto ad essa.