Metriche basate su log con ambito 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 di bucket

Le metriche basate su log con ambito di bucket sono metriche basate su log definite dall'utente che valutano le voci di log instradate a un bucket di log specifico. Con le metriche basate su log con ambito di 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 instradati in 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 Google Cloud progetto, non a livello di cartella o organizzazione Se vuoi monitorare la cartella o l'organizzazione da cui è stata instradata una voce di log al bucket, puoi definire le etichette nella metrica basata su log per registrare queste informazioni.

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

I Google Cloud progetti che instradano i log al bucket non devono essere inclusi 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 include il progetto del bucket nel suo ambito delle metriche. Se un progetto che instrada i log non è incluso nell'ambito delle metriche di alcun progetto, le altre informazioni nel progetto di routing non sono visibili.

Quando utilizzi le metriche basate su log con ambito di 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 include il progetto con il bucket nel suo ambito delle metriche.
  • I progetti che instradano i log non devono essere inclusi nell'ambito delle metriche di alcun progetto.

Tipo di risorsa monitorata: logging_bucket

Le metriche basate su log con ambito di bucket utilizzano il tipo di risorsa monitorata logging_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 Google Cloud progetto, una stringa come my-test-project.
  • bucket_id: il nome del bucket di log associato alla metrica basata su log, una stringa come my-test-bucket.
  • location: la località del bucket di log.
  • monitored_resource_type: il tipo di risorsa monitorata che ha generato questa voce di log; il valore proviene dal campo type della MonitoredResource struttura 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