Instrumente seu projeto watchOS com New Relic

Este documento mostra como atualizar seu projeto watchOS para que você possa monitor com New Relic. Como os projetos watchOS ainda não contêm uma classe ApplicationDelegate ou ExtensionDelegate , você precisará adicionar uma ou outra ao seu projeto. Esses delegados são necessários para configurar e iniciar o agente New Relic em um projeto watchOS.

Requisitos

Antes de adicionar o WatchAppDelegate, primeiro instale o agente New Relic.

Depois de instalar o agente, consulte as instruções abaixo para usar WatchAppDelegate ou a extensão watchOs.

Habilite New Relic com WatchAppDelegate

1. Crie um arquivo WatchAppDelegate.swift em seu projeto e adicione uma classe chamada WatchAppDelegate que herda de NSObject. Esta classe deve estar em conformidade com o protocolo WKApplicationDelegate .

2. Adicione o applicationDidFinishLaunching à classe WatchAppDelegate . O mais próximo possível do início da função applicationDidFinishLaunching , adicione NewRelic.start(withApplicationToken: "APP_TOKEN"). Certifique-se de substituir APP_TOKEN pelotoken do seu aplicativo. Seu código pode ficar assim:

   import WatchKit
   import NewRelic
       
   class WatchAppDelegate: NSObject, WKApplicationDelegate {
       func applicationDidFinishLaunching() {
           NewRelic.start(withApplicationToken: "APP_TOKEN")
           return true
       }
   }

   Copiar

3. No objeto de estrutura principal do aplicativo, adicione o seguinte trecho:

   import NewRelic
   
   @main
   struct Watch_App: App {
       @WKApplicationDelegateAdaptor var appDelegate: WatchAppDelegate
   }

   Copiar

Habilite New Relic com extensão watchOS

1. Adicione a chave WKExtensionDelegateClassName ao arquivo Info.plist da sua extensão WatchKit. Isso cria automaticamente um objeto delegado denominado ExtensionDelegate. Para obter mais informações, consulte WKExtensionDelegate.

2. Na classe ExtensionDelegate que você criou, adicione a função applicationDidFinishLaunching .

3. O mais próximo possível do início de applicationDidFinishLaunching , adicione NewRelic.start(withApplicationToken: "APP_TOKEN") substituindo APP_TOKEN pelo token do seu aplicativo. Seu código pode ficar assim:

   import WatckKit
   import NewRelic
       
   class ExtensionDelegate: NSObject, WKExtensionDelegate {
       func applicationDidFinishLaunching() {
           NewRelic.start(withApplicationToken: "APP_TOKEN")
           return true
       }
   }

   Copiar

Limitações da plataforma watchOS

A Apple não fornece a mesma API iOS para a plataforma watchOS. Isso significa que determinados recursos de agente do iOS ainda não estão disponíveis no watchOS. Buscamos ter paridade em nossa plataforma, então conforme a Apple lançar novas funcionalidades, continuaremos atualizando o agente. Aqui estão alguns recursos conhecidos e atualmente não suportados:

• Tratamento de falhas: PLCrashReporter é uma biblioteca de terceiros usada pelo agente, que não é compatível com watchOS.
• Contagem de falhas: como as falhas não são relatadas no watchOS, não podemos coletar a contagem de falhas.
• Exceções tratadas: o agente captura e carrega exceções tratadas, mas a New Relic não pode exibi-las no momento.
• Coleta em segundo plano: se NRFeatureFlag_BackgroundReporting estiver ativado, o agente continuará monitor o aplicativo, mas não coletará nem fará upload para o New Relic enquanto estiver em segundo plano.
• Evento marcado offline: Se NRFeatureFlag_OfflineStorage estiver habilitado, o agente poderá armazenar colheitas offline e então enviá-las quando estiver online. um evento criado em estado offline, entretanto, não será marcado como tal no nível de atributo.
• Horários de início do aplicativo quente/frio: O agente depende da notificação do UIKit para capturar os horários de início quente/frio, mas esta informação ainda não está disponível para watchOS.

Se precisar de ajuda adicional, você pode entrar em contato com o suporte em support.newrelic.com.