Questa pagina fornisce una panoramica concettuale delle metriche basate su log.
Le metriche basate su log possono aiutarti a osservare tendenze e pattern in un volume elevato di voci di log. Queste metriche derivano dalle voci di log che hanno origine nel tuo progetto Google Cloud o che vengono indirizzate progetto Google Cloud da un sink in un altro progetto. Ad esempio, puoi utilizzare una metrica basata su log per conta il numero di voci di log che contengono un determinato messaggio o per estrarre le informazioni sulla latenza registrate nelle voci di log. Puoi visualizzare le metriche basate su log nei grafici e negli avvisi di Cloud Monitoring possono monitorare queste metriche.
Se prevedi di creare un criterio di avviso per monitorare una metrica basata su log, assicurati di aver compreso i limiti di questo approccio. In particolare, recensione Risoluzione dei problemi: nella metrica mancano i dati dei log.
Origini delle metriche basate su log
Puoi usare le metriche definite da Cloud Logging per raccogliere l'utilizzo generale e definire una metrica basata su log per acquisire informazioni specifici per la tua applicazione o attività.
Le metriche basate su log possono essere applicate all'interno di un singolo progetto Google Cloud o all'interno di un log di sincronizzare la directory di una VM con un bucket. Non puoi creare le metriche basate su log per altre risorse Google Cloud, come Organizzazioni o account di fatturazione Cloud.
Per informazioni sulle differenze tra le metriche basate su log basate su progetti e bucket basate su log, consulta Metriche basate su log con ambito bucket.
Metriche definite dal sistema
Il logging fornisce un insieme di metriche per i valori di utilizzo, come di voci di log archiviate nei bucket di log nel progetto, oppure ovvero il numero di byte esportati. Per un elenco completo delle metriche definite dal sistema, consulta Metriche di Google Cloud: logging.
Metriche definite dall'utente
Puoi creare metriche basate su log definite dall'utente per e monitorare altre metriche importanti per il tuo progetto. Per Ad esempio, puoi creare una metrica basata su log per contare il numero di log che corrispondono a un determinato filtro.
Per impostazione predefinita, le metriche basate su log definite dall'utente vengono calcolate a partire da tutti i log ricevute dall'API Logging per il progetto Google Cloud, indipendentemente dai filtri di inclusione o filtri di esclusione che potrebbero essere applicati ai progetto Google Cloud.
Puoi anche creare metriche basate su log definite dall'utente per uno specifico bucket di log in un progetto Google Cloud. Con ambito bucket le metriche basate su log vengono calcolate da tutti i log destinati al bucket, indipendentemente da dove hanno avuto origine. Per ulteriori informazioni, vedi Metriche basate su log nei bucket di log.
Tipi di dati per le metriche basate su log
Le metriche basate su log possono estrarre dati dai log per creare metriche del i seguenti tipi:
- Contatore: queste metriche contano il numero di voci di log che corrispondono a un filtro specificato in un determinato periodo. Utilizza i contatori quando vuoi conservare tiene traccia del numero di volte in cui un valore o una stringa viene visualizzato nei log.
- Distribuzione: anche queste metriche contano i valori, ma raccolgono i esegue il conteggio in intervalli di valori (bucket di istogrammi). Utilizza le distribuzioni quando vuoi estrarre valori come le latenze.
- Booleano: queste metriche rilevano se una voce di log corrisponde o meno a un valore filtro.
Le metriche basate su log definite dall'utente possono essere di tipo contatore o distribuzione di testo. La maggior parte delle metriche basate su log definite dal sistema sono contatori, ma alcune di tipo booleano. Le caratteristiche dei contatori e delle distribuzioni descritti più dettagliatamente nelle sezioni successive.
I dati di una metrica basata su log definita dall'utente provengono solo dalle voci di log ricevuta dopo la creazione della metrica. Una metrica non è retroattiva viene compilato con i dati delle voci di log già presenti in Logging.
Le metriche basate su log di sistema vengono calcolate solo dai log inclusi. Definito dall'utente le metriche basate su log vengono calcolate a partire dai log di inclusione ed esclusione.
Il logging accumula ogni volta informazioni per una metrica basata su log riceve una voce di log corrispondente. Logging scrive un nuovo punto dati alle serie temporali della metrica alla frequenza di 1 punto dati al minuto, in modo che il i dati disponibili per Cloud Monitoring.
Ciascun punto dati nella serie temporale di una metrica basata su log rappresenta solo il informazioni aggiuntive (il delta) ricevute dal punto dati precedente.
Le seguenti sezioni descrivono le caratteristiche di controtipo e metriche di tipo distribuzione.
Metriche contatore
Le metriche del contatore contano il numero di voci di log corrispondenti a un determinato filtro. Per Ecco un esempio:
- Conta le voci di log che contengono un determinato messaggio di errore specifico.
Conta il numero di volte in cui ogni utente richiama un'operazione, cercando il log messaggi che corrispondono a questo pattern:
... user USERNAME called OPERATION ...
Estrai i campi USERNAME e OPERATION e li utilizza come valori per due etichette, in seguito potrai chiedere: "Quante volte
sally
chiamare l'operazioneupdate
?", "Quante persone hanno chiamatoread
operativa?", "Quante voltegeorge
ha chiamato un'operazione?" e così via.
Per ulteriori informazioni, consulta Configurare le metriche dei contatori.
Metriche di distribuzione
Le metriche di distribuzione accumulano dati numerici dalle voci di log corrispondenti a un filtro. Le metriche contengono una serie temporale di oggetti di distribuzione, ciascuno che contiene:
- Un conteggio del numero di valori nella distribuzione.
- Media dei valori.
- La somma delle deviazioni al quadrato: Sommai=1..n(xi-media)2
- Un insieme di bucket di istogrammi con il conteggio dei valori in ciascun bucket. Puoi usa il layout predefinito del bucket o scegline uno tuo.
Un uso comune delle metriche di distribuzione è il monitoraggio delle latenze. Ogni voce di log , viene estratto un valore di latenza da qualche parte nella voce di log e aggiunti alla distribuzione. A intervalli regolari, la distribuzione accumulata è vengono scritte in Cloud Monitoring.
Per informazioni sulle distribuzioni, incluso il formato in una serie temporale e come vengono visualizzati, vedi Creare grafici delle metriche di distribuzione.
Per informazioni sulla creazione di metriche basate su log di distribuzione, consulta Configurare le metriche di distribuzione.
Tipi di risorse
Consigliamo di fare in modo che le metriche basate su log specifichino un unico tipo di risorsa. Questa specifica garantisce che i dati delle serie temporali generati per i tuoi la metrica basata su log corrisponde al modello dei dati previsto da Cloud Monitoring. Semplifica inoltre il processo di creazione di grafici e criteri di avviso, poiché non c'è ambiguità su quali dati delle serie temporali vengano tracciati o monitorati.
Considera una metrica basata su log con il seguente filtro:
severity>="ERROR"
resource.type="gce_instance"
Cloud Monitoring riconosce che questi dati sono per Compute Engine di un'istanza VM. Pertanto, quando crei un grafico per un'istanza VM, la metrica basata su log è elencata come opzione nei menu. Quando creare un grafico per un tipo di risorsa diverso, la metrica basata su log non è elencata tra le opzioni.
Se crei una metrica basata su log senza specificare un tipo di risorsa, Monitoring elenca la metrica basata su log come opzione per più tipi di risorse, anche se non conteggi le voci da quelle risorse.
Etichette
Le metriche basate su log possono avere etichette, che consentono più serie temporali da raccogliere per la metrica. I valori delle etichette vengono estratti dai campi nelle voci di log corrispondenti. Logging registra serie temporali separate per ogni combinazione di valori di etichette.
Tutte le metriche basate su log forniscono un'etichetta log
predefinita.
Questa etichetta contiene il valore della parte LOG_ID del
logName
nella voce di log, ad esempio,
cloudresourcemanager.googleapis.com%2Factivity
.
Le metriche basate su log di sistema hanno valori predefiniti etichette che non possono essere modificate. Tuttavia, puoi personalizzare le etichette metriche definite dall'utente. Ad esempio, puoi utilizzare le etichette nella metrica basata su log per registrare la cartella organizzazione da cui ha avuto origine una voce di log, anche se con ambito bucket non è possibile creare metriche basate su log per cartelle o organizzazioni. Per ulteriori informazioni informazioni, consulta Etichette delle metriche basate su log.
Grafici e criteri di avviso in Cloud Monitoring
Puoi utilizzare metriche basate su log di sistema e definite dall'utente in Cloud Monitoring per creare grafici e criteri di avviso. Per ulteriori informazioni informazioni, vedi Metriche basate su log per elenchi e grafici ed Avviso sulle metriche basate su log.
In Cloud Monitoring, le metriche basate su log utilizzano i seguenti pattern di denominazione:
- Sistema:
logging.googleapis.com/SYSTEM_METRIC_NAME
- Definito dall'utente:
logging.googleapis.com/user/USER_METRIC_NAME
Tieni presente che le metriche definite dall'utente basate su log includono la stringa user
.
Visibilità sugli ambiti delle metriche di Monitoring
Le metriche basate su log vengono importate da Cloud Monitoring e la visibilità dei dati delle metriche a un progetto Google Cloud è determinato da un ambito delle metriche. Un ambito delle metriche è un elenco di progetti monitorati dal progetto che ospita l'ambito delle metriche, il progetto di hosting è chiamato progetto di ambito.
Per impostazione predefinita, ogni progetto ospita un ambito delle metriche include solo se stesso, quindi un progetto è un progetto che definisce l'ambito a sé stante. Di conseguenza, le tue metriche, incluse quelle basate su log, sono visibili solo al tuo progetto Google Cloud.
Puoi anche creare un ambito delle metriche multiprogetto per il progetto di definizione dell'ambito. Con un ambito delle metriche multiprogetto, il progetto di definizione dell'ambito può visualizzare le metriche di tutti i progetti nell'ambito delle metriche. Ciò che è visibile ai singoli progetti in un l'ambito delle metriche multiprogetto è determinato dall'ambito delle metriche ospitati da ciascuno di questi progetti. Il fatto che due progetti si trovino l'ambito delle metriche multiprogetto non significa che ogni progetto ha accesso la metrica o i dati di configurazione nell'altro progetto.
Un singolo progetto può essere visualizzato anche in più ambiti delle metriche. Le metriche di un progetto di questo tipo sono visibili i progetti di definizione dell'ambito per ciascuno di questi ambiti delle metriche.
Le metriche, incluse quelle basate su log, sono definite all'interno di un progetto specifico. Quando il progetto viene visualizzato in più ambiti delle metriche, le metriche sono visibili a progetti diversi da quello in cui sono definito. Per informazioni su come gli ambiti delle metriche e quelli con ambito a livello di bucket basati su log per interagire, consulta Ambiti di progetti e metriche.
Per ulteriori informazioni sugli ambiti delle metriche, inclusi gli ambiti multiprogetto gli ambiti delle metriche e la definizione dell'ambito dei progetti, consulta quanto segue:
Prezzi
Tutte le metriche definite dall'utente basate su log sono una classe Le metriche personalizzate di Cloud Monitoring sono addebitabili. Per informazioni sui prezzi, consulta Prezzi di Cloud Logging: metriche basate su log.
Quota
Per informazioni su quote e limiti associati ai valori definiti dall'utente metriche basate su log, consulta Quote e limiti.
Risoluzione dei problemi
In caso di problemi durante l'utilizzo delle metriche basate su log, consulta Risolvi i problemi relativi alle metriche basate su log.