Información general

Datadog Real User Monitoring (RUM) te permite visualizar y analizar los recorridos de cada usuario de tu aplicación.

Configuración

Datadog no admite implementaciones de escritorio (Windows, Mac o Linux), consola o web desde Unity. Si tienes un juego o una aplicación y quieres utilizar Datadog RUM para monitorizar su rendimiento, crea un ticket compatible con Datadog.

Instalación

1. Instala External Dependency Manager for Unity (EDM4U). Esto puede hacerse utilizando Open UPM.

2. Añade el paquete de Unity del SDK de Datadog desde su URL de Git en https://github.com/DataDog/unity-package. La URL del paquete es https://github.com/DataDog/unity-package.git.

3. Configura tu proyecto para utilizar plantillas de Gradle y activa Custom Main Template y Custom Gradle Properties Template.

4. Si compilas y recibes errores Duplicate class (frecuente en Unity 2022.x), añade el siguiente bloque en el bloque dependencies en tu mainTemplate.gradle:

   constraints {
        implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.8.0") {
            because("kotlin-stdlib-jdk8 is now a part of kotlin-stdlib")
        }
   }
   

Especifica los detalles de la aplicación en la interfaz de usuario

1. En Datadog, ve a Experiencia digital > Añadir una aplicación.
2. Elige Unity como tipo de aplicación.
3. Proporciona un nombre de la aplicación para generar un ID de aplicación Datadog y un token de cliente únicos.
4. Para desactivar la recopilación automática de datos de usuario para la IP del cliente o los datos de geolocalización, desactiva las casillas de esa configuración.

Para garantizar la seguridad de tus datos, utiliza un token de cliente. Para obtener más información sobre cómo configurar un token de cliente, consulta la Documentación sobre tokens de cliente.

Especifica la configuración de Datadog en la interfaz de usuario de Unity

Después de instalar el SDK de Datadog Unity, tienes que configurar la configuración de Datadog en la interfaz de usuario de Unity. Ve a tu Project Settings y haz clic en la sección Datadog del lado izquierdo. Verás la siguiente pantalla:

Están disponibles los siguientes parámetros:

Muestreo de sesiones de RUM

Puedes controlar los datos que tu aplicación envía a Datadog RUM durante instrumentación del SDK de RUM Unity. Especifica la Frecuencia de muestreo de sesiones como un porcentaje entre 0 y 100 en la ventana de Configuración de proyectos en Unity.

Utilizar Datadog

Configurar el consentimiento de rastreo

Para cumplir con las políticas de protección de datos y privacidad, el SDK de Datadog Unity requiere la configuración de un valor de consentimiento de rastreo.

La configuración de trackingConsent puede ser uno de los siguientes valores:

• TrackingConsent.Pending: El SDK de Unity comienza a recopilar y procesar los datos por lotes, pero no los envía a Datadog. El SDK de Unity espera el nuevo valor del consentimiento de rastreo para decidir qué hacer con los datos procesados por lotes.
• TrackingConsent.Granted: El SDK de Unity comienza a recopilar los datos y los envía a Datadog.
• TrackingConsent.NotGranted: El SDK de Unity no recopila ningún dato. No se envía ningún log a Datadog.

Antes de que Datadog envíe cualquier dato, se debe confirmar el Tracking Consent del usuario. Esto se configura en TrackingConsent.Pending durante la inicialización y se debe configurar en TrackingConsent.Granted antes de que Datadog envíe cualquier información.

DatadogSdk.Instance.SetTrackingConsent(TrackingConsent.Granted);

Registro

Puedes interceptar y enviar logs desde el registrador de depuración predeterminado de Unity activando la opción y el umbral en la configuración de tus proyectos.

Datadog asigna los niveles de Unity a lo siguiente en los niveles de registro de Datadog:

Puedes acceder a este registrador predeterminado para añadir atributos o etiquetas (tags) a través de la propiedad DatadogSdk.DefaultLogger.

También puedes crear registradores adicionales para un control más específico de los umbrales, los nombres de los servicios, los nombres de los registradores o para proporcionar atributos adicionales.

var registrador = DatadogSdk.Instance.CreateLogger(new DatadogLoggingOptions()
{
    NetworkInfoEnabled = true,
    DatadogReportingThreshold = DdLogLevel.Debug,
});
logger.Info("Hello from Unity!");

logger.Debug("Hello with attributes", new()
{
    { "my_attribute", 122 },
    { "second_attribute", "with_value" },
    { "bool_attribute", true },
    {
        "nested_attribute", new Dictionary<string, object>()
        {
            { "internal_attribute", 1.234 },
        }
    },
});

Los siguientes parámetros están disponibles cuando se crea un nuevo registrador:

Real User Monitoring (RUM)

Rastreo manual de escenas (vistas)

Para rastrear manualmente nuevas escenas (Views en Datadog), utiliza los métodos StartView y StopView:

anulación pública Inicio()
{
    DatadogSdk.Instance.Rum.StartView("My View", new()
    {
        { "view_attribute": "active" }
    });
}

Al iniciar una nueva vista, se cierra automáticamente la vista previa.

Rastreo automático de escenas

También puedes configurar Enable Automatic Scene Tracking en tu configuración de proyectos para activar el rastreo automático de escenas activas. Se utiliza el evento SceneManager.activeSceneChanged de Unity para iniciar automáticamente nuevas escenas.

Solicitudes web/Rastreo de recursos

Datadog ofrece DatadogTrackedWebRequest, que es una envoltura de UnityWebRequest pensada para sustituir directamente a UnityWebRequest. DatadogTrackedWebRequest, activa el Rastreo distribuido de Datadog.

Para activar el rastreo distribuido de Datadog, configura First Party Hosts en la configuración de tu proyecto en un dominio que admita el rastreo distribuido. También puedes modificar la frecuencia de muestreo para el rastreo distribuido configurando Tracing Sampling Rate.

First Party Hosts no permite comodines, pero coincide con cualquier subdominio de un dominio determinado. Por ejemplo, api.example.com coincide con staging.api.example.com y prod.api.example.com, pero no con news.example.com.