Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Agregar monitoreo personalizado para un código de aplicación específico

Supervisión del rendimiento recopila los rastros para ayudar a supervisar el rendimiento de su aplicación. Un seguimiento es un informe de datos de rendimiento capturados entre dos puntos en el tiempo en su aplicación.

Puede crear sus propios seguimientos para supervisar los datos de rendimiento asociados con un código específico en su aplicación. Con un rastro de código personalizado, se puede medir el tiempo que tarda su aplicación para completar una tarea específica o un conjunto de tareas, por ejemplo, la carga de un conjunto de imágenes o consultar su base de datos.

El valor por defecto métrica para un rastro código personalizado es su "duración" (el tiempo entre los puntos de arranque y parada de la traza), pero se puede añadir métricas personalizadas, también.

En su código, define el principio y el final de un seguimiento de código personalizado mediante las API proporcionadas por el SDK de Performance Monitoring.rastros código personalizado se pueden iniciar en cualquier momento después de que hayan sido creados, y que son seguros hilo.

Dado que la métrica predeterminada recopilada para estos seguimientos es "duración", a veces se denominan "seguimientos de duración".

Puede consultar los datos de estos rastros en el rastro de encargo subpestaña de la mesa de huellas, que se encuentra en la parte inferior del panel de rendimiento (más información sobre el uso de la consola más adelante en esta página).

Atributos predeterminados, atributos personalizados y métricas personalizadas

Para rastros de código personalizado, Performance Monitoring registra automáticamente atributos por defecto (metadatos comunes como versión de la aplicación, país, dispositivo, etc.) para que pueda filtrar los datos de la traza en la consola Firebase. También puede agregar y controlar los atributos personalizados (como por ejemplo, el nivel de juego o las propiedades de usuario).

Se puede además configurar un rastro código personalizado para grabar métricas personalizadas para eventos relacionados con el rendimiento que se producen dentro del ámbito de la traza. Por ejemplo, puede crear una métrica personalizada para el número de aciertos y errores de caché o el número de veces que la interfaz de usuario deja de responder durante un período de tiempo notable.

Los atributos personalizados y las métricas personalizadas se muestran en Firebase console junto con los atributos predeterminados y la métrica predeterminada para el seguimiento.

Agregar seguimientos de código personalizados

Usar la Supervisión del rendimiento Seguimiento de la API ( Swift | Obj-C ) para añadir trazas de código personalizado para controlar código de la aplicación específica.

Tenga en cuenta lo siguiente:

  • Una aplicación puede tener varios seguimientos de código personalizados.
  • Se puede ejecutar más de un seguimiento de código personalizado al mismo tiempo.
  • Los nombres de los rastros de código personalizado deben cumplir los siguientes requisitos: no hay espacios en blanco iniciales o finales, ningún líder de subrayado ( _ ) carácter, y la longitud máxima es de 100 caracteres.
  • Rastros de código personalizado permite añadir métricas personalizadas y atributos personalizados .

Para iniciar y detener un seguimiento de código personalizado, envuelva el código que desea rastrear con líneas de código similares a las siguientes:

Rápido

// Add the Performance Monitoring module to your header
import FirebasePerformance

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

// code that you want to trace

trace.stop()

C objetivo

// Add the Performance Monitoring module to your header
@import FirebasePerformance;

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

// code that you want to trace

[trace stop];

Agregue métricas personalizadas a los seguimientos de código personalizados

Usar la Supervisión del rendimiento Seguimiento de la API ( Swift | Obj-C ) para añadir métricas personalizadas a las trazas de código personalizado.

Tenga en cuenta lo siguiente:

  • Los nombres de métricas personalizadas deben cumplir los siguientes requisitos: no hay espacios en blanco iniciales o finales, ningún líder de subrayado ( _ ) carácter, y la longitud máxima es de 100 caracteres.
  • Cada traza código personalizado puede grabar hasta 32 métricas (incluyendo la métrica Duración por defecto).

Para agregar una métrica personalizada, agregue una línea de código similar a la siguiente cada vez que ocurra el evento. Por ejemplo, esta métrica personalizada cuenta los eventos relacionados con el rendimiento que ocurren en su aplicación, como las visitas al caché o los reintentos.

Rápido

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.incrementMetric(named:"EVENT_NAME", by: 1)
// code that you want to trace (and log custom metrics)

trace.stop()

C objetivo

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace incrementMetric:@"EVENT_NAME" byInt:1];
// code that you want to trace (and log custom metrics)

[trace stop];

Cree atributos personalizados para seguimientos de código personalizados

Usar la Supervisión del rendimiento de rastreo de API ( Swift | Obj-C ) para añadir atributos personalizados a las trazas de código personalizado.

Para usar atributos personalizados, agregue código a su aplicación que defina el atributo y lo asocie con un seguimiento de código personalizado específico. Puede establecer el atributo personalizado en cualquier momento entre el inicio del seguimiento y el final del seguimiento.

Tenga en cuenta lo siguiente:

  • Los nombres de los atributos personalizados deben cumplir los siguientes requisitos: no hay espacios en blanco iniciales o finales, ningún líder de subrayado ( _ ) carácter, y la longitud máxima es de 32 caracteres.

  • Cada seguimiento de código personalizado puede registrar hasta 5 atributos personalizados.

  • No debe utilizar atributos personalizados que contengan información que identifique personalmente a una persona ante Google.

    Obtenga más información sobre esta guía

Rápido

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

// Delete scenario.
trace.removeAttribute("experiment")

// Read attributes.
let attributes:[String, String] = trace.attributes;

C objetivo

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [trace attributes];

Seguimiento, visualización y filtrado de datos de rendimiento

Realice un seguimiento de métricas específicas en su panel de control

Para aprender cómo sus métricas clave están en tendencia, añadirlos a su tablero de indicadores en la parte superior del panel de rendimiento. Puede identificar rápidamente las regresiones al ver los cambios semanales o verificar que los cambios recientes en su código estén mejorando el rendimiento.

una imagen del tablero de métricas en el tablero de Firebase Performance Monitoring

Para añadir una métrica para su tablero métricas, vaya al panel de rendimiento en la consola Firebase, a continuación, haga clic en la pestaña Panel. Haga clic en una tarjeta de métrica vacía, luego seleccione una métrica existente para agregar a su tablero. Haga clic en una tarjeta métrica poblada para más opciones, como para reemplazar o eliminar una métrica.

El tablero de métricas muestra los datos métricos recopilados a lo largo del tiempo, tanto en forma gráfica como como un cambio porcentual numérico.

Más información sobre el uso del panel de control .

Ver trazas y sus datos

Para ver sus huellas, vaya al panel de rendimiento en la consola Firebase, desplácese hacia abajo a la mesa de huellas, a continuación, en la subficha apropiado. La tabla muestra algunas métricas principales para cada seguimiento, e incluso puede ordenar la lista por el porcentaje de cambio para una métrica específica.

Si hace clic en el nombre de un seguimiento en la tabla de seguimientos, puede hacer clic en varias pantallas para explorar el seguimiento y profundizar en las métricas de interés. En la mayoría de las páginas, puede utilizar el filtro de botón (parte superior izquierda de la pantalla) para filtrar los datos por atributos, por ejemplo:

una imagen de los datos de Firebase Performance Monitoring que se filtran por atributo
  • Filtrar por versión de la aplicación a la vista de datos de una versión anterior o su última versión
  • Filtrar por dispositivo para aprender cómo manejar los dispositivos más antiguos de su aplicación
  • Filtrar por país para asegurarse de su ubicación base de datos no está afectando a una región específica

Más información sobre la visualización de datos para sus rastros .

Próximos pasos

  • Ver los informes detallados de las sesiones de usuario en la que se puede ver un rastro específico en un contexto línea de tiempo de otros rastros recogidos durante la misma sesión.