Questo documento descrive come trovare, filtrare ed escludere le voci di log che fanno parte dei gruppi di errori quando utilizzi Esplora log. I gruppi di errori ti aiutano a identificare le tendenze e i problemi ricorrenti nel tuo ambiente raggruppando le voci di log che contengono errori in base a valori come il tipo di eccezione, i frame o i messaggi.
Trovare i dettagli del gruppo di errori per una voce di log
Per monitorare gli errori ricorrenti nella tua applicazione e gestirne lo stato di risoluzione status, utilizza la pagina Error Reporting della Google Cloud console. La pagina Error Reporting elenca i gruppi di errori, incluse informazioni sul tipo specifico di errore, sul numero di occorrenze di errori e sullo stato di risoluzione di ogni gruppo.
Error Reporting imposta automaticamente il valore del campo ID error_groups durante la creazione di un gruppo di errori. Il campo contiene caratteri alfanumerici, - e _.
Trovare le voci di log per un gruppo di errori da Error Reporting
Se stai visualizzando la pagina Error Reporting e vuoi trovare le voci di log associate a un gruppo di errori specifico, procedi nel seguente modo:
-
Nella Google Cloud console, vai alla pagina Error Reporting:
Puoi trovare questa pagina anche utilizzando la barra di ricerca.
- Fai clic sul nome dell'errore.
Nel riquadro Esempi recenti, fai clic su Visualizza log in una qualsiasi voce di log.
Si apre la pagina Esplora log e vengono visualizzate le voci di log associate al gruppo di errori. Il campo dell'editor di query specifica l'ID del gruppo di errori. Ad esempio, questo campo potrebbe includere qualcosa di simile a
errorGroups.id="ERROR_GROUP_ID", dove ERROR_GROUP_ID è l'ID del gruppo di errori.
Filtrare le voci di log per gruppo di errori
Se stai visualizzando la pagina Esplora log e vuoi trovare le voci di log associate a un errore specifico o a un gruppo di errori, procedi nel seguente modo:
-
Nella Google Cloud console, vai alla pagina segmento Esplora log:
Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.
Esegui una delle seguenti operazioni:
Per trovare le voci di log associate a un gruppo di errori, aggiungi quanto segue al riquadro della query:
errorGroups.id:*Per trovare le voci di log associate a un gruppo di errori specifico, aggiungi quanto segue al riquadro della query:
errorGroups.id: "ERROR_GROUP_ID"
Esegui la query.
Esaminare il gruppo di errori di una voce di log
Per aprire il gruppo di errori per una voce di log, seleziona
Gruppo di errori, quindi seleziona
Visualizza dettagli gruppo di errori:
Puoi anche utilizzare le opzioni del pulsante
Gruppo di errori per modificare le voci di log visualizzate da Esplora log:
Per esaminare il gruppo di errori in modo più dettagliato, seleziona Mostra voci in questo gruppo di errori. Esplora log viene aggiornato e mostra solo le voci di log nello stesso gruppo di errori. Ora puoi applicare parametri di ricerca aggiuntivi alle voci di log del gruppo di errori.
Per rimuovere un gruppo di errori specifico dai risultati della query, seleziona Nascondi voci in questo gruppo di errori. Esplora log viene aggiornato e tutte le voci di log in questo gruppo di errori vengono nascoste dalla visualizzazione.
Monitorare i gruppi di errori
Puoi configurare Error Reporting in modo che ti invii una notifica quando rileva un nuovo gruppo di errori. Questo servizio ti consente anche di visualizzare la cronologia degli errori per ogni gruppo di errori e di gestirli. Per ulteriori informazioni, consulta i seguenti documenti:
Non puoi creare metriche basate sui log che conteggiano il numero di voci di log con gruppi di errori né configurare un avviso basato sui log per ricevere una notifica quando una voce di log contiene un gruppo di errori. Allo stesso modo, non puoi estrarre i valori dal campo errorGroups in un'etichetta collegata a una metrica basata sui log o a un avviso basato sui log.