Ativar Injeção de Agente do Browser do APM

Pré-requisitos

Você precisa adquirir uma chave de dados pública que é gerada quando o domínio APM é criado.

A chave de dados pública pode ser obtida fazendo o seguinte:
1. Abra o menu de navegação, clique em Observabilidade e Gerenciamento. Em Application Performance Monitoring, clique em Administração.
  Na página Administração, selecione o compartimento e o domínio do APM desejados.
2. Clique em Chaves de Dados em Recursos para listar as chaves de dados.
  
  Se nenhuma chave de dados existir, clique em Gerar Chave de Dados e selecione a Chave de Dados Pública.
3. Clique em Copiar , ao lado de uma chave de dados do tipo Público para recuperar o valor. Este valor será usado posteriormente.
Para obter mais detalhes, consulte Obter Ponto Final de Upload de Dados e Chaves de Dados.

Ativar por meio do Instalador

A partir do APM Agent versão 1.6, você pode ativar a injeção do APM Browser Agent quando o agente for provisionado usando a opção -enable-browser-agent-injection.

Exemplo:

java -jar apm-java-agent-installer-1.6 provision-agent -destination=/example/path/destination -service-name=example_apm_service -private-data-key=ExamplePrivateDataKey -data-upload-endpoint=https://dataUploadEndpoint.com -enable-browser-agent-injection -public-data-key=ExamplePublicDataKey

Em que ExamplePublicDataKey seria substituído pela chave de dados pública recuperada da Console do OCI anteriormente na etapa 3 durante os pré-requisitos.

O agente Java será configurado automaticamente para executar a injeção de agente do navegador na inicialização.

Para exibir as informações de ajuda ao provisionar o agente, use a opção -help. Por exemplo:

java -jar ./apm-java-agent-installer-<version>.jar provision-agent -help
Usage: 
apm-java-agent-installer-<version>.jar provision-agent [options ...] 

options:
...
...
   -enable-browser-agent-injection
       Enables the APM Agent to automatically inject the browser agent into HTML
       pages.  Make sure '-public-data-key' is also set, otherwise injection will
       not be enabled until one is provided.

   -public-data-key=<public_data_key>
       APM Agent public data key for Appserver Agents. This property is required
       for the injected browser agent to connect to the Oracle APM Cloud, and it
       is specific to your APM Cloud Domain.
...
...

Para obter a lista completa de opções, consulte Informações de uso da ajuda.

Ativar o uso do Arquivo AgentConfig.properties

Se você estiver fazendo upgrade de uma versão mais antiga do Agente do APM ou não tiver ativado a injeção do agente do browser por meio do instalador, será necessário ativar esse recurso manualmente após a execução do upgrade ou da instalação do agente.

Navegue até o diretório oracle-apm-agent/config existente. A partir daí, entre no diretório da versão mais recente para a qual você fez upgrade.

Abra o arquivo AgentConfig.properties e atualize as duas propriedades a seguir:

Observação

Eles precisam ser descomentados (o símbolo # precisa ser removido) e atualizados.

com.oracle.apm.agent.rum.enable.inject: Remova o # desta propriedade e defina o valor como true
com.oracle.apm.agent.public.data.key: Remova o # dessa propriedade e defina o valor para a chave de dados pública adquirida da etapa 3 durante os pré-requisitos anteriores.

Depois que as propriedades forem atualizadas, o arquivo será semelhante ao seguinte:

# APM Agent public data key. This property is required for the injected Browser Agent to connect to server, which can be
# obtained at APM service sign up.
# 
... 
...
...
#--------------------------- Start of Browser Agent (RUM) Injection Properties---------------------------------------
# Enables browser agent injection.
# Once enabled, the agent will inject a few lines of JavaScript code into the HTTP pages served by this AppServer.
# It is recommended to test the application and exclude any pages that may be adversely affected by this injection.
# See "Configure APM Browser Agent Injection using APM Java Agent" in the service documentation for more details.
com.oracle.apm.agent.rum.enable.injection=true

# APM Agent public data key. This property is required for the injected Browser Agent to connect to server, which can be
# obtained at APM service sign up.
com.oracle.apm.agent.public.data.key=ExamplePublicDataKey

O Agente Java do APM agora está configurado para começar a executar a injeção do Agente do Browser do APM e pode reunir insights detalhados de métricas reais do usuário, como tempo de Pageload, tempo de DNS e tempo de SSL.

Documentação do Oracle Cloud Infrastructure

Ativar Injeção de Agente do Browser do APM