Risolvi i problemi relativi alle metriche basate su log

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Questa pagina fornisce informazioni sulla risoluzione dei problemi per gli scenari comuni quando si utilizzano metriche basate su log in Cloud Logging.

Impossibile visualizzare o creare metriche

Le metriche basate su log si applicano solo a un singolo progetto Google Cloud. Non puoi crearle per i bucket Logging o per altre risorse Google Cloud, come organizzazioni o account di fatturazione. Le metriche basate su log vengono calcolate per i log solo nel progetto Cloud in cui vengono ricevuti.

Per creare metriche, devi disporre delle autorizzazioni corrette di Identity and Access Management. Per i dettagli, consulta Controllo dell'accesso con IAM: metriche basate su log.

Nella metrica mancano i dati dei log

Esistono diversi possibili motivi per cui mancano dati nelle metriche basate su log:

  • Le nuove voci di log potrebbero non corrispondere al filtro della metrica. Una metrica basata su log riceve i dati da voci di log corrispondenti ricevute dopo la creazione della metrica. Il logging non esegue il backfill della metrica dalle voci di log precedenti.

  • Le nuove voci di log potrebbero non contenere il campo corretto oppure i dati potrebbero non essere nel formato corretto per l'estrazione in base alla metrica di distribuzione. Verifica che i nomi dei campi e le espressioni regolari siano corretti.

  • Il conteggio delle metriche potrebbe subire ritardi. Anche se in Esplora log vengono visualizzate voci di log conteggiabili, potrebbero essere necessari fino a 10 minuti per aggiornare le metriche basate su log in Cloud Monitoring.

  • Le voci di log visualizzate potrebbero essere conteggiate in ritardo o potrebbero non essere conteggiate affatto, in quanto i timestamp sono troppo lontani nel passato o nel futuro. Se Cloud Logging riceve una voce di log più di 24 ore prima o dopo 10 minuti in futuro, la voce di log non viene conteggiata nella metrica basata su log.

    Il numero di voci in ritardo viene registrato per ciascun log nella metrica basata su log di sistema logging.googleapis.com/logs_based_metrics_error_count.

    Esempio: una voce di log corrispondente a una metrica basata su log arriva in ritardo. Ha un timestamp alle 14:30 del 20 febbraio 2020 e un receivedTimestamp delle 14:45 del 21 febbraio 2020. Questa voce non verrà conteggiata nella metrica basata su log.

  • La metrica basata su log è stata creata dopo l'arrivo delle voci di log che la metrica potrebbe conteggiare. Le metriche basate su log valutano le voci di log man mano che vengono importate in Logging; queste metriche non valutano le voci di log archiviate in Logging.

Il tipo di risorsa è "non definito" in Cloud Monitoring

Alcuni tipi di risorse monitorate di Cloud Logging non sono mappati direttamente ai tipi di risorse monitorate di Cloud Monitoring. Ad esempio, quando crei un avviso o un grafico da una metrica basata su log, potresti vedere che il tipo di risorsa è "undefined".

Il tipo di risorsa non è definito.

Il tipo di risorsa monitorata viene mappato a global o a un tipo di risorsa monitorata diverso in Cloud Monitoring. Consulta Mappings for Logging-only resources per determinare quale tipo di risorsa monitorata devi scegliere.

Avvisi falsi positivi o che non sono stati attivati

Potresti ricevere avvisi falsi positivi o avvisi che non vengono attivati dalle metriche basate su log perché il periodo di allineamento per l'avviso è troppo breve. Gli scenari comuni in cui un periodo di allineamento troppo breve causa problemi sono i casi in cui un avviso utilizza una logica minore di o è basato su una condizione percentile per una metrica di distribuzione.

Possono verificarsi falsi positivi perché le voci di log possono essere inviate a Logging in ritardo. Ad esempio, i campi di log timestamp e receiveTimestamp possono avere un delta di minuti in alcuni casi. Inoltre, quando Logging importa i log, si verifica un ritardo intrinseco tra il momento in cui vengono generate le voci di log e il momento in cui Logging le riceve. Ciò significa che Logging potrebbe non avere il conteggio totale per una determinata voce di log fino a un momento successivo dopo la generazione delle voci di log. Questo è il motivo per cui un avviso che utilizza una logica meno di o basata su una condizione percentile per una metrica di distribuzione può generare un avviso falso positivo: non sono state ancora prese in considerazione tutte le voci di log.

Tuttavia, le metriche basate su log sono sempre coerenti. Le metriche basate su log sono alla fine coerenti perché una voce di log che corrisponde a una metrica basata su log può essere inviata a Logging con un timestamp significativamente precedente o più recente rispetto a receiveTimestamp del log.

Ciò significa che la metrica basata su log può ricevere voci di log con timestamp precedenti dopo che le voci di log esistenti con lo stesso timestamp sono già state ricevute da Logging. Di conseguenza, il valore della metrica deve essere aggiornato.

Per garantire l'accuratezza degli avvisi anche per i dati puntuali, i criteri di avviso per le metriche basate su log dovrebbero utilizzare condizioni di avviso con periodi di allineamento superiori o uguali a due minuti. Per voci di log inviate a Logging con ritardi misurati in minuti, si consiglia un periodo di allineamento di dieci minuti per bilanciare la tempestività e l'accuratezza.

La metrica ha troppe serie temporali

Il numero di serie temporali in una metrica dipende dal numero di diverse combinazioni di valori etichetta. Il numero di serie temporali viene chiamato cardinalità della metrica e non deve superare le 30.000.

Poiché puoi generare una serie temporale per ogni combinazione di valori delle etichette, se hai una o più etichette con un numero elevato di valori, non è difficile superare le 30.000 serie temporali. Vuoi evitare metriche di cardinalità elevata.

Con l'aumentare della cardinalità di una metrica, la metrica può subire limitazioni e alcuni punti dati potrebbero non essere scritti. Il caricamento dei grafici che mostrano la metrica può essere lento a causa dell'elevato numero di serie temporali che il grafico deve elaborare. Potrebbero essere applicati costi per le chiamate API ai dati delle serie temporali; per i dettagli, consulta i costi di Cloud Monitoring.

Per evitare di creare metriche ad alta cardinalità:

  • Verifica che i campi delle etichette e le espressioni regolari dell'estrattore corrispondano ai valori con una cardinalità limitata.

  • Evita di estrarre gli SMS che possono cambiare, senza limiti, come valori delle etichette.

  • Evita di estrarre valori numerici con cardinalità senza limiti.

  • Estrai solo valori da etichette di cardinalità nota, ad esempio codici di stato con un insieme di valori noti.

Queste metriche basate su log di sistema possono aiutarti a misurare l'effetto dell'aggiunta o della rimozione delle etichette sulla cardinalità della metrica:

Quando esamini queste metriche, puoi filtrare ulteriormente i risultati in base al nome della metrica. Per maggiori dettagli, consulta la sezione Selezionare le metriche: filtro.

Il nome della metrica non è valido

Quando crei una metrica contatore o di distribuzione, scegli un nome di metrica univoco tra le metriche basate su log nel progetto Cloud.

Le stringhe dei nomi di metrica non devono superare i 100 caratteri e possono includere solo i seguenti caratteri:

  • A-Z
  • a-z
  • 0-9
  • I caratteri speciali _-.,+!*',()%\/.

    La barra / indica una gerarchia di parti all'interno del nome della metrica e non può essere il primo carattere del nome.

I valori delle etichette vengono troncati

I valori delle etichette definite dall'utente non devono superare i 1024 byte.

Impossibile eliminare una metrica di log personalizzata

Tenta di eliminare una metrica personalizzata basata su log utilizzando Google Cloud Console. La richiesta di eliminazione non va a buon fine e la finestra di dialogo di eliminazione mostra il messaggio di errore There is an unknown error while executing this operation.

Per risolvere il problema, prova quanto segue:

  • Aggiorna la pagina delle metriche basate su log in Google Cloud Console. Il messaggio di errore potrebbe essere visualizzato a causa di un problema di tempo interno.

  • Identifica ed elimina i criteri di avviso che monitorano la metrica basata su log. Dopo aver verificato che la metrica basata su log non sia monitorata da un criterio di avviso, elimina la metrica basata su log. Le metriche basate su log monitorate da un criterio di avviso non possono essere eliminate.