Información general

Si aún no has configurado el SDK de Datadog Unity para RUM, sigue las instrucciones de configuración dentro de la aplicación o consulta la documentación de configuración de RUM Unity. Aprende a configurar OpenTelemetry con RUM Unity.

Opciones avanzadas de inicialización

Custom Endpoint
opcional
Tipo: cadena
Predeterminado: true
Enviar datos a un endpoint personalizado en lugar del endpoint por defecto de Datadog. Esto es útil para enviar datos a través de un servidor personalizado.
SDK Verbosity
opcional
Tipo: Enum
Predeterminado: Warn
El nivel de información de depuración que el SDK de Datadog debe mostrar. Los niveles más altos mostrarán más información. Esta opción es útil para obtener información de depuración del SDK cuando algo no funciona como se esperaba, o para eliminar las entradas de depuración relacionadas con el SDK de los logs de consola.
Telemetry Sample Rate
opcional
Tipo: doble
Predeterminado: 20 La tase porcentual a la que Datadog envía datos de telemetría interna. Un valor de 100 significa que todos los datos de telemetría se muestrean y se envían a Datadog.

Rastreo automático de vistas

Si seleccionas Enable Automatic Scene Tracking, Datadog se engancha a SceneManager de Unity para detectar carga y descarga de escenas, e inicia vistas de RUM apropiadamente. Si estás usando métodos para moverte entre escenas diferentes a SceneManager, o te gustaría rastrear cambios en vistas que ocurren sin SceneManager, necesitas rastrear vistas manualmente usando DdRum.StartView y DdRum.StopView.

Rastreo de las acciones de los usuarios

Puedes realizar un rastreo de acciones específicas de los usuarios, como toques, clics y desplazamientos, utilizando DdRum.AddAction.

Para registrar manualmente acciones de RUM instantáneas como RumActionType.Tap, utiliza DdRum.AddAction(). Para acciones de RUM continuas como RumActionType.Scroll, utiliza DdRum.StartAction() o DdRum.StopAction().

Por ejemplo:

void DownloadResourceTapped(string resourceName) {
    DatadogSdk.Instance.Rum.AddAction(
        RumActionType.Tap,
        resourceName,
    );
}

Al utilizar DdRum.StartAction y DdRum.StopAction, la acción type debe ser la misma para que el SDK de Unity Datadog haga coincidir el inicio de una acción con su finalización.

Recursos de rastreo

Datadog proporciona DatadogTrackedWebRequest como sustituto de UnityWebRequest para permitir el rastreo de recursos y llamadas HTTP desde tus vistas de RUM.

Puedes utilizarlo del mismo modo que cualquier otra UnityWebRequest:

var request = DatadogTrackedWebRequest.Get("https://httpbin.org/headers");
yield return request.SendWebRequest();

Debug.Log("Got result: " + request.downloadHandler.text);

Rastreo de recursos personalizados

Además de rastrear recursos automáticamente con `DatadogTrackedWebRequest, puedes rastrear recursos personalizados específicos como las solicitudes de red o las APIs de proveedores de terceros con los métodos siguientes:

  • DdRum.StartResource
  • DdRum.StopResource
  • DdRum.StopResourceWithError
  • DdRum.StopResourceWithErrorInfo

Por ejemplo:

// in your network client:

DatadogSdk.Instance.Rum.startResource(
    "resource-key",
    RumHttpMethod.Get,
    url,
);

// Later

DatadogSdk.Instance.Rum.stopResource(
    "resource-key",
    200,
    RumResourceType.Image
);

La string utilizada para resourceKey en ambas llamadas debe ser única para el recurso que está llamando para que el SDK de Unity Datadog pueda hacer coincidir el inicio de un recurso con su finalización.

Rastreo de errores personalizados

Para realizar un rastreo de errores específicos, notifica a DdRum cuando se produzca un error con el mensaje, la fuente, la excepción y los atributos adicionales.

DatadogSdk.Instance.Rum.AddError("This is an error message.");

Rastrear atributos globales personalizados

Además de los atributos RUM predeterminados capturados por el SDK de Unity Datadog automáticamente, puedes optar por añadir información contextual adicional (como atributos personalizados) a tus eventos de RUM para mejorar tu observabilidad dentro de Datadog.

Los atributos personalizados te permiten filtrar y agrupar información sobre el comportamiento observado del usuario (como el valor del carrito, el nivel de comerciante o la campaña publicitaria) con información a nivel de código (como los servicios de backend, la cronología de la sesión, los logs de error y el estado de la red).

Establecer un atributo global personalizado

Para establecer un atributo global personalizado, utiliza DdRum.AddAttribute.

  • Para añadir o actualizar un atributo, utiliza DdRum.AddAttribute.
  • Para extraer la llave, utiliza DdRum.RemoveAttribute.

Rastreo de las sesiones de usuario

Al añadir información de usuario a tus sesiones de RUM, simplificas lo siguiente:

  • Seguir el recorrido de un usuario concreto
  • Conocer qué usuarios se han visto más afectados por los errores
  • Monitorizar el rendimiento de tus usuarios más importantes
API de usuario en la interfaz de usuario de RUM

Los siguientes atributos son opcionales, proporciona al menos uno de ellos:

AtributoTipoDescripción
usr.idCadenaIdentificador de usuario único.
usr.nameCadenaNombre descriptivo, que se muestra por defecto en la interfaz de usuario de RUM.
usr.emailCadenaCorreo electrónico del usuario, que se muestra en la interfaz de usuario de RUM si el nombre de usuario no está presente. También se usa para obtener Gravatars.

Para identificar las sesiones de usuario, utiliza DatadogSdk.SetUserInfo.

Por ejemplo:

DatadogSdk.Instance.SetUserInfo("1234", "John Doe", "john@doe.com");

Añadir atributos de usuario personalizados

Puedes añadir atributos personalizados a tu sesión de usuario. Esta información adicional se aplica automáticamente a logs, trazas y eventos de RUM.

Para eliminar un atributo existente, configúralo en null.

Por ejemplo:

DatadogSdk.Instance.AddUserExtraInfo(new ()
{
 { "attribute_1", "foo" },
 { "attribute_2", null },
});

Borrar todos los datos

Utiliza ClearAllData para borrar todos los datos que no se hayan enviado a Datadog.

DatadogSdk.instance.ClearAllData();

Referencias adicionales