Questa pagina è stata tradotta dall'API Cloud Translation.

Configura le metriche dei contatori

Questo documento spiega come creare una metrica di tipo contatore basata su log utilizzando: la console Google Cloud, l'API Logging e Google Cloud CLI.

Le metriche del contatore contano i numero di voci di log corrispondenti a un determinato filtro. Ad esempio, puoi creare un'etichetta metrica basata su log che conta il numero di voci di log contenenti una specifica . Le metriche basate su log possono essere applicate all'interno di un singolo progetto Google Cloud o all'interno di un bucket di log.

Per una panoramica delle metriche basate su log, consulta Panoramica delle metriche basate su log.

Prima di iniziare

Per usare le metriche basate su log, devi avere un progetto Google Cloud con Fatturazione abilitata:
Assicurati che il ruolo Identity and Access Management includa le autorizzazioni necessarie per creare e visualizzare metriche basate su log e creare criteri di avviso. Per maggiori dettagli, vedi Autorizzazioni per le metriche basate su log.

Crea una metrica di tipo contatore basata su log

La metrica conta le voci di log identificate da un filtro che fornisci. Puoi utilizzare espressioni regolari nel filtro. Consigliamo di includere un tipo di risorsa. La di un filtro non può superare i 20.000 caratteri.

Non inserire informazioni sensibili nel filtro. I filtri vengono trattati come dati dei servizi.

Console

Per creare una metrica contatore nel Console Google Cloud nel tuo progetto Google Cloud:

Nella console Google Cloud, vai alla pagina Metriche basate su log:
Vai a Metriche basate su log

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.
Fai clic su Crea metrica. Viene visualizzato il riquadro Crea metrica di log.
Imposta il Tipo di metrica: seleziona Contatore.
Imposta i seguenti campi nella sezione Details (Dettagli):
- Nome metrica di log: scegli un nome univoco tra i di metriche basate su log nel tuo progetto Google Cloud. Alcune denominazioni sono previste limitazioni; vedi Risoluzione dei problemi per maggiori dettagli.
- Descrizione: inserisci una descrizione per la metrica.
- Unità: lascia vuoto questo campo o inserisci la cifra 1.
Definisci il filtro delle metriche nella sezione Selezione filtro.
1. Utilizza Seleziona ambito di log per scegliere se il filtro deve essere indirizzato a tutti del tuo progetto Google Cloud o solo quelli di un bucket specifico.
2. Crea un filtro che raccolga solo le voci di log che vuoi conservare conteggio nella metrica utilizzando linguaggio di query di logging. Tu puoi anche utilizzare espressioni regolari per creare i filtri della metrica.
3. Per vedere quali voci di log corrispondono al filtro, fai clic su Anteprima log.
(Facoltativo) Aggiungi un'etichetta nella sezione Etichette. Per istruzioni su sulla creazione delle etichette, consulta la sezione Creazione di un'etichetta.
Fai clic su Crea metrica per creare la metrica.

gcloud

Puoi creare una metrica basata su log senza etichette personalizzate utilizzando il metodo seguente comando:

gcloud logging metrics create metric_name \
  --description="METRIC_DESCRIPTION" \
  --log-filter="FILTER" \
  [--bucket-name="BUCKET_NAME"]

Ad esempio, il comando seguente crea una metrica basata su log con ambito a livello di progetto chiamato error_count.

gcloud logging metrics create error_count \
     --description "Errors in syslog." \
     --log-filter "resource.type=gce_instance AND log_id(\"syslog\") AND severity>=ERROR"

Per creare invece una metrica basata su log con ambito di bucket, fornisci la --bucket_name flag:

gcloud logging metrics create error_count \
    --description "Errors in syslog." \
    --log-filter "resource.type=gce_instance AND log_id(\"syslog\") AND severity>=ERROR" \
    --bucket-name projects/my-project/locations/global/buckets/my-test-bucket

Per istruzioni su sulla creazione delle etichette, consulta la sezione Creazione di un'etichetta.

API

Per creare una metrica del contatore, utilizza il metodo projects.metrics.create di l'API Logging. Puoi provare il metodo in Explorer API. Prepara gli argomenti come segue:

Imposta il campo parent sul progetto o sul bucket in cui la metrica è da creare:
- Per una metrica basata su log con ambito a livello di progetto, specifica il progetto:
```
projects/PROJECT_ID
```
- Per una metrica basata su log con ambito a livello di bucket, specifica il bucket:
```
projects/PROJECT_ID/locations/LOCATION/bucket/BUCKET_ID
```

Imposta il corpo della richiesta su un oggetto LogMetric. La persona che segue è un esempio per una metrica contatore:

{
  name:        "my-metric"
  description: "This is my metric."
  filter:      "resource.type=gce_instance AND log_id(\"syslog\")",
  metricDescriptor: {
      labels: [
        {
          key: "my-label",
          valueType: STRING,
          description: "This is my label.",
        }
      ]
  },
  labelExtractors: {
    "my-label":
      "REGEXP_EXTRACT(jsonPayload.someField, \"before ([0-9]+) after\")",
    ...
  },
}

Note:

Scegli un nome di metrica univoco tra le metriche basate su log in del progetto. Si applicano alcune limitazioni di denominazione. vedi Risoluzione dei problemi per maggiori dettagli.
Per le metriche contatore, i campi LogMetric valueExtractor e bucketOptions non hanno uno scopo e vengono omessi.
Se la metrica non ha etichette, puoi omettere metricDescriptor e labelExtractors campi. Se la metrica ha etichette, Consulta le etichette delle metriche basate su log per un'introduzione alle etichette e i dettagli sulla loro creazione nell'API.

Per maggiori dettagli, consulta il tipo LogMetric.

Latenza delle nuove metriche

La nuova metrica viene visualizzata nell'elenco delle metriche di Esplora log e in ai relativi menu di Monitoring. I dati sono solitamente disponibile in meno di un minuto.

Ispeziona le metriche basate su log

Per elencare le metriche basate su log definite dall'utente nel progetto Google Cloud o per una determinata metrica nel tuo progetto Google Cloud, segui questi passaggi:

Console

Nella console Google Cloud, vai alla pagina Metriche basate su log:
Vai a Metriche basate su log

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.
Nel riquadro Metriche definite dall'utente, puoi vedere le metriche definite dall'utente nell'attuale progetto Google Cloud:
Per visualizzare i dati in una metrica basata su log, fai clic sull'icona Menu in riga della metrica e seleziona Visualizza in Esplora metriche.

gcloud

Per elencare le metriche basate su log definite dall'utente nel tuo progetto Google Cloud, utilizza questo comando:

gcloud logging metrics list

Per visualizzare una metrica basata su log definita dall'utente nel tuo progetto Google Cloud: utilizza questo comando:

gcloud logging metrics describe metric_name

Per ricevere assistenza, utilizza questo comando:

gcloud logging metrics --help

Non puoi leggere i dati delle serie temporali di una metrica da Google Cloud CLI.

API

Elenca metriche

Per elencare le metriche basate su log definite dall'utente in un progetto Google Cloud, usa il metodo API projects.metrics.list. Compila i parametri nella sezione come segue:

parent: il nome della risorsa del progetto Google Cloud. projects/PROJECT_ID.
pageSize: il numero massimo di risultati.
pageToken: ottiene la pagina successiva di risultati. Per informazioni sull'utilizzo dei token di pagina, vedi projects.metrics.list.

Recuperare le definizioni delle metriche

Per recuperare una singola metrica basata su log definita dall'utente, utilizza il metodo projects.metrics.get. Compila i parametri del metodo come indicato di seguito. che segue:

metricName: il nome risorsa della metrica:
```
projects/PROJECT_ID/metrics/METRIC_ID
```

Lettura dei dati delle metriche

Per leggere i dati delle serie temporali in una metrica basata su log, utilizza in projects.timeseries.list nel l'API Cloud Monitoring. Per maggiori dettagli sui dati delle serie temporali, consulta Lettura di serie temporali.

Per leggere una singola metrica basata su log definita dall'utente, compila il campo con questo tipo di metrica e identificatore:

logging.googleapis.com/user/METRIC_ID

Aggiorna le metriche basate su log

Puoi modificare una metrica basata su log definita dall'utente per cambiarne descrizione, filtro e i nomi dei campi a cui viene fatto riferimento nella metrica. Puoi aggiungere nuove etichette al e modificare le espressioni regolari utilizzate per estrarre i valori per la e le relative etichette. Se utilizzi una metrica con ambito a livello di bucket, puoi anche aggiornare il bucket della metrica.

Non puoi modificare i nomi o i tipi di metriche basate su log definite dall'utente o le relative etichette e non puoi eliminare le etichette esistenti in una metrica basata su log.

Per modificare una metrica basata su log:

Console

Nella console Google Cloud, vai alla pagina Metriche basate su log:
Vai a Metriche basate su log

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.
Fai clic su Modifica metrica nella Menu per la metrica basata su log che vuoi modificare.
Modifica gli elementi consentiti nella metrica.
Fai clic su Aggiorna metrica.

gcloud

Utilizza Google Cloud CLI per modificare la descrizione e il filtro di una metrica contatore la query e il bucket. Puoi aggiornare uno o tutti i campi contemporaneamente.

gcloud logging update metric_name \
  --description="METRIC_DESCRIPTION" \
  --log-filter="FILTER" \
  --bucket-name=BUCKET_NAME

Se modifichi il bucket associato a una metrica con ambito bucket, i dati delle metriche raccolti prima della modifica non riflettono più configurazione attuale. I dati delle metriche raccolti per il bucket precedente non viene rimosso.

Per aggiornare le metriche di distribuzione o altri campi delle metriche contatore, escludendo le metric_name, crea un file contenente la specifica aggiornata di il tuo LogMetric in formato JSON o YAML. Quindi, aggiorna chiamando il comando update con il campo --config-from-file, sostituendo FILENAME con il nome del tuo file JSON o YAML:

gcloud logging update metric_name --config-from-file FILENAME

Per maggiori dettagli, utilizza il comando seguente:

gcloud logging metrics update --help

API

Per modificare una metrica basata su log, utilizza la projects.metrics.update nell'API. Imposta i campi come segue:

metricName: il nome completo della risorsa della metrica:

projects/PROJECT_ID/metrics/METRIC_ID

Ad esempio:

projects/my-gcp-project/metrics/my-error-metric

Nel corpo della richiesta, includi un oggetto LogMetric che è esattamente uguale alla metrica esistente, ad eccezione del parametro le modifiche e le aggiunte che vuoi apportare.

Elimina metriche basate su log

Per eliminare una metrica basata su log definita dall'utente:

Console

Nella console Google Cloud, vai alla pagina Metriche basate su log:
Vai a Metriche basate su log

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.
Seleziona la metrica da eliminare e fai clic su Elimina.

In alternativa, fai clic su Elimina metrica nel menu della metrica basata su log che vuoi eliminare.

gcloud

Utilizza il comando seguente per eliminare una metrica basata su log definita dall'utente nel progetto Google Cloud attuale:

gcloud logging metrics delete metric_name

For more details, use the following command:

gcloud logging metrics delete --help

API

Per eliminare una metrica basata su log definita dall'utente, utilizza projects.metrics.delete nell'API.

Inoltre, nella pagina Metrica basata su log della console Google Cloud, è presente anche Il riquadro Metriche definite dall'utente dell'interfaccia delle metriche basate su log fornisce altre funzionalità per aiutarti a gestire le metriche definite dall'utente sul tuo progetto Google Cloud. Consulta Riquadro delle metriche definite dall'utente per maggiori dettagli.