Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Agregue 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 momentos 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 seguimiento de código personalizado , puede medir cuánto tiempo le toma a su aplicación completar una tarea específica o un conjunto de tareas, por ejemplo, cargar un conjunto de imágenes o consultar su base de datos.

La métrica predeterminada para un seguimiento de código personalizado es su "duración" (el tiempo entre los puntos de inicio y finalización del seguimiento), pero también puede agregar métricas personalizadas .

En su código, define el comienzo y el final de un seguimiento de código personalizado mediante las API proporcionadas por el SDK de Performance Monitoring. Los seguimientos de código personalizado también se pueden iniciar después de que se hayan creado, y son seguros para subprocesos.

Vea datos de seguimientos de código personalizado en la pestaña En el dispositivo de Firebase console ( obtenga más información más adelante en esta página). Tenga en cuenta que, dado que la métrica predeterminada recopilada para estos seguimientos es "duración", a veces se denominan "seguimientos de duración". Además, en Firebase console (en la pestaña En el dispositivo ), estos seguimientos se agrupan en la tabla etiquetada Duraciones .

Atributos predeterminados, atributos personalizados y métricas personalizadas

Para los seguimientos de código personalizados, Performance Monitoring registra automáticamente los atributos predeterminados (metadatos comunes como la versión de la aplicación, el país, el dispositivo, etc.) para que puedas filtrar los datos del seguimiento en Firebase console. También puede agregar y monitorear atributos personalizados (como nivel de juego o propiedades de usuario).

Además, puede configurar un seguimiento de código personalizado para registrar métricas personalizadas para eventos relacionados con el rendimiento que ocurren dentro del alcance del seguimiento. Por ejemplo, puede crear una métrica personalizada para la cantidad de aciertos y errores de caché o la cantidad de veces que la IU 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

Utilice la API de seguimiento de supervisión del rendimiento ( Swift | Obj-C ) para agregar seguimientos de código personalizados para supervisar el código de aplicación específico.

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 para los seguimientos de código personalizado deben cumplir los siguientes requisitos: sin espacios en blanco iniciales o finales, sin carácter de subrayado inicial ( _ ) y la longitud máxima es de 100 caracteres.
  • Los seguimientos de código personalizados admiten la adición de métricas 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];

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

Utilice la API de seguimiento de supervisión del rendimiento ( Swift | Obj-C ) para agregar métricas personalizadas a los seguimientos de código personalizados.

Tenga en cuenta lo siguiente:

  • Los nombres de las métricas personalizadas deben cumplir los siguientes requisitos: sin espacios en blanco iniciales o finales, sin carácter de subrayado inicial ( _ ) y la longitud máxima es de 100 caracteres.
  • Cada seguimiento de código personalizado puede registrar hasta 32 métricas (incluida la métrica de duración predeterminada).

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" by:1];
// code that you want to trace (and log custom metrics)

[trace stop];

Cree atributos personalizados para seguimientos de código personalizados

Utilice la API de seguimiento de supervisión del rendimiento ( Swift | Obj-C ) para agregar atributos personalizados a los seguimientos de código personalizados.

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: sin espacios en blanco iniciales o finales, sin carácter de subrayado inicial ( _ ) 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

Agregue sus métricas clave a su panel de control para conocer sus tendencias. Puede identificar rápidamente las regresiones al ver los cambios semanales o verificar que los cambios recientes en su código mejoren el rendimiento.

una imagen del panel de métricas de Firebase Performance Monitoring

Para agregar una métrica a su panel, vaya al panel de rendimiento en Firebase console y luego 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 panel. Haga clic en en una tarjeta de métrica completa para ver más opciones, como reemplazar o eliminar una métrica.

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

Obtenga más información sobre cómo utilizar el panel .

Ver todos los rastros y sus datos

Para ver estos rastros, vaya al panel de rendimiento en la consola de Firebase, luego haga clic en la pestaña En el dispositivo .

Desde la pestaña En el dispositivo , puede hacer clic en varias pantallas para explorar un rastro y profundizar en las métricas de interés. En la mayoría de las páginas, puede usar el botón filtro (parte superior izquierda de la pantalla) para filtrar los datos por atributo, por ejemplo:

una imagen de los datos de Firebase Performance Monitoring que se filtran por atributo
  • Filtre por versión de la aplicación para ver datos sobre una versión anterior o su última versión
  • Filtre por dispositivo para saber cómo los dispositivos más antiguos manejan su aplicación
  • Filtre por país para asegurarse de que la ubicación de su base de datos no afecte a una región específica

Obtenga más información sobre cómo ver los datos de sus trazas .

Próximos pasos

  • Vea informes detallados de sesiones de usuarios en los que puede ver un seguimiento específico en un contexto de línea de tiempo de otros seguimientos recopilados durante la misma sesión.