Condividi tramite

Risolvere i problemi di Frontdoor di Azure con RefString

  • Articolo

Guida per comprendere e usare RefStrings per diagnosticare e risolvere i problemi relativi a 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 RefString?

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.

RefStrings consente di risolvere i problemi relativi a Frontdoor di Azure, ad esempio mancati riscontri nella cache, errori di routing, errori back-end e problemi di latenza. È possibile identificare la causa radice e intraprendere le azioni appropriate per correggerla analizzando i RefStrings delle richieste.

Nota

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

Come raccogliere un oggetto RefString

Per raccogliere un elemento RefString, è necessario acquisire le intestazioni di risposta HTTP delle richieste e cercare l'intestazione denominata X-Azure-Ref. Questa intestazione contiene RefString, codificata in Base64. È possibile usare metodi diversi per acquisire le intestazioni di risposta HTTP, a seconda delle preferenze e della situazione. Di seguito sono riportati alcuni esempi di come ottenere un oggetto RefString da vari browser e applicazioni:

  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 RefString nel portale di Azure.

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

Esempio di come ottenere un oggetto RefString da Microsoft Edge Browser:

Screenshot dell'esempio RefString in Microsoft Edge Browser.

Come usare refString con alcuni degli strumenti di risoluzione dei problemi

Frontdoor di Azure usa un elemento RefString per gestire gli errori 4xx e 5xx. Di seguito sono riportati i passaggi per usare lo strumento di diagnostica con refString 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 per la diagnosi dei problemi tramite RefString.

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

    Screenshot che mostra il secondo passaggio della diagnosi dei problemi tramite RefString.

  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 della diagnosi dei problemi tramite RefString.

  5. Immettere RefString nella casella all'interno della sezione errori 4xx e 5xx . Immettere il restring specificato dalla richiesta nel campo Riferimento di rilevamento - RefString .

    Screenshot che mostra il quarto passaggio per la diagnosi dei problemi tramite RefString.

  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 luogo di lavoro usando refString.

    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 un refstring 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 sui riferimenti al rilevamento e sui parametri dei log di accesso, vedere Monitorare le metriche e i log in Frontdoor di Azure.

Questo articolo evidenzia campi specifici nei log di accesso che consentono di identificare vari tipi di errori:

  • Mancati riscontri nella cache: RefString indica se una richiesta è stata servita dalla cache e fornire motivi se non lo fosse.

    Esempio: NOCACHE indica che la richiesta non era idonea per la memorizzazione nella cache, MISS indica che non esiste alcuna voce di cache valida e STALE indica che la voce della cache è scaduta.

  • Errori di routing: RefString può rivelare se una richiesta è stata indirizzata correttamente al back-end e il motivo.

    Esempio: FALLBACK significa rerouted a causa di problemi di back-end primari e OVERRIDE significa inviato a un back-end alternativo rispetto alle regole di routing.

  • Errori back-end: RefString indica se il recapito al back-end è riuscito e spiega eventuali problemi.

    Esempio: TIMEOUT indica che la risposta ha richiesto troppo tempo, CONNFAIL indica che la connessione non è riuscita e ERROR indica una risposta di errore dal back-end.

  • Problemi di latenza: RefString illustra in dettaglio i tempi di elaborazione e le durate delle fasi di Frontdoor di Azure.

    Esempio: DURATION mostra il tempo di gestione totale, RTT mostra il tempo di round trip e TTFB mostra il tempo impiegato per ricevere il primo byte dal back-end.

Passaggi successivi