Únete de manera presencial y en línea a Firebase Summit el 18 de octubre de 2022. Descubre cómo Firebase puede ayudarte a acelerar el desarrollo de apps, lanzar apps con confianza y escalar con facilidad. Regístrate ahora

Personalice la agregación de datos de solicitud de red

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Firebase Performance Monitoring agrega automáticamente datos de solicitudes de red similares para ayudarlo a comprender las tendencias en el rendimiento de sus solicitudes de red.

Sin embargo, a veces es necesario personalizar la forma en que Firebase agrega datos de solicitud de red específicos para admitir mejor los casos de uso de su aplicación. Ofrecemos dos formas de personalizar la agregación de datos para solicitudes de red: agregar datos bajo patrones de URL personalizados y personalizar cómo se calcula la tasa de éxito .

Datos agregados bajo patrones de URL personalizados

Para cada solicitud, Firebase verifica si la URL de la solicitud de red coincide con un patrón de URL . Si la URL de la solicitud coincide con un patrón de URL, Firebase agrega automáticamente los datos de la solicitud bajo el patrón de URL.

Puede crear patrones de URL personalizados para monitorear patrones de URL específicos que Firebase no está capturando con su coincidencia automática de patrones de URL derivada. Por ejemplo, puede usar un patrón de URL personalizado para solucionar problemas de una URL específica o para monitorear un conjunto específico de URL a lo largo del tiempo.

Firebase muestra todos los patrones de URL (incluidos los patrones de URL personalizados) y sus datos agregados en la subpestaña Solicitudes de red de la tabla de seguimientos, que se encuentra en la parte inferior del panel de rendimiento de la consola de Firebase.

¿Cómo funciona la coincidencia de patrones de URL personalizados?

Firebase intenta hacer coincidir las URL de solicitud con cualquier patrón de URL personalizado configurado antes de recurrir a la coincidencia automática de patrones de URL. Para cualquier solicitud que coincida con un patrón de URL personalizado, Firebase agrega los datos de las solicitudes bajo el patrón de URL personalizado.

Si la URL de una solicitud coincide con más de un patrón de URL personalizado, Firebase asigna la solicitud solo al patrón de URL personalizado más específico , de acuerdo con el siguiente orden de especificidad: texto sin formato > * > ** de izquierda a derecha en la ruta . Por ejemplo, una solicitud a example.com/books/dog coincide con dos patrones de URL personalizados:

  • example.com/books/*
  • example.com/*/dog

Sin embargo, el patrón example.com/books/* es el patrón de URL coincidente más específico porque el segmento más a la izquierda books en example.com/books/* tiene prioridad sobre el segmento más a la izquierda * en example.com/*/dog .

Cuando cree un nuevo patrón de URL personalizado, tenga en cuenta lo siguiente:

  • Las coincidencias y los datos agregados de solicitudes anteriores no se ven afectados por la creación de un nuevo patrón de URL personalizado. Firebase no vuelve a agregar retroactivamente los datos de las solicitudes.

  • Solo las solicitudes futuras se ven afectadas por la creación de un nuevo patrón de URL personalizado. Es posible que deba esperar hasta 12 horas para que Performance Monitoring recopile y agregue datos bajo un nuevo patrón de URL personalizado.

Crear un patrón de URL personalizado

Puede crear un patrón de URL personalizado desde la subpestaña Solicitudes de red en la tabla de seguimientos, que se encuentra en la parte inferior del panel de rendimiento de Firebase console.

Un miembro del proyecto debe ser propietario o editor para crear un nuevo patrón de URL personalizado; sin embargo, todos los miembros del proyecto pueden ver patrones de URL personalizados y sus datos agregados.

Puede crear hasta 400 patrones de URL personalizados en total por aplicación y hasta 100 patrones de URL personalizados por dominio para esa aplicación.

Para crear un patrón de URL personalizado, comience con un nombre de host, seguido de segmentos de ruta. El nombre de host debe incluir un dominio válido y, opcionalmente, puede incluir el subdominio. Utilice la siguiente sintaxis de segmento de ruta para crear un patrón que pueda coincidir con las URL.

  • texto sin formato: coincide con una cadena exacta
  • * : coincide con el primer segmento de subdominio, o cualquier cadena en un segmento de ruta única
  • ** : coincide con un sufijo de ruta arbitrario

La siguiente tabla describe algunas posibles coincidencias de patrones de URL personalizadas.

Para combinar... Cree un patrón de URL personalizado como... Ejemplo de coincidencias con este patrón de URL
Una URL exacta example.com/foo/baz example.com/foo/baz
Cualquier segmento de ruta única ( * ) example.com/*/baz example.com/foo/baz
example.com/bar/baz
example.com/*/*/baz example.com/foo/bar/baz
example.com/bah/qux/baz
example.com/foo/* example.com/foo/baz
example.com/foo/bar

Nota: este patrón no coincidirá con example.com/foo .

Un sufijo de ruta arbitrario ( ** ) example.com/foo/** example.com/foo
example.com/foo/baz
example.com/foo/baz/more/segments
subdomain.example.com/foo.bar/** subdomain.example.com/foo.bar
subdomain.example.com/foo.bar/baz
subdomain.example.com/foo.bar/baz/more/segments
El primer segmento de subdominio ( * ) *.example.com/foo bar.example.com/foo
baz.example.com/foo

Ver patrones de URL personalizados y sus datos

Firebase muestra todos los patrones de URL (incluidos los patrones de URL personalizados) y sus datos agregados en la subpestaña Solicitudes de red de la tabla de seguimientos, que se encuentra en la parte inferior del panel de rendimiento de la consola de Firebase.

Para ver solo patrones de URL personalizados, seleccione Patrones personalizados en el menú desplegable de la subpestaña Solicitudes de red de la tabla de seguimiento. Tenga en cuenta que si un patrón de URL personalizado no tiene datos agregados, solo aparece en esta lista.

Cuando finaliza el período de retención de datos para los datos agregados bajo un patrón de URL, Firebase elimina esos datos del patrón de URL. Si vencen todos los datos agregados bajo un patrón de URL personalizado, entonces Firebase no elimina el patrón de URL personalizado de la consola de Firebase. En su lugar, Firebase continúa enumerando patrones de URL personalizados "vacíos" en la lista de patrones personalizados de la subpestaña Solicitudes de red de la tabla de seguimiento.

Eliminar un patrón de URL personalizado

Puede eliminar patrones de URL personalizados de su proyecto. Tenga en cuenta que no puede eliminar un patrón de URL automático.

  1. En el panel de rendimiento , desplácese hacia abajo hasta la tabla de seguimientos y, a continuación, seleccione la subpestaña Solicitudes de red .

  2. Seleccione Patrones personalizados en el menú desplegable de la subpestaña Solicitudes de red .

  3. Pase el cursor sobre la fila del patrón de URL personalizado que desea eliminar.

  4. Haga clic en en el extremo derecho de la fila, seleccione Eliminar patrón personalizado y luego confirme la eliminación en el cuadro de diálogo.

Cuando elimine un patrón de URL personalizado, tenga en cuenta lo siguiente:

  • Cualquier solicitud futura se asigna al siguiente patrón de URL personalizado coincidente más específico . Si Firebase no encuentra patrones de URL personalizados que coincidan, recurre a la coincidencia automática de patrones de URL .

  • Las coincidencias y los datos agregados de solicitudes anteriores no se ven afectados por la eliminación de un patrón de URL personalizado.

    Todavía puede acceder a un patrón de URL personalizado eliminado y sus datos agregados en la subpestaña Solicitudes de red (con Todas las solicitudes de red seleccionadas) hasta el final del período de retención de datos correspondiente. Cuando caducan todos los datos agregados del patrón de URL personalizado eliminado, Firebase elimina el patrón de URL personalizado.

  • La subpestaña Solicitudes de red (con Patrones personalizados seleccionados) no muestra ningún patrón de URL personalizado eliminado.

Próximos pasos

  • Configure alertas para las solicitudes de red que degradan el rendimiento de su aplicación. Por ejemplo, puede configurar una alerta por correo electrónico para su equipo si el tiempo de respuesta para un patrón de URL específico supera el umbral que usted establezca.

Personalice cómo se calcula la tasa de éxito

Una de las métricas que monitorea Firebase para cada solicitud de red es la tasa de éxito de la solicitud. La tasa de éxito es el porcentaje de respuestas exitosas en comparación con el total de respuestas. Esta métrica lo ayuda a medir las fallas de la red y del servidor.

Específicamente, Firebase cuenta automáticamente las solicitudes de red con un código de respuesta en el rango de 100 a 399 como respuestas exitosas.

Puede personalizar el cálculo de la tasa de éxito al contar ciertos códigos de error como "respuestas exitosas" además de los códigos de respuesta que Firebase cuenta automáticamente como exitosos.

Por ejemplo, si su aplicación tiene una API de punto final de búsqueda, puede contar las respuestas 404 como "correctas" porque se esperan 404 respuestas para un punto final de búsqueda. Suponga que hay 100 muestras para este extremo de búsqueda cada hora, y 60 de ellas tienen 200 respuestas y 40 tienen 404 respuestas. Antes de configurar la tasa de éxito, la tasa de éxito será del 60 %. Después de configurar el cálculo de la tasa de éxito para contar las respuestas 404 como correctas, la tasa de éxito será del 100 %.

Configurar el cálculo de la tasa de éxito

Para configurar el cálculo de la tasa de éxito para un patrón de URL de red, debe tener el permiso firebaseperformance.config.update . Los siguientes roles incluyen este permiso obligatorio de forma predeterminada: administrador de rendimiento de Firebase, administrador de calidad de Firebase, administrador de Firebase y propietario o editor del proyecto.

  1. Vaya a la pestaña Panel de monitoreo de rendimiento en Firebase console, luego seleccione la aplicación para la que desea configurar un cálculo de tasa de éxito.
  2. Desplácese hacia abajo hasta la tabla de seguimientos en la parte inferior de la pantalla y seleccione la pestaña Solicitudes de red .
  3. Busque el patrón de URL para el que desea configurar el cálculo de la tasa de éxito.
  4. En el extremo derecho de la fila, abra el menú adicional ( ) y seleccione Configurar tasa de éxito .
  5. Siga las instrucciones en pantalla para seleccionar los códigos de respuesta que desea contar como códigos de respuesta exitosos.