Solución de problemas comunes de Azure Front Door con RefString
Guía para comprender y usar RefStrings para diagnosticar y resolver problemas con Azure Front Door.
- Debe tener un perfil de Azure Front Door. Para crear un perfil, consulte Creación de un perfil de Azure Front Door.
RefString 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.
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. Estos son algunos ejemplos de cómo obtener una RefString en varios exploradores y aplicaciones:
Abra las herramientas de desarrollo del explorador presionando
F12
oCtrl+Shift+I
.Vaya a la pestaña Red.
Actualice la página o realice la acción que desencadena la solicitud.
Busque la solicitud específica en la lista y busque el encabezado X-Azure-Ref en la sección encabezados de respuesta.
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:
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:
Vaya a su perfil de Azure Front Door.
Seleccione el menú Diagnosticar y resolver problemas.
Desplácese hacia abajo y seleccione Conectividad en la sección Problemas comunes.
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.
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.
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.
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 obtener más información sobre el seguimiento de referencias y los parámetros de registro de acceso, consulte Supervisión de métricas y registros en Azure Front Door.
En este artículo, se resaltan campos específicos en los registros de acceso que ayudan a identificar varios tipos de errores:
Errores de caché: RefString indica si se ha servido una solicitud desde la memoria caché y proporciona motivos si no es así.
Ejemplo: NOCACHE significa que la solicitud no era apta para el almacenamiento en caché, MISS significa que no existió ninguna entrada de caché válida y STALE significa que la entrada de caché ha expirado.
Errores de enrutamiento: RefString puede revelar si una solicitud se ha enrutado correctamente al back-end y el motivo.
Ejemplo: FALLBACK significa que se ha vuelto a enrutar debido a problemas principales de back-end y OVERRIDE significa que se ha enviado a un back-end alternativo según las reglas de enrutamiento.
Errores de back-end: RefString indica si la entrega al back-end se ha realizado correctamente y explica los problemas.
Ejemplo: TIMEOUT significa que la respuesta ha tardado demasiado tiempo, CONNFAIL que se ha producido un error en la conexión y ERROR indica una respuesta de error del back-end.
Problemas de latencia: RefString detalla el tiempo de procesamiento y las duraciones de fase de Azure Front Door.
Ejemplo: DURATION muestra el tiempo total de control, RTT muestra el tiempo de ida y vuelta y TTFB muestra el tiempo necesario para recibir el primer byte del back-end.
- 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.