Log, metriche e risoluzione dei problemi
Parti dalla fase che fallisce: sincronizzazione del codice sorgente, compilazione, avvio, instradamento o richiesta all’applicazione. I log di compilazione e quelli di esecuzione rispondono a domande diverse.
Leggi i log
Apri le viste Log o Osservabilità nella dashboard, oppure usa la CLI dal progetto locale collegato:
adios logs --build
adios logs --runtime --lines 100
adios logs --runtime --follow
adios logs --http
adios logs --errors
Usa --build-id YOUR_BUILD_ID per esaminare una compilazione specifica. Usa --region o --replica per filtrare l’output di esecuzione quando sono attive più istanze. Interrompi un flusso di log in tempo reale con Ctrl+C.
Diagnostica una distribuzione fallita
| Sintomo | Primi controlli |
|---|---|
| L’installazione delle dipendenze o la compilazione fallisce | Log di compilazione, lockfile, versione dell’ambiente di esecuzione, comando di compilazione, credenziali delle dipendenze private. |
| La compilazione riesce ma l’avvio fallisce | Comando di avvio, percorso di output, variabili di ambiente necessarie, log di esecuzione. |
| Il controllo di stato fallisce | Porta configurata, interfaccia di ascolto, percorso di stato, codice di stato, disponibilità dell’applicazione. |
| L’URL generato funziona ma il dominio personalizzato no | Verifica della proprietà del dominio, destinazione DNS, TLS, route corrente. |
| La connessione del database fallisce | Team, nome host privato, versione, credenziali, stato del servizio, contesto di regione e rete. |
| L’anteprima differisce dalla produzione | Revisione del codice sorgente, ambiente, manifest, artefatto di compilazione, versione attiva. |
| Il compito dell'IA è bloccato | Errore di esecuzione, connessione al fornitore, modello selezionato, fondi, approvazione in sospeso. |
Controlla lo stato della distribuzione richiesta oltre al suo URL pubblico. Una versione precedente funzionante può continuare a servire richieste mentre una nuova compilazione fallisce.
Metriche e incidenti
Usa le viste Osservabilità per esaminare la telemetria disponibile per quel carico di lavoro e intervallo di tempo. Controlla le unità mostrate, gli orari di origine e i dati mancanti prima di confrontare richieste, CPU, memoria o altre misurazioni. Un campione mancante non equivale a una misura pari a zero e un ambiente arrestato può riportare dati in modo diverso da uno in esecuzione.
Quando analizzi un incidente, collega la distribuzione o la modifica del codice sorgente ai log di esecuzione e all’intervallo di tempo interessato. Tieni segreti e dati privati delle richieste fuori dalle schermate e dalle segnalazioni pubbliche.
Condividi elementi utili
Annota team, carico di lavoro, ID della compilazione o esecuzione, regione, ora UTC approssimativa, comando usato e risposta di errore o estratto dei log. Includi il comportamento atteso e un esempio minimo per riprodurre il problema. Rimuovi token bearer, password, cookie e dati personali prima di condividere fuori dal tuo team.
Per gli errori di stato HTTP e la paginazione API, vedi Errori API. Per persistenza e recupero, vedi archiviazione.