Risolvere i problemi relativi ai monitoraggi sintetici e ai controlli di uptime

Questo documento fornisce informazioni su come trovare i dati dei log e su come risolvere i problemi di monitoraggio sintetico e dei controlli di uptime:

• Trovare i log
• Risolvere i problemi relativi alle notifiche
• Risolvere i problemi relativi ai controlli di uptime pubblici
• Risolvere i problemi relativi ai controlli di uptime privati
• Risolvere i problemi relativi ai monitor sintetici

Trovare i log

Questa sezione fornisce informazioni su come trovare i log per i monitor sintetici e i controlli di uptime:

1. Nella console Google Cloud, vai alla pagina Esplora log:

   Vai a Esplora log

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

2. Esegui una delle seguenti operazioni:

   • Per trovare tutti i log associati ai monitor sintetici o ai controlli di uptime, esegui una query in base al tipo di risorsa. Puoi utilizzare il menu Risorsa o inserire una query.

     Per i controlli di uptime, nel menu Risorsa, seleziona URL controllo di uptime oppure inserisci la seguente query nell'editor di query e poi fai clic su Esegui query:

     resource.type="uptime_url"
     

     Per i monitor sintetici, nel menu Risorsa, seleziona Revisione Cloud Run oppure inserisci la seguente query nell'editor di query e poi fai clic su Esegui query:

     resource.type="cloud_run_revision"
     

   • Trova i log che contengono informazioni sulla risposta ricevuta durante l'esecuzione di un monitoraggio sintetico o di un controllo di uptime, poi esegui una delle seguenti operazioni:

     • Per eseguire una query utilizzando l'ID del monitoraggio sintetico o del controllo dell'uptime, utilizza il seguente formato quando inserisci l'ID nell'editor di query, e poi fai clic su Esegui query

       labels.check_id="my-check-id"
       

     • Per eseguire query sui log che contengono i dati di risposta per le richieste generate da monitor sintetici e controlli di uptime, inserisci la seguente query nell'editor di query e fai clic su Esegui query.

       "UptimeCheckResult"
       

       La query precedente corrisponde a tutte le voci di log che includono la stringa"UptimeCheckResult".

     Questi log includono:

     • L'ID del monitoraggio sintetico o del controllo di uptime, memorizzato nel campo labels.check_id.

     • Per i monitor sintetici, il nome della funzione Cloud Run, che è memorizzato nel campo resource.labels.service_name.

     • Quando vengono raccolti i dati di traccia, l'ID di una traccia associata, memorizzato nel campo trace.

   • Per verificare che il servizio abbia ricevuto richieste dai server Google Cloud, copia la seguente query nell'Editor di query e poi fai clic su Esegui query:

     "GoogleStackdriverMonitoring-UptimeChecks"
     

     Il campo protoPayload.ip contiene uno degli indirizzi utilizzati dai server di controllo dell'uptime. Per informazioni su come elencare tutti gli indirizzi IP, vedi Elenco indirizzi IP.

Risolvere i problemi relativi alle notifiche

Questa sezione descrive alcuni errori che potresti riscontrare durante la configurazione dei criteri di avviso e fornisce informazioni per risolverli.

Un controllo non è riuscito, ma gli altri sì

Stai esaminando le metriche dei controlli di uptime e noti che un controllo ha segnalato un errore, mentre tutti gli altri hanno segnalato un esito positivo.

Non è richiesta alcuna azione per risolvere la situazione.

Quando un solo controllore segnala un errore, questo potrebbe essere il risultato del timeout del comando del controllore a causa di un problema di rete. In altre parole, anziché non riuscire, il comando non viene completato entro il timeout specificato.

I criteri di avviso che utilizzano la configurazione predefinita richiedono errori di almeno due controllori prima di creare un incidente e inviare una notifica. Un errore segnalato da un singolo ispettore non genera una notifica.

Hai ricevuto una notifica e vuoi eseguire il debug dell'errore

1. Per identificare quando è iniziato l'errore, esegui una delle seguenti operazioni:

   • Per i controlli di uptime, per determinare quando si è verificato l'errore, visualizza la pagina Dettagli sull'uptime:

     1. Nella console Google Cloud, vai alla pagina  Controlli di uptime:

        Vai a Controlli di uptime

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

     2. Trova e seleziona il controllo dell'uptime.

        Il grafico Controlli superati mostra la cronologia dei controlli. Per identificare la prima volta che il controllo di uptime non è andato a buon fine, potrebbe essere necessario modificare l'intervallo di tempo del grafico. Il selettore dell'intervallo di tempo si trova nella barra degli strumenti della pagina Dettagli sul tempo di attività.

   • Per i monitoraggi sintetici, per determinare quando si è verificato l'errore, visualizza la pagina Dettagli sul tempo di attività:

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

        Vai a Monitoraggio sintetico

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

     2. Trova e seleziona il monitoraggio sintetico.

2. Per informazioni su come trovare i dati dei log associati, consulta la sezione Trovare i log di questa pagina.

Non ricevi una notifica che ti informa che un controllo di uptime non è andato a buon fine

Hai configurato un controllo di uptime e stai visualizzando la pagina Dettagli uptime per quel controllo. Noti che il grafico Controlli superati indica che almeno un controllo non è andato a buon fine. Tuttavia, non hai ricevuto una notifica.

Per impostazione predefinita, il criterio di avviso è configurato per creare un incidente e inviare una notifica quando i controllori in almeno due regioni non ricevono una risposta a un controllo di uptime. Questi errori devono verificarsi contemporaneamente.

Puoi modificare la condizione del criterio di avviso in modo da ricevere una notifica quando una singola regione non riceve una risposta. Tuttavia, ti invitiamo a utilizzare la configurazione predefinita, che riduce il numero di notifiche che potresti ricevere a causa di errori temporanei.

Per visualizzare o modificare un criterio di avviso:

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. Fai clic su Visualizza tutte le norme nel riquadro Norme.

3. Trova la norma che vuoi visualizzare o modificare e fai clic sul suo nome.

   Puoi visualizzare e modificare il criterio dalla pagina Dettagli criterio.

Risolvere i problemi relativi ai controlli di uptime pubblici

Questa sezione descrive alcuni errori che potresti riscontrare quando utilizzi i controlli di uptime pubblici e fornisce informazioni per risolverli.

I controlli di uptime pubblici non vanno a buon fine

Configura un controllo di uptime pubblico, ma ricevi un errore quando svolgi il passaggio di verifica.

Di seguito sono riportate alcune possibili cause di un errore di controllo dell'uptime:

• Errore di connessione: rifiutato: se utilizzi il tipo di connessione HTTP predefinito, verifica di aver installato un server web che risponda alle richieste HTTP. In una nuova istanza può verificarsi un errore di connessione se non hai installato un server web. Consulta la guida rapida per Compute Engine. Se utilizzi un tipo di connessione HTTPS, potresti dover eseguire passaggi di configurazione aggiuntivi. Per i problemi relativi al firewall, consulta Elenco degli indirizzi IP dei server di controllo dell'uptime.
• Nome o servizio non trovato: il nome host potrebbe non essere corretto.
• 403 Forbidden: il servizio restituisce un codice di errore al controllo dell'uptime. Ad esempio, la configurazione predefinita del server web Apache restituisce questo codice in Amazon Linux, ma restituisce il codice 200 (Successo) in alcune altre versioni di Linux. Consulta il tutorial LAMP per Amazon Linux o la documentazione del tuo server web.
• 404 Non trovato: il percorso potrebbe non essere corretto.
• 408 Request timeout (Timeout della richiesta 408) o nessuna risposta: il numero di porta potrebbe essere scorretto, il servizio potrebbe non essere in esecuzione, il servizio potrebbe essere inaccessibile o il timeout potrebbe essere troppo basso. Verifica che il firewall consenta il traffico dai server di uptime. Consulta Elenco degli indirizzi IP dei server di controllo dell'uptime. Il limite di tempo viene specificato nell'ambito delle opzioni di convalida della risposta.

Per aiutarti a risolvere i problemi relativi ai controlli di uptime pubblici non riusciti, puoi configurare i controlli di uptime in modo che inviino fino a 3 ping ICMP durante il controllo. I ping possono aiutarti a distinguere tra i fallimenti causati, ad esempio, da problemi di connettività di rete e da timeout nell'applicazione. Per ulteriori informazioni, consulta la sezione Utilizzare i ping ICMP.

Risolvere i problemi relativi ai controlli di uptime privati

Questa sezione descrive alcuni errori che potresti riscontrare durante l'utilizzo dei controlli dell'uptime privato e fornisce informazioni per risolverli.

Creazione del controllo di uptime non riuscita

Le impostazioni del progetto Google Cloud potrebbero impedire la modifica dei ruoli assegnati all'account di servizio utilizzati dai controlli di uptime per gestire le interazioni con il servizio Service Directory. In questa situazione, la creazione del controllo di uptime non va a buon fine.

Questa sezione descrive come concedere i ruoli richiesti dall'account di servizio:

Accesso negato

I controlli di uptime non vanno a buon fine con risultati VPC_ACCESS_DENIED. Questo risultato significa che qualche aspetto della configurazione della rete o dell'autorizzazione dell'account servizio non è corretto.

Controlla l'autorizzazione dell'account di servizio per l'utilizzo di un progetto di ambito o di un progetto monitorato come descritto in Il controllo dell'uptime non va a buon fine.

Per ulteriori informazioni sull'accesso alle reti private, consulta Configurare il progetto di rete.

Risultati anomali dei controlli di uptime privati

Hai un servizio Service Directory con più VM e la configurazione del servizio contiene più endpoint. Quando chiudi una delle VM, il controllo di uptime indica ancora il successo.

Quando la configurazione del servizio contiene più endpoint, ne viene scelto uno in modo casuale. Se la VM associata all'endpoint scelto è in esecuzione, il controllo dell'uptime va a buon fine anche se una delle VM non è in funzione.

Intestazioni predefinite

I controlli di uptime restituiscono errori o risultati imprevisti. Questo potrebbe accadere se hai sostituito i valori predefiniti delle intestazioni.

Quando viene inviata una richiesta per un controllo dell'uptime privato a un endpoint di destinazione, la richiesta include le seguenti intestazioni e valori:

Se provi a sostituire questi valori, potrebbero verificarsi i seguenti casi:

• Il controllo di uptime segnala errori
• I valori di override vengono eliminati e sostituiti con i valori nella tabella

Nessun dato visibile

Non vengono visualizzati dati nella dashboard del controllo dell'uptime quando il controllo dell'uptime si trova in un progetto Google Cloud diverso da quello del servizio Service Directory.

Assicurati che il progetto Google Cloud contenente il controllo dell'uptime monitori il progetto Google Cloud contenente il servizio Service Directory.

Per ulteriori informazioni su come elencare i progetti monitorati e aggiungerne di altri, consulta Configurare un ambito delle metriche per più progetti.

Risolvere i problemi relativi ai monitoraggi sintetici

Questa sezione fornisce informazioni che puoi utilizzare per risolvere i problemi relativi ai monitor sintetici.

Messaggio di errore dopo l'abilitazione delle API

Apri il flusso di creazione di un monitoraggio sintetico e ti viene chiesto di attivare almeno un'API. Dopo aver attivato le API, viene visualizzato un messaggio simile al seguente:

An error occurred during fetching available regions: Cloud Functions API has
not been used in project PROJECT_ID before or it is disabled.

Il messaggio di errore consiglia di verificare che l'API sia attivata e poi di attendere e riprovare l'azione.

Per verificare che l'API sia abilitata, vai alla pagina API e servizi del tuo progetto:

Vai ad API e servizi

Dopo aver verificato che l'API sia abilitata, puoi continuare con il flusso di creazione. La condizione si risolve automaticamente dopo la propagazione dell'attivazione dell'API nel backend.

Le richieste HTTP in uscita non vengono monitorate

Configura il monitor sintetico per raccogliere i dati di traccia per le richieste HTTP di output. I dati della traccia mostrano un solo intervallo, simile allo screenshot seguente:

Per risolvere la situazione, assicurati che al tuo account di servizio sia stato concesso il ruolo Agente Cloud Trace (roles/cloudtrace.agent). È sufficiente anche un ruolo Editor (roles/editor).

Per visualizzare i ruoli concessi al tuo account di servizio:

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

   Vai a IAM

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

2. Seleziona Includi concessioni di ruoli fornite da Google.

3. Se l'account di servizio utilizzato dal monitor sintetico non è elencato o se non gli è stato concesso un ruolo che includa le autorizzazioni del ruolo Agente Cloud Trace (roles/cloudtrace.agent), concedi questo ruolo all'account di servizio.

   Se non conosci il nome del tuo account di servizio, nel menu di navigazione seleziona Account di servizio.

Stato In corso

Nella pagina Monitoraggi sintetici è elencato un monitoraggio sintetico con stato In progress. Uno stato In progress indica che il monitoraggio sintetico è stato creato di recente e non ci sono dati da visualizzare oppure che il deployment della funzione non è riuscito.

Per determinare se il deployment della funzione non è riuscito, prova quanto segue:

• Assicurati che il nome della funzione Cloud Run non contenga un underscore. Se è presente un'underscore, rimuovila e esegui nuovamente il deployment della funzione Cloud Run.

• Apri la pagina Dettagli del monitoraggio sintetico per il monitoraggio sintetico.

  Se viene visualizzato il seguente messaggio, elimina il monitoraggio sintetico.

  Cloud Function not found for this Synthetic monitor. Please confirm it exists or delete this monitor.
  

  Il messaggio di errore indica che la funzione è stata eliminata e quindi il monitor sintetico non è in grado di eseguirla.

• Apri la pagina delle funzioni Cloud Run per la funzione. Per aprire questa pagina dalla pagina Dettagli del monitoraggio sintetico, fai clic su Codice e poi sul nome della funzione.

  Se viene visualizzato un messaggio simile al seguente, il deployment della funzione non è andato a buon fine.

  This function has failed to deploy and will not work correctly. Please edit and redeploy
  

  Per risolvere questo errore, controlla il codice della funzione e correggi gli errori che ne impediscono la compilazione o il deployment.

Quando crei un monitor sintetico, il deployment e l'esecuzione della funzione potrebbero richiedere diversi minuti.

Stato di avviso

La pagina Monitoraggi sintetici elenca un monitoraggio sintetico con stato Warning. Uno stato Warning indica che i risultati dell'esecuzione non sono coerenti. Ciò potrebbe indicare un problema di progettazione del test o che l'elemento in fase di test ha un comportamento incoerente.

Stato non superato

La pagina Monitoraggi sintetici elenca un monitoraggio sintetico con statoFailing. Per ulteriori informazioni sul motivo dell'errore, visualizza la cronologia delle esecuzioni più recente.

• Se viene visualizzato il messaggio di errore Request failed with status code 429, significa che il target della richiesta HTTP ha rifiutato il comando. Per risolvere questo errore, devi modificare il target del monitor sintetico.

  L'endpoint https://www.google.com rifiuta le richieste effettuate da monitor sintetici.

• Se l'errore restituisce un tempo di esecuzione di 0ms, la funzione Cloud Run potrebbe esaurire la memoria. Per risolvere questo errore, modifica la funzione Cloud Run, quindi aumenta la memoria ad almeno 2 GiB e imposta il campo CPU su 1.

L'eliminazione non riesce per un monitoraggio sintetico

Utilizzi l'API Cloud Monitoring per eliminare un monitoraggio sintetico, ma la chiamata dell'API non va a buon fine con una risposta simile alla seguente:

{
  "error": {
    "code": 400,
    "message": "Request contains an invalid argument.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.DebugInfo",
        "detail": "[ORIGINAL ERROR] generic::invalid_argument: Cannot delete check 1228258045726183344. One or more alerting policies is using it.Delete the alerting policy with id projects/myproject/alertPolicies/16594654141392976482 and any other policies using this uptime check and try again."
      }
    ]
  }
}

Per risolvere l'errore, elimina i criteri di avviso che monitorano i risultati del monitoraggio sintetico, quindi elimina il monitoraggio sintetico.

Impossibile modificare la configurazione di un controllore dei link interrotti

Hai creato un controllore dei link interrotti utilizzando la console Google Cloud e vuoi cambiare gli elementi HTML sottoposti a test o modificare il timeout dell'URI, i tentativi di nuovo invio, l'attesa del selettore e le opzioni per link. Tuttavia, quando modifichi lo strumento di controllo dei link interrotti, la console Google Cloud non visualizza i campi di configurazione.

Per risolvere questo errore:

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

   Vai a Monitoraggio sintetico

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

2. Individua il monitoraggio sintetico da modificare, fai clic su more_vert Altre opzioni e poi seleziona Modifica.
3. Fai clic su Modifica funzione.

4. Modifica l'oggetto options nel file index.js e poi fai clic su Applica funzione.

   Per informazioni sui campi e sulla sintassi di questo oggetto, consulta broken-links-ok/index.js.

5. Fai clic su Salva.

La console Google Cloud indica che i salvataggi degli screenshot non vanno a buon fine

Hai creato un controllo dei link interrotti e lo hai configurato per salvare gli screenshot. Tuttavia, la console Google Cloud mostra uno dei seguenti messaggi di avviso insieme a informazioni più dettagliate:

• InvalidStorageLocation
• StorageValidationError
• BucketCreationError
• ScreenshotFileUploadError

Per risolvere questi errori, prova quanto segue:

• Se viene visualizzato il messaggio InvalidStorageLocation, verifica l'esistenza del bucket Cloud Storage specificato nel campo options.screenshot_options.storage_location.

• Visualizza i log relativi alla funzione Cloud Run. Per ulteriori informazioni, consulta la sezione Trovare i log.

• Verifica che l'account di servizio utilizzato nella funzione Cloud Run corrispondente abbia un ruolo Identity and Access Management che gli consenta di creare, accedere e scrivere nei bucket Cloud Storage.