Atualizar de versões antigas do SDK do JavaScript do Application Insights

  • Artigo

A atualização para a nova versão do SDK do JavaScript do Application Insights pode fornecer várias vantagens, como:

  • Desempenho aprimorado e correções de bugs
  • Novos recursos e funcionalidades
  • Melhor compatibilidade com outras tecnologias
  • Segurança aprimorada e privacidade de dados

Alterações interruptivas na versão do SDK V2:

  • Para permitir melhores assinaturas de API, algumas das chamadas à API, como trackPageView e trackException, foram atualizadas. Não há suporte para a execução no navegador Internet Explorer 8 e versões anteriores.

  • O envelope de telemetria tem alterações de estrutura e nome de campo devido a atualizações de esquema de dados.

  • context.operation movido para context.telemetryTrace. Alguns campos também foram alterados (operation.id -->telemetryTrace.traceID).

    Para atualizar manualmente a ID da exibição de página atual, por exemplo, em aplicativos de página única, use appInsights.properties.context.telemetryTrace.traceID = Microsoft.ApplicationInsights.Telemetry.Util.generateW3CId().

    Observação

    Para manter a ID de rastreamento exclusiva, agora use Util.generateW3CId() onde antes você usou Util.newId(). No final, ambos acabam sendo a ID da operação.

Se você estiver usando o SDK de produção do Application Insights (1.0.20) atual e quiser ver se o novo SDK funciona em tempo de execução, atualize a URL dependendo do seu cenário de carregamento do SDK atual.

  • Download via cenário CDN: Atualize o Script do Carregador de SDK do JavaScript (Web) que você usa atualmente para apontar para a seguinte URL:

    "https://js.monitor.azure.com/scripts/b/ai.3.gbl.min.js"

  • cenário de npm: Chame downloadAndSetup para baixar o script ApplicationInsights completo da CDN e inicialize-o com uma cadeia de conexão:

    appInsights.downloadAndSetup({
   connectionString: "Copy connection string from Application Insights Resource Overview",
   url: "https://js.monitor.azure.com/scripts/b/ai.3.gbl.min.js"
   });

Teste no ambiente interno para verificar se a telemetria de monitoramento está funcionando conforme o esperado. Se tudo funcionar, atualize as suas assinaturas de API adequadamente para o SDK v2 e implante-as nos seus ambientes de produção.

Próximas etapas