Panoramica degli ambiti di osservabilità

Questo documento descrive come configurare un progetto Google Cloud per monitorare o visualizzare i dati di telemetria di più progetti Google Cloud. Se vuoi solo monitorare o visualizzare i dati archiviati in un progetto Google Cloud, non devi eseguire alcuna configurazione, poiché gli strumenti di visualizzazione e analisi sono configurati per utilizzare i dati archiviati nel progetto Google Cloud selezionato dal selettore di progetti. Tuttavia, se i dati di telemetria che vuoi visualizzare o analizzare provengono da più progetti, per avere una vista aggregata di questi dati devi eseguire alcune attività di configurazione.

Informazioni sugli ambiti di osservabilità

Gli strumenti di analisi e visualizzazione di Google Cloud Observability si basano su ambiti specifici per tipo di dato per determinare quali dati visualizzare o analizzare. Un ambito definisce le risorse in cui viene eseguita la ricerca di un determinato tipo di dati. Ad eccezione dei dati delle metriche, i ruoli IAM (Identity and Access Management) nei progetti e nelle visualizzazioni dei log sottoposti a ricerca determinano i dati visualizzati.

Puoi configurare i seguenti ambiti:

Ambito di osservabilità

Questo ambito controlla il modo in cui le pagine di esplorazione e delle dashboard cercano i dati da visualizzare. Ogni progetto Google Cloud contiene un singolo ambito di osservabilità, che elenca l'ambito dei log predefinito, l'ambito delle metriche e l'ambito della traccia predefinito.

Consigliamo di configurare i componenti dell'ambito dell'osservabilità nei seguenti scenari:

  • Registra le applicazioni con App Hub. Potrebbero essere applicazioni registrate autonomamente o quelle di cui hai eseguito il deployment utilizzando Application Design Center.
  • Quando vuoi una visualizzazione unificata dei dati di telemetria archiviati in diversi progetti Google Cloud.

Se non configuri i componenti dell'ambito di osservabilità per un progetto, la pagina Esplora log mostra i dati dei log che hanno origine nel progetto. Le pagine Esplora metriche ed Esplora tracce possono visualizzare solo i dati archiviati nel progetto. Inoltre, i criteri di avviso possono monitorare solo i dati archiviati nel progetto.

Ambiti dei log

Configura l'ambito di log predefinito di un progetto in modo che, quando apri la pagina Esplora log, vengano visualizzati i dati che di solito vuoi visualizzare. Un ambito di log può elencare progetti, cartelle, organizzazioni e visualizzazioni di log. Ad esempio, puoi impostare l'ambito dei log predefinito in modo da elencare una visualizzazione dei log che, quando viene eseguita una query, restituisce i dati dei log per un'applicazione App Hub.

Puoi creare più ambiti di log. Quando utilizzi la pagina Esplora log, puoi selezionare un ambito dei log diverso, in modo che la pagina esegua una ricerca nelle risorse elencate nell'ambito selezionato, quindi aggiorna la visualizzazione.

Ti consigliamo di configurare l'ambito dei log predefinito nei seguenti scenari:

  • Indirizzi i dati dei log a un bucket di log centralizzato.
  • Indirizzi i dati dei log ad altri progetti o a bucket di log archiviati da un altro progetto.
  • Utilizzi le visualizzazioni log.

Per scoprire di più, consulta Creare e gestire gli ambiti dei log.

Ambito delle metriche

Configura l'ambito delle metriche in modo da elencare tutti i progetti che memorizzano i dati delle metriche, in modo che i grafici e i criteri di avviso possano visualizzare o monitorare una visualizzazione aggregata dei dati delle metriche.

Ogni progetto Google Cloud contiene un singolo ambito delle metriche, che per impostazione predefinita elenca solo il progetto.

Ti consigliamo di configurare l'ambito delle metriche quando si verifica una delle seguenti condizioni:

  • Vuoi creare un grafico dei dati archiviati in progetti diversi.
  • Vuoi un criterio di avviso per monitorare i dati archiviati in progetti diversi.
  • Registra le applicazioni con App Hub. Per informazioni su questo scenario, consulta Ambiti delle metriche per i progetti di gestione.

Per ulteriori informazioni, consulta la Panoramica degli ambiti delle metriche.

Ambiti delle tracce

Configura l'ambito della traccia predefinito in modo da elencare tutti i progetti che archiviano i dati di traccia, in modo che quando apri la pagina Esplora tracce, tu abbia una visualizzazione aggregata dei dati di traccia.

Puoi creare più ambiti di traccia. Quando utilizzi la pagina Esplora tracce, puoi selezionare un ambito della traccia diverso, in modo che la pagina esegua una ricerca nei progetti elencati nell'ambito selezionato e aggiorni la visualizzazione.

Ti consigliamo di configurare gli ambiti dei tracciati quando vuoi avere una panoramica unificata dei dati dei tracciati archiviati in progetti diversi.

Per scoprire di più, consulta la pagina Creare e gestire gli ambiti dei traccianti.

Prima di iniziare

Per ottenere le autorizzazioni necessarie per creare e visualizzare gli ambiti, chiedi all'amministratore di concederti i seguenti ruoli IAM:

  • Per creare e visualizzare gli ambiti dei log e per ottenere l'ambito predefinito dei log: Writer configurazione log (roles/logging.configWriter) nel tuo progetto
  • Per modificare un ambito delle metriche: Amministratore di monitoraggio (roles/monitoring.admin) nel tuo progetto e in ogni progetto che vuoi aggiungere agli ambiti delle metriche
  • Per creare e visualizzare gli ambiti traccia e per ottenere l'ambito traccia predefinito: Utente Cloud Trace (roles/cloudtrace.user) nel tuo progetto
  • Per ottenere e impostare gli ambiti predefiniti: Editor di osservabilità (roles/observability.editor) nel tuo progetto

Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per creare e visualizzare gli ambiti. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per creare e visualizzare gli ambiti sono necessarie le seguenti autorizzazioni:

  • Per configurare gli ambiti dei log: logging.logScopes.{create, delete, get, list, update}
  • Per configurare un ambito delle metriche: monitoring.metricsscopes.{link, get, list}
  • Per configurare gli ambiti di traccia: cloudtrace.traceScopes.{create, delete, get, list, update}
  • Per ottenere e impostare gli ambiti predefiniti: observability.scopes.{get, update}

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Configurare l'ambito dell'osservabilità

Questa sezione non si applica a cartelle o organizzazioni.

Se non configuri i componenti dell'ambito di osservabilità per un progetto, la pagina Esplora log mostra i dati dei log che hanno origine nel progetto. Le pagine Esplora metriche ed Esplora tracce possono visualizzare solo i dati archiviati nel progetto. Inoltre, i criteri di avviso possono monitorare solo i dati archiviati nel progetto.

Per i dati dei log e delle tracce, i ruoli IAM (Identity and Access Management) nel progetto visualizzato e gli eventuali progetti e visualizzazioni dei log sottoposti a ricerca determinano quali dati vengono visualizzati. Il tuo ruolo IAM nel progetto visualizzato determina se puoi visualizzare i dati delle metriche.

Console

Per configurare l'ambito di osservabilità, devi configurare i relativi componenti, ovvero l'ambito dei log predefinito, l'ambito delle metriche e l'ambito della traccia predefinito:

  1. Enable the Observability API.

    Enable the API

    Prima di attivare l'API, assicurati di selezionare il progetto corretto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella abilitata per le app.

  2. Nella console Google Cloud, vai alla pagina  Impostazioni:

    Vai a Impostazioni

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

  3. Nella barra degli strumenti della console Google Cloud, seleziona il tuo progetto Google Cloud. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella abilitata per le app.

  4. Configura l'ambito dei log predefinito:

    1. Seleziona la scheda Ampi dello log.

      Vengono elencati gli ambiti dei log esistenti. La voce con l'icona "Predefinito", , è l'ambito dei log predefinito. Se vuoi creare un ambito di log, fai clic su Crea ambito di log e poi completa la finestra di dialogo. Per ulteriori informazioni, consulta Creare e gestire gli ambiti dei log.

    2. Individua la voce che vuoi designare come predefinita, fai clic su  Altro e poi seleziona Imposta come predefinita.

  5. Configura l'ambito delle metriche:

    1. Seleziona la scheda Ambito delle metriche.
    2. Nel riquadro Progetti Google Cloud, fai clic su Aggiungi progetti e completa la finestra di dialogo. Per ulteriori informazioni, consulta Configurare gli ambiti delle metriche.
  6. Configura l'ambito della traccia predefinito:

    1. Seleziona la scheda Ampi dello tracciamento e segui questi passaggi:

      Vengono elencati gli ambiti di traccia esistenti. La voce con l'icona "Predefinito", , è l'ambito della traccia predefinito. Se vuoi creare un ambito di traccia, fai clic su Crea ambito log e completa la finestra di dialogo. Per scoprire di più, consulta la pagina Creare e gestire gli ambiti dei traccianti.

    2. Individua la voce che vuoi designare come predefinita, fai clic su  Altro e poi seleziona Imposta come predefinita.

REST

Non supportato per l'impostazione dell'ambito della traccia predefinito.

Per utilizzare l'API Observability per ottenere o impostare l'ambito dei log predefinito:

  1. Assicurati che l'API Observability sia abilitata:

    1. After installing the Google Cloud CLI, initialize it by running the following command:

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Imposta il progetto predefinito per Google Cloud CLI:

      gcloud config set project PROJECT_ID
      

      Prima di eseguire il comando precedente, sostituisci quanto segue:

      • PROJECT_ID: l'identificatore del progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella abilitata per le app.
    3. Enable the Observability API:

      gcloud services enable observability.googleapis.com
  2. Esegui una di queste operazioni:

    • Per ottenere l'ambito dei log predefinito per un progetto, invia una richiesta all'endpoint projects.locations.scopes.get. Devi specificare un parametro path. La risposta è un oggetto Scope che elenca l'ambito del log predefinito.

    • Per aggiornare l'ambito dei log predefinito per un progetto, invia una richiesta all'endpoint projects.locations.scopes.patch. Devi specificare un parametro path, i parametri di query e fornire un oggetto Scope. I parametri di query identificano i campi che vengono modificati. La risposta è un oggetto Scope.

      Il parametro path per entrambi gli endpoint ha la seguente forma:

      projects/PROJECT_ID/locations/LOCATION/scopes/OBSERVABILITY_SCOPE_ID
      

      I campi nell'espressione precedente hanno il seguente significato:

      • PROJECT_ID: l'identificatore del progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella abilitata per le app.
      • LOCATION: il campo Location deve essere impostato su global.
      • OBSERVABILITY_SCOPE_ID: il nome di un oggetto Scope. Questo campo deve essere impostato su _Default. L'oggetto Scope con il nome _Default memorizza le informazioni sull'ambito del log predefinito e viene creato automaticamente.