Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

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 país, navegador, URL de la página, etc.) de manera que se puede 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 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:

Web v8

const trace = perf.trace("CUSTOM_TRACE_NAME");
trace.start();

// Code that you want to trace 
// ...

trace.stop();

Web v9

import { trace } from "firebase/performance";

const t = trace(perf, "CUSTOM_TRACE_NAME");
t.start();

// Code that you want to trace 
// ...

t.stop();

Agregue seguimientos de código personalizados mediante la API de tiempo de usuario

Además de la Supervisión del rendimiento de rastreo de API, se puede añadir trazas de código personalizado utilizando un navegador nativo del API de tiempo de usuario . El SDK de Performance Monitoring recoge automáticamente la duración de un seguimiento medida con esta API. El uso de la API User Timing es especialmente útil si prefiere cargar el SDK de Performance Monitoring de forma asincrónica. Una vez que se inicializa el SDK, el SDK registrará las medidas que ocurrieron antes de su carga.

Para usar esta función, envuelva el código que desea rastrear con marcas de tiempo de usuario:

Web v8

const performance = window.performance;

performance.mark("measurementStart");

// Code that you want to trace 
// ...

performance.mark("measurementStop");
performance.measure("customTraceName", "measurementStart", "measurementStop");

Web v9

const performance = window.performance;

performance.mark("measurementStart");

// Code that you want to trace 
// ...

performance.mark("measurementStop");
performance.measure("customTraceName", "measurementStart", "measurementStop");

Tenga en cuenta que performance en el ejemplo anterior se refiere a la del navegador window.performance objeto.

Cuando se utiliza la API de sincronización del usuario, las métricas y los atributos personalizados no se pueden agregar a los seguimientos del código personalizado. Usar la Supervisión del rendimiento de rastreo de API si desea agregar esos elementos personalizados a un rastro de código personalizado.

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

Usar la Supervisión del rendimiento Seguimiento de la API 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.

Web v8

async function getInventory(inventoryIds) {
  const trace = perf.trace("inventoryRetrieval");

  // Tracks the number of IDs fetched (the metric could help you to optimize in the future)
  trace.incrementMetric("numberOfIds", inventoryIds.length);

  // Measures the time it takes to request inventory based on the amount of inventory
  trace.start();
  const inventoryData = await retrieveInventory(inventoryIds);
  trace.stop();

  return inventoryData;
}

Web v9

import { trace } from "firebase/performance";

async function getInventory(inventoryIds) {
  const t = trace(perf, "inventoryRetrieval");

  // Tracks the number of IDs fetched (the metric could help you to optimize in the future)
  t.incrementMetric("numberOfIds", inventoryIds.length);

  // Measures the time it takes to request inventory based on the amount of inventory
  t.start();
  const inventoryData = await retrieveInventory(inventoryIds);
  t.stop();

  return inventoryData;
}

Cree atributos personalizados para seguimientos de código personalizados

Usar la Supervisión del rendimiento de rastreo de API 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

Web v8

const trace = perf.trace("test_trace");
trace.putAttribute("experiment", "A");

// Update scenario
trace.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = trace.getAttribute("experiment");

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

// Read attributes
const traceAttributes = trace.getAttributes();

Web v9

import { trace } from "firebase/performance";

const t = trace(perf, "test_trace");
t.putAttribute("experiment", "A");

// Update scenario
t.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = t.getAttribute("experiment");

// Delete scenario
t.removeAttribute("experiment");

// Read attributes
const traceAttributes = t.getAttributes();

Seguimiento, visualización y filtrado de datos de rendimiento

Para ver datos de rendimiento en tiempo real, asegúrese de que su aplicación use una versión del SDK de Performance Monitoring que sea compatible con el procesamiento de datos en tiempo real. Más información .

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 en forma de porcentaje 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 URL de la página para ver los datos de una página específica de su sitio
  • Filtrar por tipo de conexión efectiva de aprender cómo una conexión 3G afecta a su app
  • 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