Skip to content

Latest commit

 

History

History
241 lines (178 loc) · 8.87 KB

monitor-your-unreal-engine-application.mdx

File metadata and controls

241 lines (178 loc) · 8.87 KB
title tags metaDescription isTutorial freshnessValidatedDate translationType
Monitor su aplicación móvil Unreal Engine
Unreal Engine
Mobile monitoring
New Relic Mobile Unreal Engine
Get started
New Relic's Unreal Engine for Android and iOS: Features, compatibility, requirements, installation, and upgrade procedures.
true
2024-04-05T00:00:00.000Z
machine

import mobileHybridSummary from 'images/mobile_screenshot-full_hybrid-summary.webp'

import unrealGuidedInstall from 'images/newrelic_unreal_sdk_installation.webp'

import unrealAgentAppTokenSetup from 'images/newrelic_unreal_sdk_configuration.webp'

import mobileHandledExceptionsSummary from 'images/mobile_screenshot-full_handled-exceptions-summary.webp'

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

  • Capture errores de C++: identifique y solucione problemas rápidamente.
  • Crea evento personalizado y métrico: Entiende cómo interactúa tu usuario con tu aplicación.

<img title="Unreal Engine summary view in the UI" alt="Summary view of a Unreal Engine app in New Relic" src={mobileHybridSummary} style={{ maxWidth: '70%' }} />

**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Mobile > (select an app) > Summary**: vea los datos y los errores de Unreal Engine y monitor el rendimiento de su aplicación a lo largo del tiempo.

Instalación manual [#manual-install]

Si necesita instalar el complemento manualmente, siga los pasos a continuación.

### Revisa los requisitos [#requirements]
Antes de instalar el complemento Unreal Engine, asegúrese de que su aplicación Unreal Engine cumpla con estos requisitos de versión:

* Para aplicaciones nativas de Android:

  * API de Android 24 o superior
  * Ver [los requisitos nativos de Android](/docs/mobile-monitoring/new-relic-mobile-android/get-started/new-relic-android-compatibility-requirements)

* Para aplicaciones nativas de iOS:

  * Ver [requisitos nativos de iOS](/docs/mobile-monitoring/new-relic-mobile-ios/get-started/new-relic-ios-compatibility-requirements)
### Añade el agente a tu proyecto [#add-agent]
1. En el directorio raíz de su proyecto, cree una carpeta llamada `Plugins`.
2. Copie la [carpeta`NewRelic` en Github](https://github.com/ndesai-newrelic/newrelic-unreal-plugin/tree/master/Plugins/NewRelic). Deberías tener algo como

```
  MyProject
  ├── Plugins
          └── NewRelic
              └── NewRelic.uplugin
```
Haga clic en **Restart Now** para continuar con la configuración adicional. Para permitir la interfaz entre el agente y tu código C++, agrega `NewRelic` a la lista de dependencias en el archivo `.Build.cs` de tu módulo de juego: ### Agregar token(s) de aplicación [#app-token]
Para autenticar los datos de su aplicación Unreal Engine con New Relic, agregue los token de su aplicación usando una de estas opciones:

* En la configuración de su proyecto en complemento **→ NewRelic**, pegue los tokens de su aplicación **New Relic token en los campos de aplicación .** Si desea tener aplicaciones New Relic Mobile separadas (una para Android y otra para iOS), deberá agregar ambos tokens de aplicación.

  <img
    title="App token fields in Unreal editor"
    alt="Screenshot of app token fields in project settings"
    src={unrealAgentAppTokenSetup}
    style={{ maxWidth: '70%' }}
  />

* En su archivo `Config/DefaultEngine.ini`, agregue lo siguiente a `/Script/NewRelic.NewRelicSDKSettings`, asegurándose de agregar sus propios token de aplicación:

  ```
  newrelicAppToken=application-token
  newrelicAppTokenIOS=ios-application-token
  ```

Personalizar la instrumentación del agente. [#mobile-sdk]

¿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 complemento Unreal Engine.

  <th>
    Utilice este método
  </th>
</tr>
  <td>
    [Registro de ruta de navegación](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/record-breadcrumb/#unreal)
  </td>
</tr>

<tr>
  <td id="creating">
    Seguimiento de un método como una interacción.
  </td>

  <td>
    [Iniciar interacción](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/start-interaction/#unreal)

    [Detener la interacción](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/stop-interaction/#unreal)
  </td>
</tr>

<tr>
  <td id="create-custom">
    Registro métrico personalizado.
  </td>

  <td>
    [Registro métrico personalizado](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/record-custom-metrics//#unreal)
  </td>
</tr>

<tr>
  <td id="create-custom">
    Registre una excepción.
  </td>

  <td>
    [Errores de registro](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/record-handled-exceptions/#unreal)
  </td>
</tr>

<tr>
  <td id="attributes-events-insights">
    Grabar atributo personalizado y evento.
  </td>

  <td>
    Hay varias formas de reportar atributo personalizado y evento:

    * [Grabar atributo personalizado](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/create-attribute/#unreal)
    * [Incrementar el recuento de atributos de sesión](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/increment-session-attribute-count/#unreal)
    * [Eliminar un atributo](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/remove-attribute/#unreal)
    * [Eliminar todos los atributos](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/remove-all-attributes/#unreal)
    * [Grabar evento personalizado](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/record-custom-events/#unreal)
    * [Establecer el tamaño máximo de un grupo de eventos](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/set-max-event-pool-size/#unreal)
    * [Establecer el tiempo máximo que el agente almacena el evento en la memoria](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/set-max-event-buffer-time/#unreal)
    * [Obtener el ID de una sesión actual](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/current-session-id/#unreal)
    * [Establezca una ID de usuario personalizada para asociar con evento y atributo](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/set-custom-user-id/#unreal)

    Para determinar qué método utilizar, consulte [Informe monitoreo de móviles evento personalizado y atributo](/docs/data-apis/custom-data/custom-events/report-mobile-monitoring-custom-events-attributes/).
  </td>
</tr>

<tr>
  <td>
    Apague el agente.
  </td>

  <td>
    [Cerrar el agente](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/shut-down-agent/#unreal)
  </td>
</tr>

<tr>
  <td>
    Ejecute un informe de fallo de prueba.
  </td>

  <td>
    [Informe de fallos de prueba](/docs/mobile-monitoring/new-relic-mobile/mobile-sdk/test-crash-reporting/#unreal)
  </td>
</tr>
Si quieres...
Registre la ruta de navegación para rastrear la actividad de la aplicación que puede ser útil para resolver problemas.

Monitor errores de C++ [#monitor-errors]

En la New Relic UI, 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.

Mobile Handled Exceptions

Para ver sus errores:

  1. Vaya a

    one.newrelic.com > All capabilities > Mobile

    .

  2. Selecciona tu aplicación Unreal Engine.

  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

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