• EnglishEspañol日本語한국어Português
  • Inicia sesiónComenzar ahora

Te ofrecemos esta traducción automática para facilitar la lectura.

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

Monitor tu aplicación móvil de Unity

Nuestro agente de New Relic Unity monitorea su aplicación móvil Unity y proporciona información detallada y valiosa sobre el rendimiento, los errores y la experiencia del usuario de su aplicación. Una vez que instale y configure el agente de Unity, podrá:

  • Capture C# and Native C++ errors: Identifique y solucione problemas rápidamente.
  • Track network requests: Vea cómo interactúa su aplicación con el backend.
  • Use distributed tracing: Profundice en las excepciones manejadas y encuentre la causa raíz.
  • Create custom events and metrics: Comprenda cómo interactúa su usuario con su aplicación.
Summary view of a Unity app in New Relic

one.newrelic.com > All capabilities > Mobile > (select an app) > Summary: vea datos de Unity, realice un seguimiento de las solicitudes y errores HTTP y monitor el rendimiento de su aplicación a lo largo del tiempo.

(Recomendado) Instalación guiada

Para instalar el agente de Unity, siga nuestra instalación guiada, ubicada directamente en la UI.

Screenshot of the guided install UI for Unity

Instalación manual

Si necesita instalar el agente manualmente, siga estos pasos:

Revisa los requisitos

Antes de instalar el agente de Unity, asegúrese de que su aplicación de Unity cumpla con estos requisitos de versión:

Agrega el agente de Unity a tu proyecto

En el administrador de paquetes de Unity, agregue la siguiente URL de GitHub:

https://github.com/newrelic/newrelic-unity-agent.git
Unity Agent Install From Package Manager

Agregar token(s) de aplicación

Para permitir que New Relic autentique los datos de su aplicación Unity, siga estos pasos:

  1. Obtenga su token de aplicación de New Relic:

    1. Vaya a one.newrelic.com, haga clic en Integrations & Agents y luego haga clic en Mobile.
    2. Seleccione su aplicación Unity.
    3. Vaya a Settings > Application y copie el Application token mostrado.
  2. Agrega el token a tu proyecto de Unity:

    1. Abra su IDE de Unity.

    2. Vaya a Tools > New Relic > Getting Started para abrir la ventana del editor.

    3. Pegue el token de aplicación apropiado en el campo correspondiente para cada plataforma que admita su aplicación:

      • Android: pegue el token de Android en el campo "Token de aplicación de Android".
      • iOS: pegue el token de iOS en el campo "Token de aplicación iOS".

      Si su aplicación se ejecuta tanto en Android como en iOS, proporcione un token independiente para cada plataforma. No utilices el mismo token para ambos.

    Add App Token in Unity Apps

(Solo para Android) Configura tu aplicación de Android

Para configurar su aplicación de Android necesita personalizar sus plantillas de Gradle. Si está empleando Unity 2019 o posterior, siga los pasos a continuación.

  1. En la configuración de compilación de Gradle, deberá incluir la URL del repositorio Maven de New Relic . Para hacer esto, abra el archivo mainTemplate.gradle , que generalmente se encuentra en la carpeta Assets/Plugins/Android . Agrega el siguiente fragmento:

    allprojects {
    buildscript {
    repositories {
    ARTIFACTORY_REPOSITORY
    google()
    jcenter()
    mavenCentral()
    }
    }
    }
  2. En su archivo baseProjectTemplate.gradle (generalmente ubicado en la carpeta Android de su proyecto Unit), agregue New Relic classpath en el nivel del proyecto:

    dependencies {
    // If you are changing the Android Gradle Plugin version,
    // make sure it is compatible with the Gradle version preinstalled with Unity.
    // See which Gradle version is preinstalled with Unity here:
    // https://docs.unity3d.com/Manual/android-gradle-overview.html
    // See the official Gradle and Android Gradle Plugin compatibility table here:
    // https://developer.android.com/studio/releases/gradle-plugin#updating-gradle
    // To specify a custom Gradle version in Unity, go to "Preferences > External Tools",
    // uncheck "Gradle Installed with Unity (recommended)",
    // and specify a path to a custom Gradle version.
    classpath 'com.newrelic.agent.android:agent-gradle-plugin:7.2.0'
    BUILD_SCRIPT_DEPS
    }

    Si estás usando una versión anterior de Unity que requiere Gradle 7.0 o inferior, necesitarás usar una dependencia de classpath específica para garantizar la compatibilidad:

    dependencies {
    // If you are changing the Android Gradle Plugin version,
    // make sure it is compatible with the Gradle version preinstalled with Unity.
    // See which Gradle version is preinstalled with Unity here:
    // https://docs.unity3d.com/Manual/android-gradle-overview.html
    // See official Gradle and Android Gradle Plugin compatibility table here:
    // https://developer.android.com/studio/releases/gradle-plugin#updating-gradle
    // To specify a custom Gradle version in Unity, go to "Preferences > External Tools",
    // uncheck "Gradle Installed with Unity (recommended)",
    // and specify a path to a custom Gradle version.
    classpath 'com.newrelic.agent.android:agent-gradle-plugin:6.11.0'
    BUILD_SCRIPT_DEPS
    }

    Si su proyecto emplea DSL complementario, realice los siguientes cambios (y omita el paso 3):

    En android/app/build.gradle:

    plugins {
    id "com.android.application"
    id "kotlin-android"
    id "com.newrelic.agent.android" version "7.5.1" //<-- include this
    }
  3. En su archivo launcherTemplate.gradle (generalmente ubicado en la carpeta Android de su proyecto Unity), aplique el complemento newrelic en la parte superior de su archivo launcherTemplate.gradle :

    apply plugin: "com.android.application"
    apply plugin: 'newrelic' // <-- add this
  4. En su archivo AndroidManifest.xml , agregue las siguientes licencias:

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

(solo iOS) Administrar dependencia

Para iOS, verifique la configuración de su Administrador de dependencias externas:

  1. En su IDE de Unity, vaya a Assets y abra External Dependency Manager.

  2. Haga clic en iOS Resolver.

  3. En la sección de configuración de Podfile, verifique estas configuraciones:

    • Add use_frameworks! to Podfile está desactivado
    • Always add the main target to Podfile está habilitado
    Add iOS Dependency in Unity App
  4. Si no estás utilizando Podfile para la gestión de dependencias de iOS, sigue estos pasos:

    1. Descargue y descomprima el SDK de New Relic XCFramework (agente de iOS). Puede obtener el agente iOS más reciente en nuestras notas de la versión del agente iOS.

    2. Agregue New Relic XCFramework a su proyecto Xcode:

      1. Descomprima la descarga del SDK.
      2. Desde su Finder, arrastre la carpeta NewRelicAgent.xcframework a su proyecto Xcode y colóquela en el panel de su marco objetivo.
      3. Debajo de la columna Embed , haga clic en Embed & Sign.

    ¡Y tu estas listo! Deberías empezar a ver datos en New Relic en 5 minutos.

Personalizar la instrumentación del agente.

¿Necesitas personalizar tu instrumentación del agente? Nuestros métodos públicos de API de SDK móvil le permiten recopilar datos personalizados, configurar ajustes predeterminados y más.

Las siguientes personalizaciones están disponibles para el agente de Unity.

Si quieres...

Utilice este método

Registre la ruta de navegación para rastrear la actividad de la aplicación que puede ser útil para resolver problemas.

Registro de ruta de navegación

Seguimiento de un método como una interacción.

Iniciar interacción

Detener la interacción

Registro métrico personalizado.

Registro métrico personalizado

Registre una excepción.

Errores de registro

Grabar atributo personalizado y evento.

Hay varias formas de reportar atributo personalizado y evento:

Realice un seguimiento de las solicitudes y fallas de la red personalizada.

Seguimiento de solicitudes HTTP

Seguimiento de solicitudes HTTP fallidas

Apague el agente.

Cerrar el agente

Ejecute un informe de fallo de prueba.

Informe de fallos de prueba

Monitor errores de C#

En la UI de New Relic, puede ver sus errores fatales y no fatales de C# y las excepciones manejadas, incluidos detalles como traza de evento, atributo y rastreo del stack para cada error registrado.

Para ver sus errores:

  1. Vaya a one.newrelic.com > All capabilities &gt; Mobile.
  2. Seleccione su aplicación Unity.
  3. Haga clic en Exceptions > Handled exceptions.

También puede crear un dashboard para estos errores utilizando esta consulta:

SELECT * FROM MobileHandledException SINCE 24 hours ago

Consultar datos log

New Relic almacena su log de Unity como evento personalizado. Puede consultar estos logs y crear paneles para ellos utilizando esta consulta NRQL:

SELECT * FROM `Mobile Unity Logs` SINCE 30 MINUTES AGO

Para obtener más información sobre la consulta NRQL, consulte Introducción a NRQL.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.