Metriche basate su log a livello di bucket

Questo documento riassume le caratteristiche delle metriche basate su log con ambito di bucket e descrive in che modo differiscono dalle metriche basate su log con ambito di progetto.

Caratteristiche delle metriche basate su log con ambito bucket

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

  • Log indirizzati da un progetto a un bucket in un altro progetto.
  • Log indirizzati 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 sono definite all'interno di un progetto, non a livello di cartella o organizzazione. Google Cloud Se vuoi monitorare la cartella o l'organizzazione da cui una voce di log è stata instradata al bucket, puoi definire etichette nella metrica basata su log per registrare queste informazioni.

Le metriche basate su log con ambito bucket presentano diverse differenze rispetto alle metriche basate su log con ambito 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 di bucket può visualizzare i dati della metrica per il bucket di log. Tuttavia, se il tuo progetto viene visualizzato nell'ambito delle metriche di altri progetti, anche questi progetti possono visualizzare le tue metriche.

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

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

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

Quando utilizzi metriche basate su log con ambito bucket, si applicano le seguenti istruzioni:

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

Tipo di risorsa monitorata: logging_bucket

Le metriche basate su log con ambito bucket utilizzano il tipo di risorsa monitorata logging_bucket durante la scrittura dei 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 sui log, una stringa come my-test-bucket.
  • location: La posizione del bucket dei 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