Ajouter des variables personnalisées

Vous pouvez ajouter des variables personnalisées au contenu des scripts .side et .js. Ces variables peuvent être utilisées pour définir des paramètres dynamiques. Vous pouvez ainsi contrôler ces paramètres à partir du script ou du moniteur dans Application Performance Monitoring. Par exemple, si le nom d'un utilisateur ou d'une sélection d'éléments est amené à changer, ou si voulez rendre une telle valeur secrète pour que les autres utilisateurs ayant accès au moniteur ne puissent la voir, vous pouvez utiliser des variables personnalisées.

Ajouter des marqueurs personnalisés

Vous pouvez ajouter des commandes de marqueur personnalisées au contenu des scripts .side et .js, qui peuvent être utilisés pour transmettre un message personnalisé et la durée du script à l'explorateur de mesures dans le service Monitoring. Cela vous permet de transmettre une dimension CustomMarker, par exemple "DURATION : Check Elements" et une opération, par exemple, setValue au service Monitoring. La dimension CustomMarker est disponible avec la mesure CustomMetric et à l'aide de cette dimension, vous pouvez ajouter les opérations suivantes au script en tant que marqueurs de durée pour les étapes de transaction, telles que la durée entre la connexion et le chargement complet de la page :

• setValue : enregistre la durée entre l'heure de début du script et l'heure à laquelle cette opération est appelée.
• startTime : enregistre la durée entre cette opération et l'opération endTime.
• endTime : enregistre la durée entre l'opération startTime et cette opération.

Les opérations startTime et endTime fonctionnent conjointement. Pour un élément CustomMarker contenant les opérations startTime et endTime, la valeur de mesure est <endTime - startTime>.

Voici les commandes et exemples de la dimension et des opérations CustomMarker :

• Script latéral :

  Ajoutez des blocs de commande avec l'opération à effectuer. La valeur de la commande doit être oraSynCustomMarker pour qu'elle soit reconnue comme une commande personnalisée. Les valeurs des paramètres de commande target et value doivent correspondre respectivement à la valeur de la dimension CustomMarker et à l'opération.

  Voici la commande utilisée pour capturer un marqueur personnalisé dans un script .side :

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

  Voici un exemple :

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

• Script JS :

  Ajoutez la commande suivante :

  oraSynCustomMarker(customMarker, customOperation)

  Remplacez customMarker par la valeur de la dimension CustomMarker et CustomOperation par l'opération à effectuer sur la dimension. Voici un exemple :

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

• Script Playwright :

  Utilisez le format suivant :

  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 

Vous pouvez également créer des alarmes dans le service Monitoring à l'aide de CustomMetric et de la dimension CustomMarker à avertir lorsque la mesure répond aux déclencheurs spécifiés par l'alarme. Pour plus d'informations sur la fonctionnalité Alarmes et leur création, reportez-vous à Gestion des alarmes.

Ajouter des captures d'écran personnalisées

Vous pouvez ajouter une commande aux scripts .side et .ts pour capturer des captures d'écran personnalisées. Cette fonctionnalité vous permet de prendre des captures d'écran à tout moment pendant l'exécution du script pour diagnostiquer les problèmes. Vous pouvez prendre un maximum de dix captures d'écran personnalisées en plus des captures d'écran standard.

Utiliser l'authentification à plusieurs facteurs

Les transactions de surveillance de la disponibilité prennent en charge l'authentification à plusieurs facteurs qui génère un jeton de mot de passe à usage unique (TOTP) basé sur le temps auquel la clé secrète d'authentification est attribuée. Pour la génération de ce TOTP, vous devez fournir la clé secrète lors de la création du moniteur.

Utiliser des clés secrètes Vault

1. Politique relative aux points d'observation publics

   Vous pouvez définir des stratégies pour que le service APM accède aux clés secrètes d'un coffre ou d'un compartiment spécifique :

   • Un coffre spécifique :

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

   • Compartiment spécifique, avec le nom du compartiment :

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

     Compartiment spécifique, avec l'ID du compartiment :

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

2. Politique relative aux points d'observation dédiés

   Vous pouvez définir des stratégies pour que le service APM accède aux clés secrètes d'un compartiment à l'aide du nom ou de l'ID du compartiment :

   • Compartiment spécifique, avec le nom du compartiment :

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

   • Un compartiment spécifique, à l'aide de l'ID du compartiment :

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

3. Selon le type de script, utilisez la syntaxe suivante :

   • Pour le script .side, utilisez la syntaxe suivante :

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

     Par exemple :

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

   • Pour le script .ts, utilisez la syntaxe suivante :

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

   • Pour le script .js, utilisez la syntaxe suivante :

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

     Par exemple :

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

   Cette commande secretOcid sera résolue lors de l'exécution pour extraire les valeurs de clé secrète en cours.

   La syntaxe <ORASREG> est facultative. Il peut être utilisé lorsque votre service Vault se trouve dans une région différente de celle des moniteurs. Vous pouvez utiliser vaultRegion pour indiquer la région dans laquelle se trouve le coffre et les clés secrètes seront résolues à partir de celui-ci. Il permet d'utiliser le même script entre les régions. Notez qu'un seul élément <ORASREG>region</ORASREG> doit être présent dans le script.

   Remarque
   
   La longueur maximale de la valeur de clé secrète est 255.