Compartir a través de

Solución de problemas comunes de Azure Front Door con RefString

  • Artículo

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

Requisitos previos

¿Qué es RefString?

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.

Cómo recopilar una RefString

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:

  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:

Recorte de pantalla del ejemplo de 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.

    Recorte de pantalla en el que se muestra el primer paso para diagnosticar problemas con una RefString.

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

    Recorte de pantalla en el que se muestra el segundo paso para diagnosticar problemas con una RefString.

  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.

    Recorte de pantalla en el que se muestra el tercer paso para diagnosticar problemas con una RefString.

  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.

    Recorte de pantalla en el que se muestra el cuarto paso para diagnosticar problemas con una 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:

    Recorte de pantalla en el que se muestra un ejemplo del diagnóstico en acción con una RefString.

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

Pasos siguientes