Metriche basate su log a livello di bucket

Questo documento riassume le caratteristiche delle metriche basate su log con ambito del bucket e descrive le differenze rispetto alle metriche basate su log con ambito del progetto.

Caratteristiche delle metriche basate su log a livello di bucket

Le metriche basate su log con ambito del bucket sono metriche basate su log definite dall'utente che valutano le voci di log inviate a un bucket dei log specifico. Con le metriche basate su log con ambito del bucket, puoi creare metriche basate su log che estraggono i dati dai log nei seguenti casi:

  • Log instradati da un progetto a un bucket in un altro progetto.
  • Log inviati a un bucket tramite un sink aggregato.

Come le metriche basate su log con ambito di progetto, le metriche basate su log con ambito di bucket vengono definite all'interno di un progetto Google Cloud, non a livello di cartella o organizzazione. Se vuoi monitorare la cartella o l'organizzazione da cui una voce di log è stata instradata al bucket, puoi definire le etichette nella metrica basata su log per registrare queste informazioni.

Le metriche basate su log con ambito a livello di bucket presentano diverse differenze rispetto alle metriche basate su log con ambito a livello di progetto.

Progetti e ambiti delle metriche

Le metriche basate su log con ambito di bucket sono definite nello stesso progetto che contiene il bucket di origine. Per impostazione predefinita, solo il progetto che definisce una metrica basata su log con ambito del bucket può visualizzare i dati delle metriche per il bucket di log. Tuttavia, se il tuo progetto è incluso nell'ambito delle metriche di altri progetti, anche questi progetti possono visualizzare le tue metriche.

I progetti Google Cloud che indirizzano i log al bucket non devono essere nell'ambito delle metriche di nessun progetto.

Per ulteriori informazioni sulle metriche basate su log e sugli ambiti delle metriche, consulta Visibilità agli ambiti delle metriche.

Quando i log vengono ricevuti nel bucket, i dati delle metriche dei log instradati sono visibili a qualsiasi progetto che include il progetto del bucket nell'ambito delle metriche. Se i log di routing di un progetto non rientrano nell'ambito delle metriche di nessun progetto, le altre informazioni nel progetto di routing non sono visibili.

Quando utilizzi le metriche basate su log a livello di bucket, si applicano le seguenti istruzioni:

  • La metrica basata su log viene definita nel progetto con il bucket di destinazione.
  • Le metriche basate su log con ambito del bucket valutano tutte le voci di log instradate al bucket, indipendentemente dal fatto che il log provenga dallo stesso progetto del o da un progetto diverso.
  • I dati delle metriche sono visibili a qualsiasi altro progetto che includa il progetto con il bucket nell'ambito delle metriche.
  • I log di instradamento dei progetti non devono rientrare nell'ambito delle metriche di nessun progetto.

Tipo di risorsa monitorata: logging_bucket

Le metriche basate su log a livello di bucket utilizzano il tipo di risorsa monitoratalogging_bucket quando scrivono i dati delle serie temporali in Cloud Monitoring. Il tipo di risorsa logging_bucket include le seguenti etichette:

  • project_id: l'identificatore del tuo progetto Google Cloud, una stringa come my-test-project.
  • bucket_id: il nome del bucket dei log associato alla metrica basata su log, una stringa come my-test-bucket.
  • location: la posizione del bucket di log.
  • monitored_resource_type: il tipo di risorsa monitorata che ha prodotto questa voce di log. Il valore proviene dal campo type della struttura MonitoredResource contenuta nel campo resource della voce di log.
  • source_resource_container: l'identificatore del progetto, della cartella o dell'organizzazione da cui è stata inviata la voce di log, una stringa in uno dei seguenti formati:
    • projects/PROJECT_ID
    • organizations/ORGANIZATION_ID
    • folders/FOLDER_ID