Personalice la agregación de datos de solicitud de red

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

A veces, sin embargo, necesitas personalizar la forma en que Firebase agrega datos de solicitudes de red específicos para respaldar mejor los casos de uso de tu 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 .

Agregar datos 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 según el patrón de URL.

Puedes crear patrones de URL personalizados para monitorear patrones de URL específicos que Firebase no captura con su coincidencia automática de patrones de URL derivada. Por ejemplo, puede utilizar 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 seguimiento, que se encuentra en la parte inferior del panel de Rendimiento de Firebase console.

¿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 crea 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 datos de solicitudes de forma retroactiva.

  • Sólo 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 según 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 seguimiento, 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 único segmento de ruta
  • ** — coincide con un sufijo de ruta arbitrario

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

Para combinar... Crea 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 único ( * ) 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 seguimiento, que se encuentra en la parte inferior del panel de Rendimiento de Firebase console.

Para ver solo patrones de URL personalizados, seleccione Patrones personalizados en el menú desplegable en la subpestaña Solicitudes de red de la tabla de seguimientos. 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 todos los datos agregados bajo un patrón de URL personalizado vencen, Firebase no elimina el patrón de URL personalizado de Firebase console. En cambio, Firebase continúa enumerando patrones de URL personalizados "vacíos" en la lista 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. Desde el panel de rendimiento , desplácese hacia abajo hasta la tabla de seguimientos y luego seleccione la subpestaña Solicitudes de red .

  2. Seleccione Patrones personalizados en el menú desplegable en 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 elimina 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 al eliminar un patrón de URL personalizado.

    Aún 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 seleccionada) hasta el final del período de retención de datos aplicable. Cuando caducan todos los datos agregados bajo el 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 enumera ningún patrón de URL personalizado eliminado.

Próximos pasos

  • Configure alertas para 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 excede un umbral que usted establezca.

Personalice cómo se calcula la tasa de éxito

Una de las métricas que Firebase monitorea 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 le 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.

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

Por ejemplo, si su aplicación tiene una API de punto final de búsqueda, puede contar 404 respuestas como "exitosas" porque se esperan respuestas 404 para un punto final de búsqueda. Supongamos que hay 100 muestras para este punto final de búsqueda cada hora, 60 de ellas son de 200 respuestas y 40 de ellas son 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 404 respuestas como exitosas, 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 . Las siguientes funciones incluyen este permiso requerido 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 y 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.