Panoramica
Una volta installata la tua app in altri spazi di lavoro, devi sapere quando smette di funzionare. Twenty registra ciò che accade alla tua app sulla piattaforma e lo mostra in due punti:- La pagina di monitoraggio della registrazione della tua app, per te in qualità di proprietario dell’app, aggregata per tutte le installazioni.
- I log dello spazio di lavoro, per gli amministratori di ogni spazio di lavoro che ha installato la tua app, limitati al proprio spazio di lavoro.
Apri la pagina di monitoraggio
Vai a Impostazioni → Sviluppatori → App, apri la tua app, quindi fai clic su Visualizza monitoraggio nella scheda Generale. Devi disporre dell’autorizzazione Chiavi API e webhook nello spazio di lavoro proprietario della registrazione dell’app. Scegli un periodo nell’intestazione: ultime 2 ore, 24 ore, 7 giorni, 30 giorni o 90 giorni. I dati vengono conservati per 90 giorni. Senza il diritto Log di audit, sono visibili solo le ultime 2 ore.Cosa mostra la pagina
I conteggi sono esatti: vengono conteggiati ogni richiesta rifiutata e ogni job ignorato, anche quando i log riportati di seguito conservano solo una riga al minuto.
Cosa viene registrato
Ogni evento seguente viene conteggiato nella pagina di monitoraggio. Ciascuno scrive anche i log dell’app nello spazio di lavoro in cui si è verificato, con una origine che indica da dove proviene:
Gli errori relativi ai limiti di frequenza e alle route del server possono ripetersi molte volte al secondo, quindi i log conservano una riga al minuto per ogni installazione, funzione e codice di errore. La pagina di monitoraggio conta comunque ogni occorrenza.
Log dello spazio di lavoro
Gli amministratori di uno spazio di lavoro che ha installato la tua app vedono gli stessi eventi, solo per il proprio spazio di lavoro, in Impostazioni → Generale → Log. Possono filtrare per origine, ad esempio per elencare solo gli erroriINSTALL o i limiti di frequenza. Indirizza qui i tuoi utenti quando segnalano un problema: il codice e il messaggio di errore indicano dove cercare.
Per il tuo server di sviluppo, twenty app logs trasmette in streaming i log delle funzioni in tempo reale nel terminale. Vedi CLI.
Interpretare i segnali
- Gli errori aumentano subito dopo una versione: confronta le versioni nella tabella Versioni, quindi correggi e pubblica una versione successiva. Consulta Pubblicazione.
- Le richieste API sono soggette a limiti di frequenza: la tua app chiama l’API troppo spesso. Raggruppa in batch le letture e le scritture ed evita di chiamare l’API in cicli stretti.
- I job sono soggetti a limiti di frequenza: i trigger di eventi del database o cron si attivano più velocemente di quanto i job possano essere accodati. Restringi il trigger, ad esempio con
updatedFieldssu un triggerdatabaseEvent, oppure esegui il lavoro in meno esecuzioni, ma più grandi. Vedi Funzioni logiche. - Errori di installazione o aggiornamento: controlla i tuoi hook di installazione. Il messaggio di errore viene registrato con l’errore.
- Funzioni lente: una durata elevata del 95° percentile indica una funzione che vale la pena profilare o suddividere.