Risoluzione dei problemi relativi a monitoraggi sintetici e controlli di uptime

Questo documento fornisce informazioni su come trovare i dati di log e su come risolvere gli errori di monitoraggio sintetico e controllo di uptime:

• Ricerca dei log
• Risolvere i problemi relativi alle notifiche
• Risolvi i problemi relativi ai controlli di uptime pubblici
• Risolvere i problemi relativi ai controlli di uptime privati
• Risolvere i problemi dei monitoraggi sintetici

Nota: le intestazioni delle richieste HTTP(S) includono un campo denominato Check-Id, in cui è archiviato l'identificatore del monitoraggio sintetico o del controllo di uptime associati alla richiesta.

Trova i log

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

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

   Vai a Esplora log

   Se usi 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 monitoraggi 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 o inserisci la seguente query nell'editor query, quindi fai clic su Esegui query:

     resource.type="uptime_url"
     

     Per i monitoraggi sintetici, nel menu Risorsa, seleziona Revisione Cloud Run o inserisci la seguente query nell'editor query, quindi fai clic su Esegui query:

     resource.type="cloud_run_revision"
     

   • I log di ricerca contenenti informazioni sulla risposta ricevuta durante un monitoraggio sintetico o l'esecuzione di un controllo di uptime possono eseguire una delle seguenti operazioni:

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

       labels.check_id="my-check-id"
       

     • Per eseguire query sui log che contengono dati di risposta per le richieste emesse da monitoraggi sintetici e controlli di uptime, inserisci la seguente query nell'editor 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 quanto segue:

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

     • Per i monitoraggi sintetici, il nome della Cloud Function, archiviato nel campo resource.labels.service_name.

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

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

     "GoogleStackdriverMonitoring-UptimeChecks"
     

     Il campo protoPayload.ip contiene uno degli indirizzi utilizzati dai server per il controllo di uptime. Per informazioni su come elencare tutti gli indirizzi IP, vedi Elencare gli 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.

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 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 di uptime.

        Il grafico Controlli superati mostra la cronologia dei controlli. Per identificare quando il controllo di uptime non è riuscito per la prima volta, potrebbe essere necessario modificare l'intervallo di tempo per il grafico. Il selettore dell'intervallo di tempo si trova nella barra degli strumenti della pagina Dettagli uptime.

   • Per i monitoraggi sintetici, per determinare quando si è verificato l'errore, visualizza la pagina Dettagli uptime:

     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 monitor sintetico.

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

Non ti viene comunicato che un controllo di uptime non è riuscito

Hai configurato un controllo di uptime e stai visualizzando la relativa pagina Dettagli uptime. Noti che il grafico Controlli superati mostra che almeno un controllo non ha superato i controlli. Tuttavia, non hai ricevuto una notifica.

Per impostazione predefinita, il criterio di avviso è configurato in modo da creare un incidente e inviare una notifica quando i controlli 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 riesce a ricevere 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, 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. Fai clic su Visualizza tutti i criteri nel riquadro Criteri.

3. Individua il criterio che vuoi visualizzare o modificare, quindi fai clic sul suo nome.

   Puoi visualizzare e modificare le norme nella pagina Dettagli norme.

Risolvi i problemi relativi ai controlli di uptime pubblici

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

I tuoi controlli di uptime pubblici non vanno a buon fine

Configuri un controllo di uptime pubblico, ma ricevi un errore quando esegui la fase di verifica.

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

• Errore di connessione - Rifiutato: se utilizzi il tipo di connessione HTTP predefinito, verifica che sia installato un server web che risponda alle richieste HTTP. Un errore di connessione può verificarsi su una nuova istanza se non hai installato un server web; consulta la Guida rapida per Compute Engine. Se utilizzi un tipo di connessione HTTPS, potrebbe essere necessario eseguire ulteriori passaggi di configurazione. Per i problemi del firewall, vedi Elencare gli indirizzi IP dei server per il controllo di uptime.
• Nome o servizio non trovato: il nome host potrebbe non essere corretto.
• 403 Accesso negato: il servizio restituisce un codice di errore al controllo di uptime. Ad esempio, la configurazione predefinita del server web Apache restituisce questo codice in Amazon Linux, ma il codice 200 (Success) in alcune altre versioni di Linux. Consulta il tutorial di LAMP per Amazon Linux o la documentazione del tuo server web.
• 404 Non trovato: il percorso potrebbe non essere corretto.
• 408 Timeout richiesta o nessuna risposta: il numero di porta potrebbe non essere corretto, 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 Elencare gli indirizzi IP dei server per il controllo di uptime. Il limite di timeout viene specificato nelle 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 da inviare fino a 3 ping ICMP durante il controllo. I ping possono aiutarti a distinguere tra errori causati, ad esempio, da problemi di connettività di rete e timeout nell'applicazione. Per maggiori informazioni, consulta Utilizzare i ping ICMP.

Risolvi i problemi relativi ai controlli di uptime privati

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

La creazione del controllo di uptime non va a buon fine

Le impostazioni del progetto Google Cloud potrebbero impedire la modifica dei ruoli assegnati all'account di servizio utilizzato 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:

Console Google Cloud

Quando utilizzi la console Google Cloud per creare un controllo di uptime privato, la console Google Cloud invia i comandi per concedere i ruoli Service Directory all'account di servizio.

Per informazioni su come concedere ruoli a un account di servizio, consulta Autorizzare l'account di servizio.

API: progetto di definizione dell'ambito

La prima volta che crei un controllo di uptime privato per un servizio Service Directory e risorse private in un singolo progetto Google Cloud, la richiesta potrebbe avere esito positivo o negativo. Il risultato dipende dall'avvenuta disattivazione delle concessioni automatiche dei ruoli per gli account di servizio nel progetto:

• La creazione del primo controllo di uptime riesce se il progetto consente la concessione automatica dei ruoli per gli account di servizio. Viene creato un account di servizio a cui vengono assegnati i ruoli necessari.

• La creazione del primo controllo di uptime non va a buon fine se il progetto non consente la concessione automatica dei ruoli per gli account di servizio. Viene creato un account di servizio, ma non vengono concessi ruoli.

Se la creazione del controllo di uptime non va a buon fine:

1. Autorizza l'account di servizio.
2. Attendi alcuni minuti per la propagazione delle autorizzazioni.
3. Prova a creare di nuovo il controllo di uptime privato.

API: progetto monitorato

La prima volta che crei un controllo di uptime privato che ha come target un servizio Service Directory in un progetto monitorato o risorse private in un altro progetto Google Cloud, la richiesta non riesce e genera un account di servizio Monitoring.

La modalità di autorizzazione dell'account di servizio dipende dal numero di progetti Google Cloud in uso e dalle loro relazioni. Puoi coinvolgere fino a quattro progetti:

• Il progetto in cui hai definito il controllo di uptime privato.
• Il progetto monitorato in cui hai configurato il servizio Service Directory.
• Il progetto in cui hai configurato la rete VPC.
• Il progetto in cui sono configurate risorse di rete come VM o bilanciatori del carico. Questo progetto non ha alcun ruolo nell'autorizzazione dell'account di servizio qui descritta.

Quando la creazione del primo controllo di uptime non va a buon fine:

1. Autorizza l'account di servizio.
2. Attendi alcuni minuti per la propagazione delle autorizzazioni.
3. Prova a creare di nuovo il controllo di uptime privato.

Accesso negato

I controlli di uptime non superano i risultati di VPC_ACCESS_DENIED. Questo risultato significa che alcuni aspetti della configurazione di rete o dell'autorizzazione dell'account di servizio non sono corretti.

Verifica l'autorizzazione dell'account di servizio per utilizzare un progetto di definizione dell'ambito o un progetto monitorato come descritto in La creazione dei controlli di uptime non va a buon fine.

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

Risultati anomali di controlli di uptime privati

Hai un servizio Service Directory con più VM e la configurazione del servizio contiene più endpoint. Quando arresti una delle VM, il tuo controllo di uptime continua a indicare che l'operazione è riuscita.

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 di uptime riesce anche se una delle VM non è attiva.

Intestazioni predefinite

I controlli di uptime restituiscono errori o risultati imprevisti. Questo problema potrebbe verificarsi se hai sostituito i valori di intestazione predefiniti.

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

Titolo	Valore
HTTP_USER_AGENT	GoogleStackdriverMonitoring-UptimeChecks(https://cloud.google.com/monitoring)
HTTP_CONNECTION	keep-alive
HTTP_HOST	IP dell'endpoint di Service Directory
HTTP_ACCEPT_ENCODING	gzip, deflate, br
CONTENT_LENGTH	Calcolo basato sul tempo di attività al termine dei dati

Se tenti di eseguire l'override di questi valori, potrebbe verificarsi quanto segue:

• Il controllo di uptime genera report sugli errori
• I valori di override vengono eliminati e sostituiti con i valori della tabella

Nessun dato visibile

Quando il controllo di uptime si trova in un progetto Google Cloud diverso dal servizio Service Directory, non viene visualizzato alcun dato nella dashboard dei controlli di uptime.

Assicurati che il progetto Google Cloud che contiene il controllo di uptime monitori il progetto Google Cloud che contiene il servizio Service Directory.

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

Risoluzione dei problemi dei monitoraggi sintetici

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

Messaggio di errore dopo l'abilitazione delle API

Apri il flusso di creazione per un monitoraggio sintetico e ti viene chiesto di abilitare almeno un'API. Dopo aver abilitato 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 abilitata, quindi di attendere e riprovare.

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

Vai ad API e servizi

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

Le richieste HTTP in uscita non vengono rintracciate

Configuri il monitoraggio sintetico per raccogliere i dati di traccia per le richieste HTTP di output. I dati di traccia mostrano un solo intervallo, simile al seguente screenshot:

Per risolvere la situazione, assicurati che all'account di servizio sia stato concesso il ruolo di agente Cloud Trace (roles/cloudtrace.agent). È sufficiente anche il 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 usi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo IAM e amministrazione.

2. Seleziona Includi concessioni dei ruoli fornite da Google.

3. Se l'account di servizio utilizzato dal monitoraggio sintetico non è in elenco o se non gli è stato concesso un ruolo che include le autorizzazioni nel ruolo dell'agente Cloud Trace (roles/cloudtrace.agent), concedi questo ruolo al tuo account di servizio.

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

Stato In corso

La pagina Monitoring sintetici elenca un monitoraggio sintetico con stato In progress. Lo stato In progress indica che il monitoraggio sintetico è stato creato di recente e non ci sono dati da visualizzare o che il deployment della funzione non è riuscito.

Per determinare se il deployment della funzione non è riuscito, prova a eseguire questi passaggi:

• Assicurati che il nome della Cloud Function non contenga un trattino basso. Se è presente un trattino basso, rimuovilo ed esegui nuovamente il deployment dellaCloud Functions.

• Apri la pagina Dettagli del monitor sintetico del monitor 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, pertanto il monitoraggio sintetico non è in grado di eseguire la funzione.

• Apri la pagina Cloud Functions per la funzione. Per aprire questa pagina dalla pagina Dettagli monitoraggio sintetico, fai clic su Codice, quindi sul nome della funzione.

  Se viene visualizzato un messaggio simile al seguente, significa che il deployment della funzione non è riuscito.

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

  Per risolvere questo errore, esamina il codice della funzione e correggi gli errori che impediscono la creazione o il deployment della funzione.

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

Stato avviso

Monitor sintetici elenca un monitoraggio sintetico con stato Warning. Lo stato Warning indica che i risultati dell'esecuzione non sono coerenti. Questo potrebbe indicare un problema di progettazione del test o potrebbe indicare che ciò che viene testato ha un comportamento incoerente.

Stato di errore

Monitor sintetici elenca un monitoraggio sintetico con stato Failing. Per maggiori informazioni sul motivo dell'errore, visualizza la cronologia di esecuzione più recente.

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

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

• Se l'errore restituisce un tempo di esecuzione pari a 0ms, è possibile che la Cloud Function stia esaurendo la memoria. Per risolvere questo errore, modifica la Cloud Function, quindi aumenta la memoria fino ad almeno 2 GiB e imposta il campo CPU su 1.

L'eliminazione non riesce per un monitoraggio sintetico

Puoi utilizzare l'API Cloud Monitoring per eliminare un monitoraggio sintetico, ma la chiamata API non va a buon fine e restituisce 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 uno strumento di verifica dei link inaccessibili

Hai creato un controllo dei link inaccessibili utilizzando la console Google Cloud e vuoi modificare gli elementi HTML testati o modificare il timeout dell'URI, i nuovi tentativi, attendi il selettore e le opzioni per link. Tuttavia, quando modifichi lo strumento di verifica dei link inaccessibili, nella console Google Cloud non vengono visualizzati i campi di configurazione.

Per risolvere l'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 monitor sintetico che vuoi modificare, fai clic su Altre opzioni, quindi seleziona Modifica.
3. Fai clic su Modifica funzione.

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

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

5. Fai clic su Salva.

Visualizza la console Google Cloud che non riesce a salvare screenshot

Nota: un monitoraggio sintetico che non può salvare screenshot continua a testare i link contenuti in un URI.

Hai creato uno strumento di verifica dei link inaccessibili e l'hai configurato in modo da salvare gli screenshot. Tuttavia, nella console Google Cloud viene visualizzato uno dei seguenti messaggi di avviso insieme a informazioni più dettagliate:

• InvalidStorageLocation
• StorageValidationError
• BucketCreationError
• ScreenshotFileUploadError

Per risolvere questi errori, prova a procedere nel seguente modo:

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

• Visualizza i log relativi alla tua Cloud Function. Per ulteriori informazioni, consulta Trovare i log.

• Verifica che l'account di servizio in uso nella Cloud Function corrispondente disponga di un ruolo Identity and Access Management che gli consenta di creare, accedere e scrivere nei bucket Cloud Storage.