Condividi tramite

Risoluzione dei problemi relativi a errori 4xx e 5xx tramite la stringa di riferimento

  • Articolo

Guida per comprendere e usare stringhe di riferimento per la diagnosi e la risoluzione dei problemi con Frontdoor di Azure.

Prerequisiti

  • È necessario avere un profilo frontdoor di Azure. Per creare un profilo, vedere Creazione di un profilo frontdoor di Azure.

Che cos'è una stringa di riferimento?

Una stringa di riferimento, nota anche come RefString, è una stringa breve aggiunta da Frontdoor di Azure alle intestazioni di risposta HTTP di ogni richiesta. Fornisce informazioni dettagliate su come è stata elaborata la richiesta, inclusi il punto di presenza (POP) e lo stato back-end.

Le stringhe di riferimento consentono di risolvere i problemi relativi a Frontdoor di Azure, ad esempio mancati riscontri nella cache, errori back-end e problemi di latenza. È possibile identificare la causa radice ed eseguire azioni appropriate per correggerla analizzando la stringa di riferimento delle richieste.

Nota

Se si verifica una pagina di errore da servizi Microsoft, includerà già una stringa di riferimento per la richiesta che ha generato la pagina di errore. In questi casi, è possibile passare direttamente al passaggio di diagnostica.

Come raccogliere una stringa di riferimento

Per raccogliere una stringa di riferimento, è necessario acquisire le intestazioni di risposta HTTP delle richieste e cercare l'intestazione denominata X-Azure-Ref. Questa intestazione contiene la stringa di riferimento, codificata in Base64. È possibile usare metodi diversi per acquisire le intestazioni di risposta HTTP, a seconda delle preferenze e della situazione. Ecco un esempio di come ottenere una stringa di riferimento dal browser Microsoft Edge:

  1. Aprire gli strumenti di sviluppo del browser premendo F12 o Ctrl+Shift+I.

  2. Passare alla scheda Rete .

  3. Aggiornare la pagina o eseguire l'azione che attiva la richiesta.

  4. Individuare la richiesta specifica nell'elenco e trovare l'intestazione X-Azure-Ref nella sezione intestazioni della risposta.

  5. Copiare il valore dell'intestazione X-Azure-Ref da usare con lo strumento di risoluzione dei problemi stringa di riferimento nella portale di Azure.

Per altre informazioni, vedere Esaminare l'attività di rete - Documentazione per sviluppatori di Microsoft Edge.

Esempio di come ottenere una stringa di riferimento da Microsoft Edge Browser:

Screenshot dell'esempio RefString in Microsoft Edge Browser.

Come usare una stringa di riferimento con alcuni degli strumenti di risoluzione dei problemi

Frontdoor di Azure usa una stringa di riferimento per gestire gli errori 4xx e 5xx. Di seguito sono riportati i passaggi per usare lo strumento di diagnostica con una stringa di riferimento per tenere traccia e diagnosticare i problemi di connettività:

  1. Passare al profilo frontdoor di Azure.

  2. Selezionare il menu Diagnostica e risoluzione dei problemi .

    Screenshot che mostra il primo passaggio della diagnosi dei problemi usando una stringa di riferimento.

  3. Scorrere verso il basso e selezionare Connettività nella sezione Problemi comuni.

    Screenshot che mostra il secondo passaggio della diagnosi dei problemi usando una stringa di riferimento.

  4. Nella casella Che problema si verifica? selezionare Selezionare un sottotipo di problema e scegliere errori 4xx e 5xx nel menu a discesa, quindi selezionare avanti.

    Screenshot che mostra il terzo passaggio nella diagnosi dei problemi usando una stringa di riferimento.

  5. Immettere la stringa di riferimento nella casella all'interno della sezione errori 4xx e 5xx . Immettere la stringa di riferimento specificata dalla richiesta nel campo Riferimento di rilevamento - RefString .

    Screenshot che mostra il quarto passaggio nella diagnosi dei problemi tramite una stringa di riferimento.

  6. Infine, selezionare Esegui diagnostica per identificare la causa del problema, che spiega l'errore se si tratta di un problema noto.

    Esempio di risultato che mostra un problema:

    Screenshot che mostra un esempio della diagnosi sul lavoro usando una stringa di riferimento.

    Nota

    Le funzionalità di diagnostica possono richiedere fino a 15 minuti per recapitare i risultati. Chiediamo la pazienza che consenta il completamento del processo prima di intraprendere ulteriori azioni.

Opzione alternativa

Se si sceglie di non usare lo strumento di diagnostica, è possibile includere una stringa di riferimento quando si invia un ticket di supporto. Inoltre, è possibile abilitare la funzionalità Log di accesso per ricevere aggiornamenti sui dati RefString direttamente nel portale di Azure.

Per altre informazioni sul rilevamento dei riferimenti e sui parametri del log di accesso, vedere Monitorare metriche e log in Frontdoor di Azure, che evidenzia campi specifici nei log di accesso che consentono di identificare vari tipi di errori.

Passaggi successivi