• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Monitor seu aplicativo móvel Unity

Nosso agente Unity da New Relic monitora seu aplicativo móvel Unity e fornece insights profundos sobre o desempenho, os erros e a experiência do usuário do seu aplicativo. Depois de instalar e configurar o agente Unity, você será capaz de:

  • Capture C# and Native C++ errors:

    Identifique e corrija problemas rapidamente.

  • Track network requests:

    Veja como seu aplicativo interage com o backend.

  • Use distributed tracing:

    Analise as exceções tratadas e encontre a causa raiz.

  • Create custom events and metrics:

    Entenda como seu usuário interage com seu aplicativo.

Summary view of a Unity app in New Relic

one.newrelic.com > All capabilities > Mobile > (select an app) > Summary: visualize dados do Unity, rastreie solicitações e erros HTTP e monitor o desempenho do seu aplicativo ao longo do tempo.

(Recomendado) Instalação guiada

Para instalar o agente Unity, siga nossa instalação guiada, localizada diretamente na interface.

Screenshot of the guided install UI for Unity

Instalação manual

Se precisar instalar o agente manualmente, siga estas etapas:

Revise os requisitos

Antes de instalar o agente Unity, certifique-se de que seu aplicativo Unity atenda a estes requisitos de versão:

Adicione o agente Unity ao seu projeto

No gerenciador de pacote Unity, adicione o seguinte URL do GitHub:

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

Adicionar token(s) de aplicativo

Para permitir que o New Relic autentique os dados do seu aplicativo Unity, siga estas etapas:

  1. Obtenha seu token de aplicativo da New Relic:

    1. Vá para

      one.newrelic.com

      , clique em

      Add data

      e depois clique em

      Mobile

      .

    2. Selecione seu aplicativo Unity.

    3. Vá para

      Settings > Application

      e copie o

      Application token

      exibido.

  2. Adicione o token ao seu projeto Unity:

    1. Abra seu IDE Unity.

    2. Vá para Tools > New Relic > Getting Started para abrir a janela do editor.

    3. Cole o token de aplicativo apropriado no campo correspondente para cada plataforma compatível com seu aplicativo:

      • Android: cole o token do Android no campo "Android App Token".
      • iOS: cole o token do iOS no campo "iOS App Token".

      Se seu aplicativo for executado em Android e iOS, forneça um token separado para cada plataforma. Não use o mesmo token para ambos.

    Add App Token in Unity Apps

(Somente Android) Configure seu aplicativo Android

Para configurar seu aplicativo Android, você precisa personalizar seus modelos Gradle. Se você estiver usando o Unity 2019 ou posterior, conclua as seguintes etapas:

  1. Inclua o URL do repositório New Relic Maven nas configurações de compilação do Gradle. Para fazer isso, abra seu arquivo mainTemplate.gradle . Este arquivo geralmente está localizado em Assets/Plugins/Android folder. Agora, abra o URL do New Relic Maven assim:

    allprojects {
    buildscript {
    repositories {<DoNotTranslate>**ARTIFACTORYREPOSITORY**</DoNotTranslate>
    google()
    jcenter()
    mavenCentral()
    }
    }
  2. Adicione a New Relic classpath ao arquivo baseProjectTemplate.gradle no nível do projeto. Geralmente você pode encontrar esse arquivo localizado na pasta Android do seu projeto Unity.

    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'
    <DoNotTranslate>**BUILD_SCRIPT_DEPS**</DoNotTranslate>
    }
    }

    Se estiver usando uma versão mais antiga do Unity que requer Gradle 7.0 ou inferior, você precisará usar uma dependência de classpath específica para garantir a compatibilidade:

    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'
    <DoNotTranslate>**BUILD_SCRIPT_DEPS**</DoNotTranslate>
    }
  3. Aplique o plug-in newrelic na parte superior do arquivo launcherTemplate.gradle . Esse arquivo normalmente está localizado na pasta Android do seu projeto Unity.

    apply plugin: "com.android.application"
    apply plugin: 'newrelic' // <-- add this
  4. Adicione as permissões INTERNET e ACCESS_NETWORK_STATE ao seu arquivo AndroidManifest.xml :

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

(somente iOS) Gerenciar dependência

Para iOS, verifique as configurações do Gerenciador de Dependência Externa:

  1. No seu IDE Unity, vá para Assets e abra o External Dependency Manager.

  2. Clique em iOS Resolver.

  3. Na seção Configuração do Podfile, verifique estas configurações:

    • Add use_frameworks! to Podfile

      está desabilitado

    • Always add the main target to Podfile

      está ativado

    Add iOS Dependency in Unity App
  4. Se você não estiver usando o Podfile para gerenciamento de dependências do iOS, siga estas etapas:

    1. Baixe e descompacte o SDK New Relic XCFramework (agente iOS). Você pode obter o agente iOS mais recente em nossas notas de versão do agente iOS.

    2. Adicione o New Relic XCFramework ao seu projeto Xcode:

      1. Descompacte o download do SDK.

      2. No Finder, arraste a pasta NewRelicAgent.xcframework para o projeto Xcode, colocando-a no painel da estrutura de destino.

      3. Na coluna

        Embed

        , clique em

        Embed & Sign

        .

    E pronto! Você deverá começar a ver os dados no New Relic em 5 minutos.

Personalize a instrumentação do agente

Precisa customizar sua instrumentação de agente? Nossos métodos públicos de API do SDK móvel permitem coletar dados personalizados, definir configurações padrão e muito mais.

As personalizações a seguir estão disponíveis para o agente Unity.

Se você quiser...

Use este método

Registre trilhas para rastrear a atividade do aplicativo que pode ser útil para a resolução de problemas de travamento.

Gravar trilhas

Acompanhe um método como uma interação.

Iniciar interação

Pare de interação

Registro métrico personalizado.

Registro métrico personalizado

Registre uma exceção.

Erros de registro

Grave atributo personalizado e evento.

Existem diversas formas de reportar atributo personalizado e evento:

Rastreie solicitações e falhas de rede personalizadas.

Rastrear solicitações HTTP

Rastreie solicitações HTTP com falha

Desligue o agente.

Desligue o agente

Execute um relatório de falha de teste.

Relatório de falhas de teste

Monitor erros de C#

Na interface do New Relic, você pode visualizar seus erros C# fatais e não fatais e exceções tratadas, incluindo detalhes como trilha de evento, atributo e rastreamento de pilha para cada erro registrado.

Para visualizar seus erros:

  1. Vá para

    one.newrelic.com > All capabilities > Mobile

    .

  2. Selecione seu aplicativo Unity.

  3. Clique em

    Exceptions > Handled exceptions

    .

Você também pode criar um dashboard para esses erros usando esta consulta:

SELECT * FROM MobileHandledException SINCE 24 hours ago

Consultar dados log

O New Relic armazena seu log do Unity como evento personalizado. Você pode consultar esses logs e construir um painel para eles usando esta consulta NRQL:

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

Para obter mais informações sobre consulta NRQL, consulte Introdução ao NRQL.

Copyright © 2024 New Relic Inc.

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