Configura alertas para problemas de rendimiento

Usa las alertas de Performance Monitoring para notificar a los miembros del proyecto si los cambios de código o las solicitudes de red degradan el rendimiento de tu app.

Puedes configurar y personalizar alertas para tu app, que te notificarán cuando el rendimiento de un evento supere un umbral establecido.

¿Cómo se activan las alertas?

Una alerta se activa cuando una métrica de tu app supera el umbral que definiste para un percentil especificado (si corresponde) en Firebase console. Las alertas se activan solo si la app usa una versión del SDK compatible en tiempo real.

Hora de inicio de la app

Si configuras una alerta para la hora de inicio de la app, esta se activa si se cumplen las siguientes condiciones:

  • Firebase registró al menos 100 muestras del seguimiento _app_start para la versión más reciente de tu app en la última hora.
  • La duración del seguimiento _app_start superó el umbral definido de la app durante la última hora y para el percentil configurado.
  • No se envió ninguna alerta anterior para el mismo umbral en la versión más reciente de tu app.

Seguimientos de código personalizado

Si configuras una alerta para una métrica de seguimiento de código personalizado, esta se activa si se cumplen las siguientes condiciones:

  • Firebase registró al menos 100 muestras del seguimiento de código personalizado que corresponde a la versión más reciente de la app en la última hora.
  • La duración del seguimiento superó el umbral definido de la app durante la última hora y para el percentil configurado.
  • (Solo para iOS+ y Android). No se envió ninguna alerta anterior del mismo umbral en la versión más reciente de la app.
  • (Solo para la Web) No se envió ninguna alerta anterior del mismo umbral en los últimos 3 días.

Solicitudes de red

Si configuras una alerta para una métrica de solicitud de red, esta se activa si se cumplen las siguientes condiciones:

  • Firebase registró al menos 100 muestras que coincidieron con el patrón de URL en todas las versiones de tu app durante 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+ y Android) el valor agregado disminuyó por debajo del umbral establecido en todos los usuarios.
  • No se envió ninguna alerta anterior para el mismo umbral en los últimos 3 días.

Renderización de pantalla

Cuando configuras una alerta para una métrica de renderización de pantalla, esta se activa si se cumplen las siguientes condiciones:

  • Firebase registró al menos 100 muestras de renderización de pantalla para la versión más reciente de tu app 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 límite establecido.
    • Tramas lentas: El valor agregado superó el umbral establecido.
  • No se envió ninguna alerta anterior para el mismo umbral en la versión más reciente de tu app.

Cargas de la página

Si configuras una alerta para una métrica de carga de página, esta se activa si se cumplen las siguientes condiciones:

  • Firebase registró al menos 100 muestras de carga de página para tu app en la última hora.
  • El valor agregado de la métrica superó el umbral definido durante la última hora y para el percentil configurado:
    • Retraso de primera entrada: El valor agregado superó el umbral establecido y el percentil configurado
    • Primer procesamiento de imagen con contenido: El valor agregado superó el umbral establecido y el percentil configurado.
    • Primer procesamiento de imagen: El valor agregado superó el umbral establecido y el percentil configurado.
  • No se envió ninguna alerta anterior para el mismo umbral en los últimos 3 días.

Obtén más información sobre la configuración de alertas, los percentiles predeterminados y las prácticas recomendadas para configurar alertas de tipos de seguimientos y métricas específicos.

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

Recibe alertas

Recibe alertas predeterminadas

De forma predeterminada, Firebase puede enviar alertas de Performance Monitoring por correo electrónico.

Para recibir alertas de Performance Monitoring mediante este mecanismo predeterminado, debes tener el permiso firebaseperformance.config.update. Los siguientes roles incluyen este permiso obligatorio de forma predeterminada:

Las alertas y su configuración se aplican a 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 la alerta de rendimiento.

Activa o desactiva alertas para tu propia cuenta

En tu propia cuenta, puedes activar o desactivar las alertas de Performance Monitoring sin que esto afecte a otros miembros del proyecto. Ten en cuenta que aún necesitas los permisos necesarios para recibir alertas.

Para activar o desactivar las alertas de Performance Monitoring, sigue estos pasos:

  1. En Firebase console, en la esquina superior derecha, ve a Alertas de Firebase.
  2. Luego, ve a Configuración y establece la preferencia de tu cuenta para las alertas de Performance Monitoring.

Configura alertas avanzadas para servicios de terceros

También puedes enviar alertas de Performance Monitoring al canal de notificaciones preferido de tu equipo mediante Cloud Functions para Firebase. Por ejemplo, puedes escribir una función que capture un evento de alerta cuando el tiempo de inicio de la app sea lento y publique la información de la alerta en un servicio de terceros, como Discord, Slack o Jira.

A fin de configurar las funciones de alerta avanzadas con Cloud Functions para Firebase, sigue estos pasos:

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

    1. Configura un entorno de desarrollo para Node.js o Python.
    2. Instala Firebase CLI y accede a ella.
    3. Inicializa Cloud Functions para Firebase con Firebase CLI.

  2. Escribe y, luego, implementa una función que capture un evento de alerta de Performance Monitoring y maneje la carga útil del evento (por ejemplo, que publique la información de alerta en un mensaje en Discord).

Para obtener información sobre todos los eventos de alertas de rendimiento que puedes capturar, consulta la documentación de referencia sobre las alertas de Performance Monitoring.

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 se estén usando activamente. Las alertas se consideran válidas si se cumple una de las siguientes condiciones:

  • La alerta se creó para un ID de recurso del que 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, tendrás 90 días para enviar los datos de ese patrón. Si no se envían datos en el período de 90 días, Performance Monitoring quitará la alerta. Para obtener más información sobre los patrones de URL personalizados, consulta Agrega datos en patrones de URL de clientes.

Si no se cumple cualquiera de estas condiciones, Performance Monitoring quitará la alerta.

Configura una alerta

Para configurar las alertas de Performance Monitoring, debes tener el permiso firebaseperformance.config.update. Los siguientes roles incluyen este permiso obligatorio de forma predeterminada: Administrador de Firebase Performance, Administrador de Firebase Quality, Administrador de Firebase o el Propietario o Editor del proyecto.

Si aún no lo has hecho, agrega el SDK de Performance Monitoring más reciente a tu app. Si quieres obtener más información, consulta las guías de introducción para las plataformas web, Android, Apple y Flutter.

En cada una de tus apps registradas, usa la tabla de seguimientos o la tarjeta de informe del panel a fin de configurar una alerta para cada métrica que desees supervisar. Cada app puede tener un conjunto diferente de alertas, cada una con un umbral diferente (o no tener ninguna alerta).

Configura una alerta en la tabla de seguimientos

  1. Ve a la pestaña Panel de Performance Monitoring en Firebase console y, luego, selecciona la app para la que quieras configurar una alerta.

  2. Desplázate hacia abajo hasta la tabla de seguimientos en la parte inferior de la pantalla.

  3. Selecciona la pestaña del tipo de seguimiento para el que desees configurar una alerta y, luego, busca la fila correspondiente.

  4. En el extremo derecho de la fila, abre el menú ampliado () y, luego, selecciona Configuración de alertas.

  5. Sigue las instrucciones en pantalla para configurar el umbral de alertas y el percentil (si corresponde) de la app, o a fin de activar o desactivar una alerta. Los percentiles predeterminados son 90 para iOS y Android y 75 para la Web. Para obtener más información sobre los percentiles predeterminados, consulta Cómo realizar un seguimiento de las métricas clave en tu panel.

Configura una alerta en la tarjeta de informe del panel

  1. Ve a la pestaña Panel de Performance Monitoring en Firebase console y, luego, selecciona la app para la que quieras configurar una alerta.

  2. En la pestaña Report card, busca la tarjeta de métrica para la que deseas configurar una alerta.

  3. En la tarjeta de métrica que quieras, abre el Menú ampliado () y selecciona Configuración de alertas.

  4. Sigue las instrucciones en pantalla para configurar el umbral de alertas y el percentil (si corresponde) de la app, o a fin de activar o desactivar una alerta. Los percentiles predeterminados son 90 para iOS y Android y 75 para la Web. Para obtener más información sobre los percentiles predeterminados, consulta Cómo realizar un seguimiento de las métricas clave en tu panel.

Prácticas recomendadas para configurar una alerta de rendimiento

Solicitudes de red

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

Configura alertas para tus patrones de URL personalizados

Recomendamos configurar alertas para cualquier patrón de URL personalizado que ya configuraste. Debido a que Firebase intenta hacer coincidir una solicitud con un patrón de URL personalizado en primer lugar, las solicitudes similares se asignan de forma más coherente al mismo patrón de URL. Esto hace que las alertas de un patrón de URL personalizado sean más significativas y eficaces para tu equipo, porque ya identificaste ese patrón específico de solicitudes como importante para la app.

Configura alertas para patrones de URL automáticos

Cuando configures una alerta para un patrón de URL automático, asegúrate de que se haya estabilizado durante algunos días. Ten en cuenta que los patrones de URL automáticos pueden cambiar con el tiempo, y las opciones de configuración de alertas no se transfieren a los patrones de URL nuevos. Esto podría generar alertas incorrectas o faltantes para los patrones que te interesan. También puedes crear un patrón de URL personalizado para asegurarte de que sea estable.

Cargas de la página web

Si quieres conocer umbrales recomendados para medir las métricas web, consulta la documentación de Métricas web esenciales.

Renderizaciones de pantalla

Para garantizar una experiencia óptima en la app, las sesiones de usuario deben estar libres de fotogramas congelados y lentos. Performance Monitoring recomienda que configures alertas destinadas a los fotogramas congelados superiores al 1% y también para los fotogramas lentos que superen el 5%. Notarás que estos valores están presentes como la configuración predeterminada durante la configuración de alertas de rendimiento. Para obtener más información sobre los fotogramas lentos o congelados en exceso, y otras prácticas recomendadas de rendimiento de la app, consulta la guía de Google Play.