Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
74a3c9e
commit 8904599
Showing
103 changed files
with
5,829 additions
and
713 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
241 changes: 241 additions & 0 deletions
241
...oring/new-relic-mobile-unreal-engine/monitor-your-unreal-engine-application.mdx
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,241 @@ | ||
--- | ||
title: Monitor su aplicación móvil Unreal Engine | ||
tags: | ||
- Unreal Engine | ||
- Mobile monitoring | ||
- New Relic Mobile Unreal Engine | ||
- Get started | ||
metaDescription: 'New Relic''s Unreal Engine for Android and iOS: Features, compatibility, requirements, installation, and upgrade procedures.' | ||
isTutorial: true | ||
freshnessValidatedDate: '2024-04-05T00:00:00.000Z' | ||
translationType: 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++ para que pueda identificar y solucionar 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%' }} | ||
/> | ||
|
||
<figcaption> | ||
<DoNotTranslate>**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Mobile > (select an app) > Summary**</DoNotTranslate>: vea los datos y los errores de Unreal Engine y monitor el rendimiento de su aplicación a lo largo del tiempo. | ||
</figcaption> | ||
|
||
## Instalación manual [#manual-install] | ||
|
||
Si necesita instalar el complemento manualmente, siga los pasos a continuación. | ||
|
||
<Steps> | ||
<Step> | ||
### 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) | ||
</Step> | ||
|
||
<Step> | ||
### 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 | ||
``` | ||
</Step> | ||
|
||
<Step> | ||
Haga clic en **Restart Now** para continuar con la configuración adicional. | ||
</Step> | ||
|
||
<Step> | ||
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: | ||
</Step> | ||
|
||
<Step> | ||
### 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 | ||
``` | ||
</Step> | ||
</Steps> | ||
|
||
## 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. | ||
|
||
<table> | ||
<thead> | ||
<tr> | ||
<th style={{ width: "300px" }}> | ||
Si quieres... | ||
</th> | ||
|
||
<th> | ||
Utilice este método | ||
</th> | ||
</tr> | ||
</thead> | ||
|
||
<tbody> | ||
<tr> | ||
<td id="crash-analysis"> | ||
Registre la ruta de navegación para rastrear la actividad de la aplicación que puede ser útil para resolver problemas. | ||
</td> | ||
|
||
<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> | ||
</tbody> | ||
</table> | ||
|
||
## 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. | ||
|
||
<img | ||
title="Mobile Handled Exceptions" | ||
alt="Mobile Handled Exceptions" | ||
src={mobileHandledExceptionsSummary} | ||
/> | ||
|
||
Para ver sus errores: | ||
|
||
1. Vaya a | ||
|
||
<DoNotTranslate>**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Mobile**</DoNotTranslate> | ||
|
||
. | ||
|
||
2. Selecciona tu aplicación Unreal Engine. | ||
|
||
3. Haga clic en | ||
|
||
<DoNotTranslate>**Exceptions > Handled exceptions**</DoNotTranslate> | ||
|
||
. | ||
|
||
También puede crear un dashboard para estos errores utilizando esta consulta: | ||
|
||
```sql | ||
SELECT * FROM MobileHandledException SINCE 24 hours ago | ||
``` | ||
|
||
Para obtener más información sobre la consulta NRQL, consulte [Introducción a NRQL](/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language/#where). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.