Configurare il monitoraggio delle applicazioni

Questo documento descrive come configurare Google Cloud Observability in modo da visualizzare la telemetria di un'applicazione registrata con App Hub. Puoi eseguire il deployment della tua applicazione e poi registrarla in App Hub oppure puoi eseguire il deployment delle tue applicazioni utilizzando Application Design Center. Il monitoraggio delle applicazioni può aiutarti a comprendere il rendimento delle tue applicazioni, dei tuoi servizi e dei tuoi workload.

Prima di iniziare

  • Identifica il progetto di cui configurerai l'ambito di osservabilità. Questo progetto è il progetto host di App Hub o il progetto di gestione delle cartelle abilitate per le app. Ad esempio, se il nome visualizzato della cartella è My Folder, il nome visualizzato del progetto di gestione è My Folder-mp.

  • Assicurati di disporre dei ruoli di Identity and Access Management (IAM) necessari per configurare l'ambito di osservabilità. I ruoli IAM richiesti dipendono dal fatto che tu preveda di creare un destinatario aggregato, che ti consente di centralizzare lo spazio di archiviazione dei dati dei log.

    Configura il sink e gli ambiti

    Per ottenere le autorizzazioni necessarie per configurare gli ambiti di osservabilità e creare un'area di destinazione dei log aggregata, chiedi all'amministratore di concederti il ruolo IAM Amministratore dell'organizzazione (roles/resourcemanager.organizationAdmin) nella tua organizzazione. Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

    Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

    Configura solo gli ambiti

    Per ottenere le autorizzazioni necessarie per configurare l'ambito di osservabilità, chiedi all'amministratore di concederti i seguenti ruoli IAM:

    • Observability Editor (roles/observability.editor) nel progetto host App Hub o nel progetto di gestione della cartella abilitata per le app
    • Logs Configuration Writer (roles/logging.configWriter) nel progetto hostApp Hub o nel progetto di gestione per la cartella abilitata per le app
    • Amministratore del monitoraggio (roles/monitoring.admin) nel progetto host App Hub o nel progetto di gestione della tua cartella abilitata per le app e in ogni progetto che vuoi aggiungere all'ambito delle metriche
    • Utente Cloud Trace (roles/cloudtrace.user) nel progetto hostApp Hub o nel progetto di gestione per la tua cartella abilitata per le app
    • App Hub Viewer (roles/apphub.viewer) nel progetto host App Hub o nel progetto di gestione della cartella abilitata per le app

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

    Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Configurare l'ambito dell'osservabilità

L'ambito di osservabilità controlla il modo in cui le pagine di esplorazione e della dashboard cercano i dati da visualizzare. Ogni progetto Google Cloud contiene un singolo ambito di osservabilità. Non configuri direttamente l'ambito di osservabilità di un progetto. Per il progetto, invece, devi configurare quanto segue:

  • L'ambito dei log predefinito

    Configura questo ambito in modo che, quando apri la pagina Esplora log o visualizzi le dashboard, vengano visualizzati i dati dei log della tua applicazione. Assicurati che questo ambito elenchi i progetti e le visualizzazioni dei log che memorizzano i dati dei log della tua applicazione.

  • L'ambito delle metriche

    Configura questo ambito in modo che i grafici, ad esempio quelli che crei utilizzando la pagina Esplora metriche, e i criteri di avviso possano visualizzare o monitorare i dati delle metriche della tua applicazione. Assicurati che questo ambito elenchi i progetti che archiviano i dati delle metriche della tua applicazione.

  • L'ambito della traccia predefinito

    Configura questo ambito in modo che, quando apri la pagina Esplora tracce, vengano visualizzati i dati di traccia della tua applicazione. Assicurati che questo ambito elenchi i progetti che memorizzano i dati di traccia della tua applicazione.

Il resto di questa sezione fornisce indicazioni su come configurare questi ambiti.

Configura e imposta l'ambito dei log predefinito

Esegui una di queste operazioni:

  • Se hai un sink aggregato a livello di organizzazione che invia tutti i dati dei log della tua organizzazione a un bucket di log centralizzato, ti consigliamo quanto segue:

    1. Crea una visualizzazione dei log nel bucket di log centralizzato per i log dell'applicazione.

    2. Nel progetto host di App Hub o nel progetto di gestione della cartella abilitata per le app, crea un ambito dei log e aggiungi la visualizzazione dei log, quindi imposta questo ambito come ambito dei log predefinito.

  • Se utilizzi una cartella abilitata per le app e non hai un ingorgo aggregato a livello di organizzazione o cartelle nidificate, ti consigliamo di procedere nel seguente modo:

    1. Crea un sink aggregato di intercettazione per la tua cartella abilitata per le app, e indirizza i log al _Default bucket dei log del progetto da cui visualizzerai i log.

    2. Nel progetto di gestione della tua cartella abilitata per le app, assicurati che l'ambito del log denominato _Default sia impostato come ambito del log predefinito. L'ambito denominato _Default elenca la visualizzazione _AllLogs nel bucket dei log _Default del progetto, ovvero la posizione di archiviazione centralizzata per l'applicazione.

  • Se non utilizzi un canale aggregato, per il progetto host App Hub o per il progetto di gestione della tua cartella abilitata per le app, configura l'ambito dei log predefinito per elencare le posizioni di archiviazione dei dati dei log della tua applicazione. Anziché aggiungere progetti all'ambito dei log, ti consigliamo di aggiungere visualizzazioni dei log ai bucket dei log che archiviano i dati dei log.

Configurare l'ambito delle metriche

Assicurati che l'ambito delle metriche per il progetto host App Hub o per il progetto di gestione della tua cartella abilitata per le app elenchi tutti i progetti che memorizzano i dati delle metriche della tua applicazione:

  • Per le cartelle con abilitazione app, Google Cloud Observability tenta di sincronizzare l'elenco dei progetti nella cartella con abilitazione app con l'elenco dei progetti nell'ambito delle metriche. Ad esempio, se aggiungi un progetto alla cartella abilitata per le app, viene emesso un comando per aggiungerlo all'ambito delle metriche.

    Quando il numero di progetti nella cartella abilitata per le app non supera la quota dell'ambito delle metriche, che per impostazione predefinita è pari a 375 progetti per ambito delle metriche, Google Cloud Observability può mantenere sincronizzato l'elenco dei progetti nell'ambito delle metriche con l'elenco dei progetti nella cartella abilitata per le app. Ad esempio, supponiamo che la quota sia di 375 progetti per ambito delle metriche. Se la cartella con l'app abilitata contiene 100 progetti, l'ambito delle metriche elenca tutti i progetti nella cartella con l'app abilitata. Se aggiungi progetti alla cartella abilitata per le app, questi vengono aggiunti anche all' ambito delle metriche.

    Quando il numero di progetti nella cartella abilitata per le app supera la quota dell'ambito delle metriche, l'elenco dei progetti nell'ambito delle metriche non includerà tutti i progetti nella cartella abilitata per le app. Ad esempio, supponiamo che la quota sia di 375 progetti per ambito delle metriche e che la cartella abilitata per le app contenga 380 progetti. Dopo aver aggiunto 375 progetti all'ambito delle metriche, la quota è esaurita e i tentativi di aggiungere i 5 progetti rimanenti non vanno a buon fine. Di conseguenza, alcuni dati dell'applicazione non sono disponibili per il tuo progetto di gestione.

    Ti consigliamo di esaminare l'utilizzo della quota dell'ambito delle metriche e di stabilire se devi richiedere un aggiornamento della quota o modificare manualmente l'ambito delle metriche. Per informazioni su questi passaggi, consulta Ambiti delle metriche per le cartelle abilitate per le app.

  • Per i progetti host di App Hub, devi configurare l'ambito delle metriche del progetto host.

    Se modifichi l'insieme di progetti che archiviano i dati delle metriche, devi anche aggiornare l'ambito delle metriche del progetto host.

Configura e imposta l'ambito della traccia predefinito

Segui questi passaggi:

  1. Nel progetto host App Hub o nel progetto di gestione della cartella abilitata per le app, crea un ambito di traccia e aggiungi i progetti che archiviano i dati traccia della tua applicazione. Se utilizzi una cartella abilitata per le app, aggiungi i progetti in quella cartella.

  2. Imposta l'ambito della traccia personalizzato come ambito della traccia predefinito.

Associare un criterio di avviso a un'applicazione App Hub

Per visualizzare i criteri di avviso dal contesto del monitoraggio delle applicazioni, devi associarli a un servizio o a un carico di lavoro aggiungendo etichette specifiche per l'applicazione al criterio di avviso. Queste etichette definite dall'utente vengono incluse anche in tutti gli incidenti creati per un criterio. Per scoprire di più sulle etichette, consulta Annotare gli incidenti con le etichette. Per un elenco delle etichette di App Hub, consulta Visualizzare la telemetria delle applicazioni.

Per associare un criterio di avviso a un carico di lavoro o a un servizio utilizzando la console Google Cloud, segui questi passaggi:

  1. Nella console Google Cloud, vai alla pagina  Avvisi:

    Vai ad Avvisi

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

  2. Nella barra degli strumenti della console Google Cloud, seleziona il progetto host di App Hub o il progetto di gestione per la tua cartella abilitata per le app.
  3. Individua il criterio di avviso, fai clic su Visualizza altro, selezionate Modifica e vai alla sezione Notifiche e nome.
  4. Nella sezione Etichette applicazione, seleziona l'applicazione e poi il carico di lavoro o il servizio.
  5. Fai clic su Salva criterio.

Al termine di questi passaggi, le etichette con le seguenti chiavi vengono associate al tuo criterio di avviso. Queste etichette identificano l'applicazione e il servizio o il carico di lavoro:

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id o apphub_workload_id

Puoi anche aggiungere etichette utente a un criterio di avviso utilizzando Google Cloud CLI, Terraform o l'API Cloud Monitoring. Tuttavia, devi utilizzare le chiavi delle etichette mostrate nell'esempio precedente. Per ulteriori informazioni, consulta le seguenti risorse:

Concedi l'accesso

IAM gestisce l'accesso ai dati di log, metriche e traccia. Questa sezione riassume i ruoli che potresti assegnare alle persone:

  • Accessore visualizzazione log (roles/logging.viewAccessor) nelle visualizzazioni log elencate nell'ambito log predefinito del progetto host App Hub o del progetto di gestione per la cartella abilitata per le app. Per scoprire di più su come concedere l'accesso a una visualizzazione dei log, consulta Controllare l'accesso a una visualizzazione dei log.

  • Logs Viewer (roles/logging.viewer) nel progetto host App Hub o nel progetto di gestione della cartella abilitata per le app e in tutti gli altri progetti elencati nell'ambito dei log predefinito. Questo ruolo concede l'accesso alla maggior parte delle voci di log nel bucket di log _Default. Per ulteriori informazioni, consulta Ruoli di logging.

  • Ruolo Editor di monitoraggio (roles/monitoring.editor) nel progetto host App Hub o nel progetto di gestione per la cartella abilitata per le app. Per i principali che non devono creare criteri di avviso, valuta la possibilità di concedere il ruolo Visualizzatore Monitoring (roles/monitoring.viewer).

  • Utente Cloud Trace (roles/cloudtrace.user) nel progetto host App Hub o nel progetto di gestione della tua cartella abilitata per le app e nei progetti elencati nell'ambito di traccia predefinito.

  • Visualizzatore di App Hub (roles/apphub.view) nel progetto host App Hub o nel progetto di gestione per la tua cartella abilitata per le app.

Passaggi successivi