Você pode implantar o agente do browser do APM inserindo um JavaScript em todas as páginas do aplicativo e permitir que o serviço Application Performance Monitoring reporte a experiência real do usuário.

Para inserir o JavaScript:

1. Edite a origem HTML das páginas do aplicativo monitorado.
   Observação
   
   

   • Para aplicativos Web empacotados, geralmente há um modelo de página usado para todas as páginas pertencentes ao aplicativo Web.

     Certifique-se de incluir também o script específico do aplicativo empacotado, se aplicável. Para obter detalhes, consulte Implantar o Agente do Browser do APM com Aplicativos Empacotados.

   • A configuração pode ser armazenada no objeto window.apmrum ou document.apmrum.

     Certifique-se de usar o mesmo objeto consistentemente para evitar configurações confusas. A carga lenta é usada para as propriedades do objeto e as atualizações são aplicadas dinamicamente.

2. Especifique valores para as propriedades a seguir e insira o script após a tag de fechamento </head>. Não adicione o código dentro de outra tag <script>:
   • window.apmrum.serviceName: Especifique um nome para o serviço. Se você não especificar o nome do serviço, o nome do serviço padrão, APM Browser, será designado. É recomendável especificar um nome de serviço para poder filtrar por serviço e monitorar os intervalos correspondentes.
   • window.apmrum.webApplication: Especifique um nome para o aplicativo Web, que pode ser usado para classificar áreas funcionais de implantação. Se nenhum valor para webApplication for especificado, o valor padrão "Padrão WebApp" será usado.
   • window.apmrum.ociDataUploadEndpoint: Especifique o Ponto Final de Upload de Dados que determina o data center e o domínio para o qual os dados RUM serão submetidos a upload. O valor do Ponto Final de Upload de Dados pode ser obtido fazendo o seguinte:
     • Vá para a Console do OCI, navegue até Observabilidade e Gerenciamento > Application Performance Management > Administração e selecione o domínio desejado.
     • Clique em Copiar ao lado de Ponto Final de Upload de Dados para copiar o valor na área de transferência e usá-lo para definir o valor de window.apmrum.ociDataUploadEndpoint.
   • window.apmrum.OracleAPMPublicDataKey: Especifique a dataKey pública que é gerada quando o domínio do APM é criado. A dataKey pública pode ser obtida fazendo o seguinte:
     • Vá para a Console do OCI, navegue até Observabilidade e Gerenciamento > Application Performance Management > Administração e selecione o Compartimento e o Domínio desejados.
     • Clique em Chaves de Dados em Recursos. Se não houver nenhuma chave de dados, clique em Gerar Chave de Dados e selecione Chave de Dados Pública.
     • Clique em Copiar ao lado de uma chave de dados do tipo 'Público' para recuperar o valor a ser usado para preencher o valor de window.apmrum.OracleAPMPublicDataKey.

   Para otimizar o desempenho de usuários do aplicativo monitorado, é necessário especificar a localização de uma biblioteca JavaScript e garantir que a ela esteja acessível na rede.

   JavaScript Exemplo

   O script tem a seguinte aparência:

   <script>
   window.apmrum = (window.apmrum || {}); 
   window.apmrum.serviceName='<APM Browser>';
   window.apmrum.webApplication='<Web App Name>';
   window.apmrum.ociDataUploadEndpoint='<ociDataUploadEndpoint>';
   window.apmrum.OracleAPMPublicDataKey='<APM_Public_Datakey>';
   </script>
   <script async crossorigin="anonymous" src="<ociDataUploadEndpoint>/static/jslib/apmrum.min.js"></script>

   Em que:

   • <APM Browser> corresponde ao valor do nome do serviço que você especifica para o agente do Browser do APM. Se você não definir um valor, o nome de serviço padrão APM Browser será designado.
   • <Web App Name> é o valor do nome do aplicativo da Web.
   • <ociDataUploadEndpoint> corresponde ao valor do Ponto Final de Upload de Dados. Ele pode ser obtido na página Administração do APM. Consulte Obter Ponto Final de Upload de Dados e Chaves de Dados.
   • <APM Public Datakey> corresponde ao valor da Datakey Pública do APM que pode ser obtido no menu Administração da página principal do APM.

   Por exemplo, se o valor do Ponto Final de Upload de Dados for aaaac5d2kke6waaaaaaaaala.apm-agtTERM:us-ashburn-1.oci.oraclecloud.com e o valor da Datakey Pública do APM for IMWJ5UN2C6YOLQSUZ5Q7IGN3QACF4AZD, o script será semelhante a:

   <script>
   window.apmrum = (window.apmrum || {});
   window.apmrum.serviceName='Apm Browser1';
   window.apmrum.webApplication='Webapp';
   window.apmrum.ociDataUploadEndpoint='https://aaaac5d2kke6waaaaaaaaaaala.apm-agt.us-ashburn-1.oci.oraclecloud.com';
   window.apmrum.OracleAPMPublicDataKey='IMWJ5UN2C6YOLQSUZ5Q7IGN3QACF4AZD';
   </script>
   <script async crossorigin="anonymous" src="https://aaaac5d2kke6waaaaaaaaaaala.apm-agt.us-ashburn-1.oci.oraclecloud.com/static/jslib/apmrum.min.js"></script>

   O uso da referência a <ociDataUploadEndpoint>/static/jslib/apmrum.min.js em sua instrumentação garante que o monitoramento do APM sempre aproveite a versão mais recente disponível do Agente do Browser do APM.

   Uma vez concluída, consulte Verificar Implantação do Agente do Browser do APM

   Observação
   
   

   • Para obter mais informações sobre os valores DataKey e DataUploadEndpoint públicos, consulte Obter Ponto Final de Upload de Dados e Chaves de Dados.

   • Se você tiver um aplicativo empacotado, consulte Implantar o Agente do Browser do APM com Aplicativos Empacotados.