Condividi tramite

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 Frontdoor di Azure.

Prerequisiti

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.

Annotazioni

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

  1. Aprire gli strumenti di sviluppo del browser premendo o .

  2. Vai 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 nel portale di Azure con lo strumento di risoluzione dei problemi con stringa di riferimento.

Per altre informazioni, vedere Inspect network activity - Microsoft Edge Developer documentation.For more information, see Inspect network activity - Microsoft Edge Developer documentation

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

Screenshot dell'esempio RefString nel browser Microsoft Edge.

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 di 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 . Inserisci la stringa di riferimento fornita dalla richiesta nel campo Riferimento di tracciamento - 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.

    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 Frontdoor di Azure, che evidenzia campi specifici nei log di accesso che aiutano a identificare diversi tipi di errori.

Passaggi successivi

  • Per ulteriori informazioni sulla gestione dei problemi comuni, vedere Problemi di risoluzione di Front Door.
  • Per risposte alle domande comuni, vedere Frontdoor di Azure domande frequenti.
  • Last updated on