Adicionar Variáveis Personalizadas

Você pode adicionar variáveis personalizadas ao conteúdo dos scripts .side e .js, que podem ser usadas para definir parâmetros dinâmicos. Isso permite controlar esses parâmetros do script ou do monitor no serviço Application Performance Monitoring. Por exemplo, se você espera que um nome de usuário ou nome de seleção de elemento seja alterado ou se desejar tornar esse valor um segredo para que outras pessoas que tenham acesso ao monitor não possam ver o valor, use variáveis personalizadas.

Adicionar Marcadores Personalizados

Você pode adicionar comandos de marcador personalizados ao conteúdo dos scripts .side e .js, que podem ser usados para transmitir uma mensagem personalizada e uma duração do script para o Explorador de Métricas no serviço Monitoring. Isso permite que você informe uma dimensão CustomMarker, por exemplo, "DURAÇÃO: Verificar Elementos" e operação, por exemplo, setValue para o serviço Monitoring. A dimensão CustomMarker está disponível com a métrica CustomMetric e usando essa dimensão, você pode adicionar as seguintes operações ao script como marcadores de duração para etapas de transação, como a duração do tempo entre o log-in e o carregamento completo da página:

• setValue: Registra a duração entre a hora inicial do script e a hora em que essa operação é chamada.
• startTime: Registra a duração do tempo entre essa operação e a operação endTime.
• endTime: Registra a duração do tempo entre a operação startTime e essa operação.

Observe que as operações startTime e endTime funcionam juntas entre si. Para um CustomMarker que contém as operações startTime e endTime, o valor da métrica é <endTime - startTime>.

Aqui estão os comandos e exemplos da dimensão e das operações CustomMarker:

• Script secundário:

  Adicione blocos de comando com a operação que você deseja executar. O valor do comando deve ser oraSynCustomMarker para que seja reconhecido como um comando personalizado. Os valores para os parâmetros de comando target e value devem ser o valor da dimensão CustomMarker e a operação respectivamente.

  Este é o comando usado para capturar um marcador personalizado em um script .side:

  {      
      “id”: “36d45a35-5c07-4d86-8144-90ee7b52260b”,      
      “comment”: “”,      
      “command”: “oraSynCustomMarker”,      
      “target”: “Add Marker Name”,      
      “targets”: [],      
      “value”: “setValue”
  }

  Veja um exemplo:

  {      
      “id”: “36d45a35-5c07-4d86-8144-90ee7b52260b”,      
      “comment”: “For calling Availability Monitoring  custom metrics”,      
      “command”: “oraSynCustomMarker”,      
      “target”: “DURATION: Check Elements”,      
      “targets”: [],      
      “value”: “setValue”
  }

• Script Js:

  Adicione o seguinte comando:

  oraSynCustomMarker(customMarker, customOperation)

  Substitua customMarker pelo valor da dimensão CustomMarker e CustomOperation pela operação a ser executada na dimensão. Veja um exemplo:

  oraSynCustomMarker("DURATION: Check Elements", "setValue")

• Script de Playwright:

  Utilize o formato a seguir:

  console.log("oraSynCustomMarker:setValue:SetMarker"); // capturing the marker from the starting of the script
  console.log("oraSynCustomMarker:startTime:PageDuration"); // setting the starting marker 
  console.log("oraSynCustomMarker:endTime:PageDuration"); // setting the end marker of the respective starting marker 

Você também pode criar Alarmes no serviço Monitoring usando CustomMetric e a dimensão CustomMarker a ser notificada quando a métrica atender aos acionadores especificados pelo alarme. Para obter informações sobre o recurso Alarmes e como criá-los, consulte Gerenciando Alarmes.

Adicionar Capturas de Tela Personalizadas

Você pode adicionar um comando aos scripts .side e .ts para capturar capturas de tela personalizadas. Essa funcionalidade permite que você faça capturas de tela a qualquer momento durante a execução do script para diagnosticar problemas. Você pode tirar no máximo dez capturas de tela personalizadas, além das capturas de tela padrão.

Usar autenticação multifator (MFA)

As Transações de Monitoramento de Disponibilidade suportam Autenticação Multifator (MFA) que gera um token TOTP (Senha Única Baseada em Tempo) que recebe o segredo de autenticação. Para a geração desse TOTP, você precisa fornecer a chave secreta durante a criação do monitor.

Usando Segredos do Vault

1. Política de Pontos de Vantagem Públicos

   Você pode definir políticas para o serviço APM para acessar segredos em um vault ou compartimento específico:

   • Um vault específico:

     Allow service applicationperformancemonitoring to read secret-family in compartment <compartment-name> where all 
     {target.vault.id=‘ocid1.vault.oc1.<vault-ocid>’ , any 
     {target.vaultsecret.id=‘ocid1.vaultsecret.oc1.phx.<secret-ocid1>, target.vaultsecret.id=‘ocid1.vaultsecret.oc1.phx.<secret-ocid2>}}
     

   • Um compartimento específico, usando o nome do compartimento:

     Allow service applicationperformancemonitoring to read secret-family in compartment <compartment-name>

     Um compartimento específico, usando o id do compartimento:

     Allow service applicationperformancemonitoring to read secret-family in compartment id <compartment-ocid>

2. Política de Pontos de Vantagem Dedicada

   Você pode definir políticas para o serviço APM para acessar segredos em um compartimento usando o nome ou o id do compartimento:

   • Um compartimento específico, usando o nome do compartimento:

     Allow dynamic-group  <dvp dynamic group eg stack-11-aug-apmSyntheticDVP-dg> read secret-family in compartment <compartment-name>

   • Um compartimento específico, usando o id do compartimento:

     Allow dynamic-group  <dvp dynamic group eg stack-11-aug-apmSyntheticDVP-dg> read secret-family in compartment id <compartment-ocid>

3. Dependendo do tipo de script, use a seguinte sintaxe:

   • Para o script .side, use a seguinte sintaxe:

     <ORAS>secretOcid</ORAS><ORASREG>vaultRegion</ORASREG>

     Por exemplo:

     <ORAS>ocid1.vaultsecret.oc1.phx.abcdefghijklmnopqrstuvwxyz123456789</ORAS><ORASREG>us-phoenix-1</ORASREG>

   • Para o script .ts, use a seguinte sintaxe:

     var password = "<ORAS>ocid1.vault.oc1.vault-ocid</ORAS><ORASREG>vaultRegion</ORASREG>"
     await page.getByRole('textbox', { name: 'password' }).fill(password);

   • Para o script .js, use a seguinte sintaxe:

     method: 'GET',
     url:'<ORAS>secretOcid</ORAS><ORASREG>vaultRegion</ORASREG>'

     Por exemplo:

     method: 'GET',
     url:'<ORAS>ocid1.vaultsecret.oc1.phx.abcdefghijklmnopqrstuvwxyz123456789</ORAS><ORASREG>us-phoenix-1</ORASREG>'

   Este secretOcid será resolvido durante a execução para extrair valores secretos atuais.

   A sintaxe <ORASREG> é opcional. Ele pode ser usado quando seu serviço de vault está em uma região diferente da dos monitores. Você pode usar vaultRegion para especificar em qual região seu vault está e segredos serão resolvidos a partir daí. Ele permite que o mesmo script seja usado em regiões. Observe que apenas um <ORASREG>region</ORASREG> deve estar presente no script.

   Observação
   
   O tamanho máximo do valor secreto é 255.