Aggiungi variabili personalizzate

È possibile aggiungere variabili personalizzate ai contenuti degli script .side e .js, che possono essere utilizzati per definire i parametri dinamici. Ciò consente di controllare questi parametri dallo script o dal monitoraggio in Application Performance Monitoring. Ad esempio, se si prevede la modifica di un nome utente o di un nome di selezione elemento o se si desidera rendere segreto tale valore in modo che gli altri utenti che hanno accesso al monitoraggio non possano visualizzare il valore, è possibile utilizzare variabili personalizzate.

Aggiungi indicatori personalizzati

È possibile aggiungere comandi indicatore personalizzati ai contenuti degli script .side e .js, che possono essere utilizzati per passare un messaggio personalizzato e la durata dallo script a Metrics Explorer nel servizio di monitoraggio. Ciò consente di passare una dimensione CustomMarker, ad esempio "DURATION: Check Elements" e l'operazione, ad esempio setValue, al servizio di monitoraggio. La dimensione CustomMarker è disponibile con la metrica CustomMetric e utilizzando questa dimensione è possibile aggiungere allo script le operazioni seguenti come indicatori di durata per i passi transazione, ad esempio la durata del tempo tra il login e il caricamento della pagina completa:

• setValue: registra la durata tra l'ora di inizio dello script e l'ora di chiamata dell'operazione.
• startTime: registra la durata tra questa operazione e l'operazione endTime.
• endTime: registra la durata dell'intervallo di tempo tra l'operazione startTime e questa operazione.

Si noti che le operazioni startTime e endTime funzionano insieme. Per un valore CustomMarker contenente le operazioni startTime e endTime, il valore della metrica è <endTime - startTime>.

Di seguito sono riportati i comandi e gli esempi della dimensione e delle operazioni CustomMarker.

• Script laterale:

  Aggiungere i blocchi di comando con l'operazione che si desidera eseguire. Il valore del comando deve essere oraSynCustomMarker per essere riconosciuto come comando personalizzato. I valori dei parametri di comando target e value devono essere rispettivamente il valore della dimensione CustomMarker e dell'operazione.

  Di seguito è riportato il comando utilizzato per acquisire un indicatore personalizzato in uno script .side.

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

  Di seguito viene fornito un esempio.

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

• Script Js:

  Aggiungere il comando seguente:

  oraSynCustomMarker(customMarker, customOperation)

  Sostituire customMarker con il valore della dimensione CustomMarker e CustomOperation con l'operazione da eseguire sulla dimensione. Di seguito viene fornito un esempio.

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

• Scrittura di Playwright:

  Utilizzare il formato riportato di seguito:

  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 

È inoltre possibile creare allarmi nel servizio di monitoraggio utilizzando CustomMetric e la dimensione CustomMarker a cui inviare una notifica quando la metrica soddisfa i trigger specificati dall'allarme. Per informazioni sulla funzione Allarmi e su come crearli, vedere Gestione degli allarmi.

Aggiungi screenshot personalizzati

È possibile aggiungere un comando agli script .side e .ts per acquisire screenshot personalizzati. Questa funzionalità consente di eseguire screenshot in qualsiasi momento durante l'esecuzione dello script per diagnosticare i problemi. Oltre agli screenshot standard, puoi eseguire al massimo dieci screenshot personalizzati.

Usa autenticazione con più fattori (MFA)

Le transazioni di monitoraggio della disponibilità supportano l'autenticazione a più fattori (MFA) che genera un token TOTP (Time-Based One-Time Password) a cui viene assegnato il segreto di autenticazione. Per la generazione di questo TOTP è necessario fornire la chiave segreta durante la creazione del monitor.

Uso dei segreti vault

1. Criterio punti di osservazione pubblici

   È possibile impostare i criteri per il servizio APM per accedere ai segreti in un vault o compartimento specifico:

   • Un vault specifico:

     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>}}
     

   • Un compartimento specifico, utilizzando il nome del compartimento:

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

     Un compartimento specifico, utilizzando l'ID del compartimento:

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

2. Criterio dei punti di osservazione dedicati

   È possibile impostare i criteri per il servizio APM per accedere ai segreti in un compartimento utilizzando il nome o l'ID del compartimento:

   • Un compartimento specifico, utilizzando il nome del compartimento:

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

   • Un compartimento specifico, utilizzando l'ID del compartimento:

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

3. A seconda del tipo di script, utilizzare la seguente sintassi:

   • Per lo script .side, utilizzare la seguente sintassi:

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

     Ad esempio:

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

   • Per lo script .ts, utilizzare la seguente sintassi:

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

   • Per lo script .js, utilizzare la seguente sintassi:

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

     Ad esempio:

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

   Questo valore secretOcid verrà risolto durante l'esecuzione per recuperare i valori segreti correnti.

   La sintassi <ORASREG> è facoltativa. Può essere utilizzato quando il servizio vault si trova in un'area diversa rispetto ai monitoraggi. È possibile utilizzare vaultRegion per specificare in quale area si trova il vault e i segreti verranno risolti da tale area. Consente di utilizzare lo stesso script in tutte le aree. Lo script deve contenere un solo <ORASREG>region</ORASREG>.

   Nota
   
   La lunghezza massima per il valore segreto è 255.