Visualizza la telemetria dell'applicazione

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Questo documento descrive come visualizzare le dashboard pronte all'uso per le applicazioni, i servizi e i workload di App Hub. Queste dashboard possono aiutarti a comprendere il rendimento delle risorse della tua applicazione e a diagnosticare i problemi.

La telemetria visualizzata da queste dashboard OOTB include dati di log e metriche, nonché informazioni sugli incidenti aperti. Le dashboard delle applicazioni forniscono informazioni come posizione, criticità e proprietari. Le dashboard dei servizi e dei workload includono informazioni sui tipi di App Hub e di infrastruttura.

Etichette specifiche per l'applicazione

Le etichette specifiche di App Hub consentono a Google Cloud Observability di costruire la gerarchia delle dashboard OOTB e di filtrare la telemetria visualizzata in base a quella di un servizio o di un workload. Puoi anche utilizzare queste etichette per filtrare i dati dei log e delle metriche. Queste etichette vengono associate quando l'applicazione viene eseguita su Google Cloud risorse integrate con App Hub. Queste etichette potrebbero essere associate durante l'importazione delle metriche di Google Cloud Managed Service per Prometheus.

Etichette dei log

Le voci di log contengono un campo apphub che elenca le etichette per l'applicazione e per un servizio o un workload. Di seguito è illustrato il formato di questi dati:

apphub: {
  application: {
    id: "my-app"
    location: "my-app-location"
  }
  workload: {
    criticalityType: "MEDIUM"
    environmentType: "STAGING"
    id: "my-workload-id"
  }
}

Etichette metriche

Questa sezione descrive come vengono associate le etichette specifiche dell'applicazione ai dati delle metriche generati dalle risorse e alle metriche di Prometheus importate utilizzando Google Cloud Managed Service per Prometheus. Google Cloud Di seguito, interpreta a.b.{x,y} come a.b.x e a.b.y.

Le seguenti etichette App Hub sono associate ai dati delle metriche delle Google Cloud risorse utilizzate dalla tua applicazione:

• metadata.system_labels.apphub_application_{container,id,location}
• metadata.system_labels.apphub_{workload,service}_{criticality_type,environment_type,id}

Le etichette delle applicazioni App Hub vengono associate alle metriche di Google Cloud Managed Service per Prometheus quando una delle seguenti condizioni è vera:

• Un carico di lavoro è in esecuzione su un cluster Google Kubernetes Engine con la versione 1.30 o successiva e il tipo di controller del carico di lavoro è uno dei seguenti:

  • apps.k8s.io/{Deployment,StatefulSet,DaemonSet}
  • batch.k8s.io/CronJob

• Quando utilizzi OpenTelemetry su Cloud Run.

• Quando utilizzi OpenTelemetry su Google Kubernetes Engine e segui le indicazioni per l'importazione di OTLP Kubernetes.

Managed Service per Prometheus utilizza l'API App Hub per determinare se esiste un'applicazione App Hub. Quando viene trovata un'applicazione, ai dati traccia vengono aggiunte le seguenti etichette specifiche dell'applicazione:

• metric.labels.apphub_application_{container,id,location}
• metric.labels.apphub_workload_{criticality_type,environment_type,id}

Etichette dei criteri di avviso

Le etichette di servizi e workload non vengono allegate automaticamente ai criteri di avviso. Tuttavia, puoi associare un criterio di avviso a un determinato servizio o carico di lavoro allegando tutte le seguenti etichette con le seguenti chiavi al criterio di avviso:

• apphub_application_location
• apphub_application_id
• apphub_service_id o apphub_workload_id

Quando un criterio di avviso include le chiavi precedenti, gli incidenti relativi al criterio vengono visualizzati nelle dashboard OOTB.

Per ulteriori informazioni, consulta Associare un criterio di avviso a un servizio o a un carico di lavoro.

Navigazione nella console Google Cloud

La console Google Cloud reimposta automaticamente il selettore delle risorse da una cartella abilitata per le app al progetto di gestione della cartella quando viene aperta una pagina di Google Cloud Observability.

Cloud Logging supporta le cartelle come risorsa. Ad esempio, puoi creare canali di log e bucket di log in una risorsa di cartella. Analogamente, le cartelle contengono bucket di log _Default e _Required e potresti voler visualizzarne i contenuti. Per accedere alla risorsa della cartella, utilizza il selettore di risorse e seleziona manualmente la cartella abilitata per l'app.

Prima di iniziare

Prima di poter utilizzare il monitoraggio delle applicazioni, assicurati di configurare il progetto host App Hub o il progetto di gestione per la cartella abilitata per le app. Questo è il progetto che utilizzi per visualizzare i dati di telemetria della tua applicazione:

• Per ottenere le autorizzazioni necessarie per visualizzare i dati dei log e delle metriche, creare criteri di avviso e personalizzare le dashboard, chiedi all'amministratore di concederti i seguenti ruoli IAM:

  • Visualizzatore dei log (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 dei log _Default. Per ulteriori informazioni, consulta Ruoli di logging.
  • Logs View Accessor (roles/logging.viewAccessor) nelle visualizzazioni dei log elencate nell'ambito dei 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.
  • Editor di monitoraggio (roles/monitoring.editor) nel progetto host App Hub o nel progetto di gestione della tua cartella abilitata per le app. Per i principali che non devono creare o modificare criteri di avviso o dashboard, ti consigliamo di concedere il ruolo Visualizzatore monitoraggio (roles/monitoring.viewer).
  • Visualizzatore App Hub nel progetto host App Hub o nel progetto di gestione della cartella abilitata per le app. Per ulteriori informazioni, consulta Ruoli e autorizzazioni di App Hub.

  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.

• Assicurati di aver configurato l'ambito di osservabilità del progetto host di App Hub o del progetto di gestione per la cartella abilitata per le app. Per saperne di più, vedi Configurare il monitoraggio delle applicazioni.

  L'ambito di osservabilità controlla quali dati sono disponibili per il progetto host di App Hub o per il progetto di gestione della cartella abilitata per le app. Le impostazioni predefinite per questi scopi potrebbero non consentire la visualizzazione di tutti i dati dei log o delle metriche.

• Aggiorna i criteri di avviso che monitorano i dati delle applicazioni in modo da includere le etichette specifiche dell'applicazione. Per ulteriori informazioni, consulta Associare un criterio di avviso a un servizio o a un carico di lavoro.

Visualizza il riepilogo di tutte le applicazioni

La dashboard OOTB di primo livello fornisce un riepilogo conciso dello stato delle applicazioni registrate. Per ogni applicazione, questa pagina elenca il numero di incidenti aperti e informazioni su posizione, criticità e ambiente.

Per aprire la dashboard OOTB di primo livello, che elenca le informazioni di riepilogo per le tue applicazioni registrate in App Hub, svolgi i seguenti passaggi:

1. Nella console Google Cloud, vai alla pagina Monitoraggio delle applicazioni:

   Vai a Monitoraggio delle applicazioni

   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, selezionare il progetto host di App Hub o il progetto di gestione per la cartella abilitata per le app.

3. (Facoltativo) Per aprire un'applicazione in App Hub, fai clic su more_vert Altro e seleziona Gestisci in AppHub.

4. Per aprire la dashboard OOTB di un'applicazione, selezionala. La sezione successiva fornisce indicazioni su come esplorare o interpretare la telemetria.

Esplorare la telemetria e gli incidenti delle applicazioni

Quando selezioni un'applicazione elencata nella pagina Monitoraggio delle applicazioni, si apre la dashboard OOTB di primo livello per l'applicazione. Questa dashboard ti aiuta a comprendere lo stato della tua applicazione riassumendo il numero di incidenti aperti e elencando i valori di diversi indicatori ideali. Ad esempio, se questa pagina mostra errori diffusi, potrebbe indicare che l'origine dell'errore è l'infrastruttura e non l'applicazione.

Per aprire la dashboard OOTB di un'applicazione:

1. Nella console Google Cloud, vai alla pagina Monitoraggio delle applicazioni:

   Vai a Monitoraggio delle applicazioni

   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. Nella pagina Monitoraggio delle applicazioni, seleziona il nome di un'applicazione.

   La dashboard OOTB per l'applicazione si apre con la scheda Panoramica selezionata. In questa scheda sono elencati tutti i servizi e i carichi di lavoro, insieme al numero di incidenti aperti e ai valori per gli indicatori ideali:

   • Traffico: tassi di richieste in entrata sulla risorsa nel periodo di tempo selezionato.
   • Tasso di errori del server: percentuale media di richieste in entrata che generano o mappano codici di errore HTTP della serie 5xx nel periodo di tempo selezionato.
   • Latenza P95: il 95° percentile della latenza per una richiesta di servizio aggregata nel periodo di tempo selezionato, in millisecondi.
   • Saturazione: misura il grado di "pieno" del servizio o del carico di lavoro. Per i servizi e i carichi di lavoro che si basano su risorse basate su calcolo come i gruppi di istanze gestite (MIG), Cloud Run e i deployment di Google Kubernetes Engine, questo campo mostra l'utilizzo della CPU.

   Nella scheda Panoramica puoi eseguire tutte le seguenti operazioni:

   • Reimposta l'intervallo di tempo. Quando apri la dashboard, l'intervallo di tempo è impostato sull'ora più recente.
   • Visualizza le informazioni sull'applicazione, ad esempio operatore, sviluppatore e proprietari di attività.
   • Apri l'applicazione, un servizio o un workload in App Hub.
   • Apri la dashboard di un servizio o di un workload.

4. Per visualizzare la telemetria dell'applicazione e le informazioni sugli incidenti aperti, seleziona la scheda Dashboard.

   La scheda Dashboard mostra informazioni su log, metriche e incidenti. Questa scheda contiene anche filtri che puoi utilizzare per limitare i dati visualizzati. Per informazioni su come esplorare questa scheda, consulta le seguenti sezioni di questo documento:

   • Filtrare una dashboard.
   • Esplora i dati dei log.
   • Esplora i dati delle metriche.
   • Esplora gli incidenti.

Filtrare una dashboard

La scheda Dashboard mostra i dati relativi a servizi e workload in un'applicazione. Tuttavia, puoi filtrare questa dashboard in base a un servizio specifico o a un insieme di servizi.

Ad esempio, la barra degli strumenti nella scheda Dashboard contiene un filtro come apphub_service_id: *. Se vuoi visualizzare i dati relativi a servizi specifici, fai clic su arrow_drop_down Menu e seleziona i servizi dall'elenco.

Esplorare i dati dei log

Se stai visualizzando la scheda Dashboard di una dashboard dell'applicazione, i dati dei log vengono visualizzati nella sezione Log delle applicazioni. In caso contrario, i dati vengono visualizzati nella sezione Log.

Le sezioni Log delle applicazioni e Log di una dashboard mostrano le voci di log corrispondenti a un filtro e archiviate dalle risorse elencate nell'ambito dei log predefinito del progetto host App Hub o del progetto di gestione per la cartella abilitata per le app. Per le applicazioni, il filtro è simile al seguente:

-- Application logs
(apphub_application_location=global)
(apphub_application_id=my-app)

Per i servizi e i carichi di lavoro, il filtro contiene clausole aggiuntive. Per visualizzare il filtro applicato ai dati dei log, fai clic su Mostra query.

Se vuoi scrivere query, puoi aprire un popup o la pagina Esplora log. Entrambe le opzioni ti consentono di scrivere ed eseguire query, nonché di modificare l'ambito. Tuttavia, il popup mantiene il contesto corrente e consente di salvare i risultati dell'esplorazione in una dashboard personalizzata:

• Per aprire un popup, fai clic su query_stats Esplora i dati.

  Al termine dell'esplorazione, fai clic su Annulla per chiudere il popup e eliminare le modifiche. Se vuoi salvare le modifiche in una dashboard personalizzata, fai clic su Salva nella dashboard e completa la finestra di dialogo. Non puoi salvare le modifiche apportate alla dashboard che stavi visualizzando quando hai aperto il popup.

  Il popup non elenca i filtri mostrati dal pulsante Mostra query. Questi filtri vengono applicati a livello di dashboard e non possono essere rimossi.

• Per aprire la pagina Esplora log in una nuova scheda del browser, fai clic su Visualizza in Esplora log.

  La query è preconfigurata per mostrare le voci di log che corrispondono a etichette di applicazioni specifiche e che rientrano nell'intervallo di tempo specificato dalla dashboard. Quando chiudi la scheda del browser, le modifiche vengono ignorate.

Per ulteriori informazioni su come esplorare i log, consulta i seguenti documenti:

• Crea e salva le query utilizzando il linguaggio di query di Logging.
• Visualizza i log utilizzando Esplora log.

Esplorare i dati delle metriche

I grafici e le tabelle della dashboard mostrano indicatori chiave e altri dati metrici pertinenti per le risorse utilizzate dalla tua applicazione, dal tuo servizio o dal tuo carico di lavoro. I dati visualizzati possono essere archiviati in qualsiasi progetto elencato dall'ambito delle metriche del progetto host App Hub o del progetto di gestione per la tua cartella abilitata per le app.

Per qualsiasi grafico o tabella che mostra i dati delle metriche, puoi visualizzare dettagli come il tipo di metrica e le opzioni di aggregazione. Per visualizzare queste informazioni, vai alla barra degli strumenti di un grafico o di una tabella, quindi fai clic su infoInformazioni.

Per esplorare un grafico o una tabella in modo più dettagliato, puoi aprire un popup o la pagina Esplora metriche. Entrambe le opzioni ti consentono di provare diverse impostazioni del grafico e salvare i risultati in una dashboard personalizzata. Tuttavia, il popup mantiene il tuo contesto corrente:

• Per aprire un popup, fai clic su query_stats Esplora i dati.

  Al termine dell'esplorazione, fai clic su Annulla per chiudere il popup e eliminare le modifiche. Se vuoi salvare le modifiche in una dashboard personalizzata, fai clic su Salva nella dashboard e completa la finestra di dialogo. Non puoi salvare le modifiche apportate alla dashboard che stavi visualizzando quando hai aperto il popup.

• Per visualizzare il grafico o la tabella in Metrics Explorer, vai alla barra degli strumenti, fai clic su more_vert Altro e poi seleziona Visualizza in Metrics Explorer.

  Ora hai un grafico temporaneo che puoi modificare ed esplorare. Ad esempio, puoi modificare le opzioni di aggregazione o lo stile di visualizzazione. Per salvare il grafico in una dashboard personalizzata, fai clic su Salva in dashboard e completa la

Esplora gli incidenti

La sezione Avvisi delle dashboard elenca gli incidenti recenti per i criteri di avviso associati a un servizio o a un carico di lavoro. Queste norme di avviso devono essere archiviate nel progetto host di App Hub o nel progetto di gestione per la cartella abilitata per le app.

Se non vedi voci nella sezione Avvisi, significa che non hai parametri di avviso associati a un servizio o a un workload. Per creare questa associazione, aggiungi le etichette al criterio. Per ulteriori informazioni, consulta Associare un criterio di avviso a un servizio o a un carico di lavoro.

Per ulteriori informazioni sugli incidenti e sui criteri di avviso, segui questi passaggi:

• Per trovare i dettagli del criterio di avviso che ha causato l'incidente, fai clic sul nome del criterio. La dashboard che si apre mostra informazioni dettagliate sul criterio di avviso, tra cui un grafico che mostra i dati monitorati e le etichette.

• Per visualizzare tutti i criteri di avviso associati all'applicazione, vai alla barra degli strumenti e fai clic su query_stats Dati di Explorer. Viene visualizzato un menu a scomparsa che elenca tutte le norme. Per tornare alla dashboard, fai clic su Annulla.

Esplora la telemetria e gli incidenti relativi a servizi o workload

Viene fornita una dashboard OOTB per ogni servizio e carico di lavoro. Queste dashboard visualizzano informazioni su log, metriche e incidenti e possono aiutarti a comprendere lo stato di un servizio o di un carico di lavoro specifico. Puoi esplorare i dati di queste dashboard out-of-the-box in modo simile a come vengono esplorati i dati mostrati nella scheda Dashboard di un'applicazione.

Per aprire la dashboard OOTB per un servizio o un workload:

1. Nella console Google Cloud, vai alla pagina Monitoraggio delle applicazioni:

   Vai a Monitoraggio delle applicazioni

   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 App Hub o il progetto di gestione per la tua cartella abilitata per le app.

3. Nella pagina Monitoraggio delle applicazioni, seleziona il nome di un'applicazione, quindi un servizio o un workload.

   Una dashboard mostra i log, le metriche e le informazioni sugli incidenti relativi al servizio o al workload selezionato. Per informazioni su come esplorare questi dati, consulta le seguenti sezioni di questo documento:

   • Esplora i dati dei log.
   • Esplora i dati delle metriche.
   • Esplora gli incidenti.

Creare una dashboard personalizzata

Google Cloud Observability supporta la creazione di dashboard personalizzate, che ti consentono di avere il controllo completo sui contenuti della dashboard. Le dashboard personalizzate sono elencate nella pagina Dashboard della console Google Cloud e possono essere copiate, modificate ed eliminate. Possono anche essere la destinazione in cui salvate un widget della dashboard che avete configurato. Ad esempio, se stai esaminando un grafico in una dashboard dell'applicazione, puoi salvarlo in una dashboard personalizzata andando alla barra degli strumenti e selezionando Salva in dashboard.

Se prevedi di creare una dashboard personalizzata per un'applicazione, un servizio o un workload, potrebbero essere utili le seguenti informazioni:

• Il documento Panoramica delle dashboard fornisce un riepilogo di tipi di widget e include link a indicazioni basate sulle attività.

• Puoi aggiungere filtri a livello di dashboard a una dashboard personalizzata. L'utilizzo di questi filtri potrebbe essere più efficiente e più flessibile rispetto all'aggiunta di filtri ai singoli widget. I filtri si basano su etichette. Per un elenco di etichette, consulta la sezione Etichette specifiche per l'applicazione di questo documento.

• Valuta se un modello esistente potrebbe avere la maggior parte dei contenuti che ti interessano. Per ulteriori informazioni, incluso un link al repository GitHub in cui sono archiviati i modelli, consulta Installare un modello di dashboard.

Associare un criterio di avviso a un'applicazione App Hub

Associa un criterio di avviso a un servizio o a un carico di lavoro aggiungendo al criterio di avviso le etichette specifiche dell'applicazione. Quando aggiungi queste etichette, vengono elencate nel criterio di avviso e incluse anche in eventuali incidenti. Per scoprire di più sulle etichette, consulta Annotare gli incidenti con le etichette.

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 notifications 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 more_vert 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:

• Gestisci i criteri di avviso tramite API.
• Gestisci i criteri di avviso con Terraform.

Risoluzione dei problemi

Per informazioni che potrebbero aiutarti a capire quali dati stai visualizzando o perché una dashboard non mostra dati, consulta Risolvere i problemi relativi al monitoraggio delle applicazioni.