Solución de problemas de errores 4xx y 5xx mediante RefString

Guía para comprender y usar RefStrings para diagnosticar y resolver problemas con Azure Front Door.

Requisitos previos

• Debe tener un perfil de Azure Front Door. Para crear un perfil, consulte Creación de un perfil de Azure Front Door.

¿Qué es una cadena de referencia?

Una RefString, también conocida como cadena de referencia, es una cadena corta anexada por Azure Front Door a los encabezados de respuesta HTTP de cada solicitud. Proporciona detalles sobre cómo se procesó la solicitud, incluido el punto de presencia (POP) y el estado del back-end.

RefStrings puede ayudarle a solucionar problemas con Azure Front Door, como errores de caché, de enrutamiento, de back-end y problemas de latencia. Puede identificar la causa principal y realizar las acciones adecuadas para corregir el problema mediante el análisis de RefStrings de las solicitudes.

Nota:

Si encuentra una página de error de los servicios Microsoft, ya incluirá una RefString para la solicitud que generó la página de error. En tales casos, puede ir directamente al paso de diagnóstico.

Recopilación de una cadena de referencia

Para recopilar una RefString, debe capturar los encabezados de respuesta HTTP de las solicitudes y buscar el encabezado denominado X-Azure-Ref. Este encabezado contiene la RefString, codificada en Base64. Puede usar diferentes métodos para capturar los encabezados de respuesta HTTP, en función de sus preferencias y la situación. Aquí se proporciona un ejemplo de cómo obtener una RefString en el explorador Microsoft Edge:

Explorador Microsoft Edge

1. Abra las herramientas de desarrollo del explorador presionando F12 o Ctrl+Shift+I.

2. Vaya a la pestaña Red.

3. Actualice la página o realice la acción que desencadena la solicitud.

4. Busque la solicitud específica en la lista y busque el encabezado X-Azure-Ref en la sección encabezados de respuesta.

5. Copie el valor del encabezado X-Azure-Ref para usarlo con la herramienta de solución de problemas de RefString en Azure Portal.

Para obtener más información, consulte Inspección de la actividad de red: documentación para desarrolladores de Microsoft Edge.

Ejemplo de cómo obtener una RefString en el explorador Microsoft Edge:

Cómo usar una RefString con algunas de nuestras herramientas de solución de problemas

Azure Front Door usa una RefString para administrar errores 4xx y 5xx. A continuación, se muestran los pasos para usar la herramienta de diagnóstico con una RefString para realizar el seguimiento y el diagnóstico de problemas de conectividad:

1. Vaya a su perfil de Azure Front Door.

2. Seleccione el menú Diagnosticar y resolver problemas.

   

3. Desplácese hacia abajo y seleccione Conectividad en la sección Problemas comunes.

   

4. En el cuadro ¿Qué problema tiene?, seleccione Seleccionar un subtipo de problema y elija errores 4xx y 5xx en el menú desplegable y, luego, seleccione Siguiente.

   

5. Escriba la RefString en el cuadro de la sección errores 4xx y 5xx. Escriba la RefString que ha obtenido de la solicitud en el campo Referencia de seguimiento: RefString.

   

6. Por último, seleccione Ejecutar diagnóstico para identificar la causa del problema, lo que explica el error si se trata de un problema conocido.

   Ejemplo de un resultado en el que se muestra un problema:

   

   Nota:

   Se pueden requerir hasta 15 minutos para que las funcionalidades de diagnóstico entreguen resultados. Le pedimos su paciencia de modo que permita que el proceso finalice, antes de realizar más acciones.

Opción alternativa

Si decide no usar la herramienta de diagnóstico, puede incluir una RefString al enviar una incidencia de soporte técnico. Además, puede habilitar la característica Registros de acceso para recibir actualizaciones sobre los datos de RefString directamente en Azure Portal.

Para más información sobre el seguimiento de referencias y parámetros de registro de acceso, consulte Supervisión de métricas y registros en Azure Front Door, que resalta algunos campos específicos en los registros de acceso que ayudan a identificar varios tipos de errores.

Pasos siguientes

• Para obtener más información sobre cómo navegar por problemas comunes, consulte Solución de problemas de Front Door.
• Para obtener respuestas a preguntas comunes, consulte Preguntas más frecuentes sobre Azure Front Door.