Risolvere i problemi relativi al monitoraggio delle applicazioni

Questo documento contiene informazioni che potrebbero aiutarti a capire quali dati vengono visualizzati nella pagina Monitoraggio applicazioni. Contiene anche informazioni che potrebbero aiutarti a configurare il tuo progetto Google Cloud in modo da visualizzare i dati della tua applicazione.

Problemi noti

Questa sezione elenca i problemi noti relativi al monitoraggio delle applicazioni:

Risoluzione dei problemi

Questa sezione descrive come risolvere i problemi relativi al monitoraggio delle applicazioni.

Ti viene chiesto di creare un'applicazione

Apri la pagina Monitoraggio applicazioni nella console Google Cloud e visualizzi il messaggio "Crea un'applicazione per iniziare". Non ti aspetti di visualizzare questo messaggio perché hai registrato un' applicazione App Hub.

Per risolvere questo errore, assicurati che il selettore delle risorse sia impostato sul progetto host di App Hub o sul progetto di gestione della cartella abilitata alle app.

La tua applicazione non mostra i dati per alcuni indicatori chiave

Esistono diversi motivi per cui non viene visualizzato un valore per un indicatore chiave:

  • L'infrastruttura non supporta il tipo di metrica. Ad esempio, i bilanciatori del carico di rete non supportano le metriche di sistema. Per saperne di più, consulta Servizi e workload supportati dal monitoraggio delle applicazioni.

  • Il tipo di metrica è supportato, ma non sono disponibili dati. Ad esempio, se l'intervallo di tempo è impostato per un intervallo in cui non sono stati raccolti dati delle metriche, non sono disponibili dati da visualizzare per i segnali d'oro.

Per un elenco delle risorse che generano etichette App Hub, consulta Servizi e workload supportati da Application Monitoring.

I dati delle metriche della tua applicazione sono mancanti o incompleti

Visualizzi un grafico per un servizio o un carico di lavoro e questo grafico non mostra dati delle metriche o alcuni dati sono mancanti.

Potresti non dover fare nulla. I grafici aggiunti alla dashboard predefinita per un servizio o un workload vengono selezionati in base alle risorse utilizzate da quel servizio o workload. Tuttavia, alcune risorse potrebbero non generare dati per un tipo di metrica specifico. Per un elenco delle risorse che generano etichette App Hub, consulta Servizi e workload supportati da Application Monitoring.

Se i dati della metrica sono incompleti, procedi nel seguente modo:

  1. Assicurati che il selettore di progetti sia impostato sul progetto host di App Hub o sul progetto di gestione della cartella abilitata per le app.

  2. Assicurati che l'amministratore dell'organizzazione abbia configurato l'ambito delle metriche per il progetto host di App Hub o il progetto di gestione della cartella abilitata alle app per elencare i progetti che archiviano i dati delle metriche dell'applicazione. Per saperne di più, vedi Configurare il monitoraggio delle applicazioni.

I dati di log della tua applicazione sono mancanti o incompleti

Il pannello dei log in una dashboard non mostra alcuna voce di log o non mostra tutte le voci di log generate dalla tua applicazione.

Per risolvere questo errore, procedi nel seguente modo:

  1. Per ottenere le autorizzazioni necessarie per visualizzare i dati di log, chiedi all'amministratore di concederti i seguenti ruoli IAM:

    • Visualizzatore log (roles/logging.viewer) nel progetto host di App Hub o nel progetto di gestione della cartella abilitata per le app e in qualsiasi altro progetto elencato nel suo ambito di 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.
    • Logs View Accessor (roles/logging.viewAccessor) nelle visualizzazioni dei log elencate nell'ambito dei log predefinito del progetto host di App Hub o del progetto di gestione della cartella abilitata per le app. Per saperne di più su come concedere l'accesso a una visualizzazione log, consulta Controllare l'accesso a una visualizzazione log.

  2. Assicurati che l'amministratore dell'organizzazione abbia configurato l'ambito di logging predefinito del progetto host di App Hub o del progetto di gestione della cartella abilitata alle app per elencare le risorse che archiviano i dati di log dell'applicazione. Per saperne di più, vedi Configurare il monitoraggio delle applicazioni.

Mancano le policy di avviso

Affinché una criterio di avviso venga visualizzata in una dashboard di monitoraggio delle applicazioni, devi associarla a un servizio o a un workload aggiungendo etichette specifiche alla policy.

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

  1. Nella Google Cloud console, 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 consoleGoogle Cloud , seleziona il progetto host di App Hub o il progetto di gestione della cartella abilitata alle app.
  3. Trova il criterio di avviso, fai clic su Visualizza altro, seleziona Modifica e poi 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 policy.

Dopo aver completato questi passaggi, le etichette con le seguenti chiavi vengono associate al 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:

Hai aggiunto etichette di applicazione ai criterio di avviso, ma i criteri non sono elencati

Per risolvere questo errore, verifica che la policy includa le seguenti etichette:

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id o apphub_workload_id

Le dashboard per i servizi e i workload sono diverse

Non è richiesta alcuna azione.

Le risorse utilizzate da un servizio o da un workload determinano i dati visualizzati per quel servizio o workload.

Non puoi salvare le modifiche alla dashboard che stai visualizzando

Stai esplorando i dati visualizzati in una dashboard di un servizio o di un workload e vuoi salvare le modifiche. La barra degli strumenti mostra un pulsante Salva nella dashboard. Tuttavia, quando selezioni questo pulsante, non puoi salvare le modifiche alla dashboard corrente.

Il pulsante Salva nella dashboard viene visualizzato solo quando la dashboard che stai visualizzando è di sola lettura. Tuttavia, puoi utilizzare questo pulsante per salvare le modifiche in una dashboard personalizzata. Per saperne di più, vedi Panoramica delle dashboard.

Non puoi salvare il grafico

Quando esplori i dati di telemetria, nella barra degli strumenti il pulsante Salva nella dashboard è disattivato.

Per risolvere questo errore, assicurati di disporre di autorizzazioni sufficienti.

Per ottenere le autorizzazioni necessarie per salvare le modifiche a una dashboard personalizzata, chiedi all'amministratore di concederti il ruolo IAM Monitoring Editor (roles/monitoring.editor) nel progetto host di App Hub o nel progetto di gestione della cartella abilitata per le app.

Vengono aperti incidenti imprevisti

Con il rilascio di Application Monitoring, l'etichetta metadata.system_labels.apphub_host_project_id è stata rinominata metadata.system_labels.apphub_application_container. Questa modifica potrebbe comportare la generazione di nuovi incidenti e la mancata chiusura di alcuni incidenti aperti. Ad esempio, per le policy di assenza di metriche, potresti ricevere una notifica perché la modifica delle etichette potrebbe causare l'interruzione della segnalazione di campioni da parte di una serie temporale monitorata.

Non è richiesta alcuna azione. Gli incidenti vengono chiusi automaticamente quando i dati smettono di arrivare, dopo la scadenza della durata di chiusura automatica. Per maggiori informazioni, consulta la pagina Dati parziali delle metriche.

Non puoi accedere ai log nella cartella abilitata per l'app

Hai selezionato una cartella app con il selettore di risorse nella console Google Cloud . A questo punto, si apre una pagina di Google Cloud Observability, ad esempio la pagina Esplora log, e il selettore di risorse viene reimpostato su un progetto.

Il comportamento è quello previsto. Quando selezioni una cartella abilitata per le app e poi accedi a una pagina di Google Cloud Observability, la risorsa selezionata viene reimpostata sul progetto di gestione della cartella. In genere, vuoi selezionare il progetto quando vuoi visualizzare i dati di telemetria per un'applicazione.

Per accedere ai log nella cartella abilitata per le app, utilizza il selettore di risorse per selezionare manualmente la cartella.

Non vedi i bordi nella mappa della topologia dell'applicazione

Puoi visualizzare i servizi e i workload delle applicazioni nella mappa della topologia di Application Monitoring, ma non vedi alcun bordo che li colleghi. Potresti anche visualizzare un messaggio simile a "Nessuna connessione di traccia rilevata per il grafico della topologia. Strumento per Trace per attivare l'esperienza completa della topologia."

I bordi nella mappa della topologia rappresentano il traffico nella tua applicazione e vengono generati dai dati di Cloud Trace. Per risolvere il problema, prova a procedere nel seguente modo:

  1. Configura l'applicazione per utilizzare Trace:

  2. Verifica di aver configurato e impostato l'ambito di traccia predefinito. Per maggiori informazioni, consulta Configura Application Monitoring.

  3. Verifica che gli intervalli di traccia dell'applicazione siano etichettati con attributi di risorsa specifici dell'applicazione. Per maggiori informazioni, vedi Aggiungere attributi dell'applicazione agli span di traccia.