Risolvere gli errori 4xx e 5xx usando la stringa di riferimento

Riassunto

Questo articolo fornisce indicazioni su come comprendere e usare stringhe di riferimento per la diagnosi e la risoluzione dei problemi relativi a Azure Front Door.

Prerequisiti

• È necessario avere un profilo di Azure Front Door. Per creare un profilo, vedere Creare un profilo di Azure Front Door.

Che cos'è una stringa di riferimento?

Una stringa di riferimento, nota anche come RefString, è una stringa breve aggiunta da Azure Front Door 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 Azure Front Door, 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.

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. Di seguito è riportato un esempio di come ottenere una stringa di riferimento dal browser Microsoft Edge:

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

Azure Front Door 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 di Azure Front Door.

2. Selezionare il menu Diagnostica e risoluzione dei problemi .

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

1. 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.

1. Immettere la stringa di riferimento nella casella all'interno della sezione errori 4xx e 5xx . Tu immetti la stringa di riferimento fornita nella tua richiesta nel campo Riferimento di tracciamento - RefString.

1. 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:

   

   Annotazioni

   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à Access Logs per ricevere aggiornamenti sui dati RefString direttamente nel portale di Azure.

Per altre informazioni sui riferimenti di rilevamento e sui parametri del log di accesso, vedere Monitorare metriche e log in Azure Front Door, che evidenzia campi specifici nei log di accesso che aiutano a identificare diversi tipi di errori.

Passaggi successivi

• Per ulteriori informazioni su come gestire i problemi comuni, vedere Problemi di risoluzione Front Door.
• Per risposte alle domande comuni, vedere Azure Front Door domande frequenti.