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 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 dati dai log nei seguenti casi:

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

Analogamente alle metriche basate su log con ambito a livello di progetto, quelle 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 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 bucket vengono 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 bucket può vedere i dati della metrica per il bucket di log. Tuttavia, se il progetto compare nell'ambito delle metriche di altri progetti, anche questi ultimi possono visualizzare le metriche.

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

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

Quando i log vengono ricevuti nel bucket, i dati delle metriche di log instradate derivati 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 con ambito di bucket, si applicano le seguenti istruzioni:

  • Puoi definire 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 nell'ambito delle metriche.
  • I log di routing dei progetti 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 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 progetto Google Cloud, 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 della risorsa monitorata che ha generato 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