Configurar alertas para problemas de rendimiento

Utilice alertas de Monitoreo de rendimiento para notificar a los miembros del proyecto si los cambios de código o las solicitudes de red están degradando el rendimiento de su aplicación.

Puede configurar y personalizar alertas para su aplicación, que le notifican cuando el rendimiento de un evento cruza un umbral establecido.

¿Qué desencadena una alerta?

Se activa una alerta cuando una métrica de tu aplicación cruza un umbral que defines para un percentil específico (si corresponde) en Firebase console. Las alertas se activan solo si su aplicación utiliza una versión de SDK compatible en tiempo real .

hora de inicio de la aplicación

Cuando configura una alerta para la hora de inicio de la aplicación, la alerta se activa si se cumplen todas las condiciones siguientes:

  • Firebase registró al menos 100 muestras del seguimiento _app_start de la última versión de tu aplicación en la última hora.
  • La duración del seguimiento _app_start superó el umbral definido por la aplicación durante la última hora y para el percentil configurado.
  • No se generó ninguna alerta anteriormente para el mismo umbral en la última versión de su aplicación.

rastros de código personalizado

Cuando configura una alerta para una métrica de seguimiento de código personalizado, la alerta se activa si se cumplen todas las condiciones siguientes:

  • Firebase registró al menos 100 muestras del seguimiento del código personalizado para la última versión de su aplicación en la última hora.
  • La duración del seguimiento superó el umbral definido por la aplicación durante la última hora y para el percentil configurado.
  • (Solo para iOS+ y Android) No se generó ninguna alerta anteriormente para el mismo umbral en la última versión de su aplicación.
  • (Solo para web) No se generó ninguna alerta anteriormente para el mismo umbral en los últimos 3 días .

solicitudes de red

Cuando configura una alerta para una métrica de solicitud de red, la alerta se activa si se cumplen todas las condiciones siguientes:

  • Firebase registró al menos 100 muestras que coincidieron con el patrón de URL en todas las versiones de su aplicación en la última hora.
  • El valor agregado de la métrica superó el umbral definido durante la última hora:
    • tiempo de respuesta : el valor agregado superó el umbral establecido para el percentil configurado
    • tasa de éxito : (solo para iOS+/Android) el valor agregado estuvo por debajo del umbral establecido en todos los usuarios
  • No se generó ninguna alerta previamente para el mismo umbral en los últimos 3 días .

renderizado de pantalla

Cuando configura una alerta para una métrica de representación de pantalla, la alerta se activa si se cumplen todas las condiciones siguientes:

  • Firebase registró al menos 100 muestras de representación de pantalla para la última versión de su aplicación en la última hora.
  • El valor agregado de la métrica superó el umbral definido durante la última hora:
    • fotogramas congelados : el valor agregado superó el umbral establecido
    • fotogramas lentos : el valor agregado superó el umbral establecido
  • No se generó ninguna alerta anteriormente para el mismo umbral en la última versión de su aplicación.

cargas de página

Cuando configura una alerta para una métrica de carga de página, la alerta se activa si se cumplen todas las condiciones siguientes:

  • Firebase registró al menos 100 muestras de la carga de la página de su aplicación en la última hora.
  • El valor agregado de la métrica cruzó el umbral definido durante la última hora y para el percentil configurado:
    • primer retraso de entrada : el valor agregado superó el umbral establecido y el percentil configurado
    • primera pintura con contenido : el valor agregado superó el umbral establecido y el percentil configurado
    • primera pintura : el valor agregado superó el umbral establecido y el percentil configurado
  • No se generó ninguna alerta previamente para el mismo umbral en los últimos 3 días .

Obtenga más información sobre cómo configurar alertas , percentiles predeterminados y prácticas recomendadas para configurar alertas para tipos específicos de seguimientos y métricas.

Las alertas de otras métricas de rendimiento o de integraciones integradas de Firebase con Slack , Jira y PagerDuty no están disponibles para las alertas de Monitoreo de rendimiento.

Recibir alertas

Recibe alertas predeterminadas

De forma predeterminada, Firebase puede enviar alertas de Monitoreo de rendimiento por correo electrónico.

Para recibir alertas de Monitoreo de rendimiento a través de este mecanismo predeterminado, debe tener el permiso firebaseperformance.config.update . Los siguientes roles incluyen este permiso requerido de forma predeterminada:

Las alertas y sus configuraciones son para todo el proyecto. Esto significa que, de forma predeterminada, cada miembro del proyecto (que no sea un grupo de correo electrónico y tenga los permisos necesarios para recibir alertas) recibirá un correo electrónico cuando se active una alerta de rendimiento.

Activar/desactivar alertas para su propia cuenta

Para su propia cuenta, puede activar o desactivar las alertas de Monitoreo de rendimiento sin afectar a otros miembros del proyecto. Tenga en cuenta que aún necesita los permisos necesarios para recibir alertas.

Para activar o desactivar las alertas de Monitoreo de rendimiento, siga estos pasos:

  1. En Firebase console, en la esquina superior derecha, ve a Alertas de Firebase .
  2. Luego ve a Configuración y establezca las preferencias de su cuenta para las alertas de Monitoreo de rendimiento.

Configurar alertas avanzadas para servicios de terceros

También puedes enviar alertas de Monitoreo de rendimiento al canal de notificación preferido de tu equipo, usando Cloud Functions para Firebase. Por ejemplo, puede escribir una función que capture un evento de alerta para un tiempo de inicio lento de la aplicación y publique la información de la alerta en un servicio de terceros, como Discord, Slack o Jira.

Para configurar capacidades de alertas avanzadas usando Cloud Functions para Firebase, siga estos pasos:

  1. Configure Cloud Functions para Firebase , que incluye las siguientes tareas:

    1. Configure un entorno de desarrollo para Node.js o Python.
    2. Instale e inicie sesión en Firebase CLI.
    3. Inicialice Cloud Functions para Firebase mediante Firebase CLI.
  2. Escriba e implemente una función que capture un evento de alerta de Performance Monitoring y maneje la carga útil del evento (por ejemplo, publique la información de la alerta en un mensaje en Discord).

Para obtener información sobre todos los eventos de alerta de rendimiento que puede capturar, vaya a la documentación de referencia para alertas de Monitoreo de rendimiento .

Eliminación automática de alertas no válidas

Performance Monitoring valida las alertas para garantizar que los datos sean válidos y que las alertas estén en uso activo. Las alertas se consideran válidas si se cumple una de las siguientes condiciones:

  • La alerta se crea para un ID de recurso para el cual Performance Monitoring recibió datos en los últimos 90 días.
  • La alerta se creó recientemente para un patrón de URL personalizado. Después de crear un patrón de URL personalizado y configurar una alerta, tiene 90 días para enviar datos para ese patrón. Si no se envían datos dentro del período de 90 días, Performance Monitoring elimina esa alerta. Para obtener más información sobre los patrones de URL personalizados, consulte Agregar datos en patrones de URL del cliente .

Si no se cumple alguna de estas condiciones, Performance Monitoring elimina la alerta.

Configurar una alerta

Para configurar las alertas de Performance Monitoring, 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.

Si aún no lo ha hecho, agregue el último SDK de Performance Monitoring a su aplicación. Para obtener más información, consulte las guías de introducción para las plataformas web , Android , Apple y Flutter .

En cada una de sus aplicaciones registradas, use la tabla Seguimientos o la boleta de calificaciones del Panel para configurar una alerta para cada métrica que desee monitorear. Cada aplicación puede tener un conjunto diferente de alertas, cada una con un umbral diferente (o no tener ninguna alerta).

Configurar una alerta en la tabla Seguimientos

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

  2. Desplácese hacia abajo hasta la tabla Seguimientos en la parte inferior de la pantalla.

  3. Seleccione la pestaña del tipo de seguimiento para el que desea configurar una alerta y luego busque la fila correspondiente.

  4. En el extremo derecho de la fila, abra el menú adicional ( ) y seleccione Configuración de alerta .

  5. Siga las instrucciones en pantalla para configurar el umbral de alerta y el percentil (si corresponde) para la aplicación, o para activar/desactivar la alerta. Los percentiles predeterminados son el 90 para Android e iOS y el 75 para Web. Para obtener más información sobre los percentiles predeterminados, consulte Seguimiento de métricas clave en su panel .

Configurar una alerta en la boleta de calificaciones del Panel

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

  2. En la pestaña Tarjeta de informe, ubique la tarjeta de métrica para la que desea configurar una alerta.

  3. En la tarjeta de métricas deseada, abra el menú adicional ( ) y seleccione Configuración de alerta .

  4. Siga las instrucciones en pantalla para configurar el umbral de alerta y el percentil (si corresponde) para la aplicación, o para activar/desactivar la alerta. Los percentiles predeterminados son el 90 para Android e iOS y el 75 para Web. Para obtener más información sobre los percentiles predeterminados, consulte Seguimiento de métricas clave en su panel .

Mejores prácticas para configurar una alerta de rendimiento

Solicitudes de red

Firebase agrega los datos de solicitudes de red similares bajo patrones de URL, que pueden ser cualquiera de los siguientes:

Configure alertas para sus patrones de URL personalizados

Recomendamos configurar alertas para cualquier patrón de URL personalizado que haya configurado. Dado que Firebase intenta hacer coincidir una solicitud con un patrón de URL personalizado primero, las solicitudes similares se asignan de manera más consistente al mismo patrón de URL. Esto hace que las alertas de un patrón de URL personalizado sean más significativas y efectivas para su equipo, porque ya ha identificado ese patrón específico de solicitudes como importante para su aplicación.

Configurar alertas para patrones de URL automáticos

Al configurar una alerta para un patrón de URL automático, asegúrese de que el patrón de URL automático se haya estabilizado durante unos días. Tenga en cuenta que los patrones de URL automáticos pueden cambiar con el tiempo y que las configuraciones de alerta no se trasladan a los nuevos patrones de URL. Esto podría resultar en alertas incorrectas o faltantes para los patrones que le interesan. También puede considerar la creación de un patrón de URL personalizado para garantizar que este patrón sea estable.

Cargas de pagina web

Para conocer los umbrales recomendados para medir las métricas web, consulte la documentación de Core Web Vitals .

Representaciones de pantalla

Para garantizar una experiencia óptima con la aplicación, las sesiones de los usuarios deben estar libres de fotogramas lentos y congelados. Performance Monitoring recomienda configurar alertas para fotogramas congelados superiores al 1 % y alertas para fotogramas lentos superiores al 5 %. Descubrirá que estos valores están presentes como configuración predeterminada durante la configuración de alerta de rendimiento. Para obtener más información sobre fotogramas congelados o excesivamente lentos y otras prácticas recomendadas de rendimiento de las aplicaciones, consulta la guía de Google Play .