Ajouter des variables personnalisées

Vous pouvez ajouter des variables personnalisées au contenu des scripts .side et .js, qui 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 le service de surveillance de la performance des applications. Par exemple, si vous prévoyez qu'un nom d'utilisateur ou un nom de sélection d'élément va changer ou si vous voulez faire d'une telle valeur une clé secrète pour que les autres utilisateurs qui ont accès au moniteur ne puissent pas voir la valeur, vous pouvez utiliser des variables personnalisées.

Ajouter des marqueurs personnalisés

Vous pouvez ajouter des commandes de marqueur personnalisé au contenu des scripts .side et .js, qui peuvent être utilisées pour transmettre un message et une durée personnalisés du script à l'explorateur de mesures dans le service de surveillance. Cela vous permet de transmettre une dimension CustomMarker, par exemple "DURATION : Vérifier les éléments" et une opération, par exemple setValue au service de surveillance. La dimension CustomMarker est disponible avec la mesure CustomMetric et, à l'aide de cette dimension, vous pouvez ajouter les opérations suivantes au script sous forme de marqueurs de durée pour les étapes de transaction, comme 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.

Notez que les opérations startTime et endTime fonctionnent conjointement. Pour une valeur CustomMarker contenant les opérations startTime et endTime, la valeur de mesure est <endTime - startTime>.

Voici les commandes et les 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 en tant que commande personnalisée. Les valeurs des paramètres de commande target et value doivent être la valeur de la dimension CustomMarker et de l'opération respectivement.

  Voici la commande utilisée pour saisir 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")

• Scénario de dramaturge :

  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 de surveillance à l'aide de CustomMetric et de la dimension CustomMarker à aviser lorsque la mesure rencontre des déclencheurs spécifiés par une alarme. Pour plus d'informations sur la fonction d'alarmes et leur création, voir Gestion des alarmes.

Ajouter des captures d'écran personnalisées

Vous pouvez ajouter une commande aux scripts .side et .ts pour saisir 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 multifacteur

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

Utilisation des clés secrètes de chambre forte

1. Politique relative aux points d'observation publics

   Vous pouvez définir des politiques pour le service APM afin d'accéder aux clés secrètes dans une chambre forte ou un compartiment spécifique :

   • Une chambre forte 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>}}
     

   • Un compartiment spécifique, utilisant le nom du compartiment :

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

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

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

2. Politique sur les points d'observation dédiés

   Vous pouvez définir des politiques 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 :

   • Un compartiment spécifique, utilisant 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 opération secretOcid sera résolue lors de l'exécution pour extraire les valeurs de clé secrète courantes.

   La syntaxe <ORASREG> est facultative. Il peut être utilisé lorsque votre service de chambre forte se trouve dans une autre région que les moniteurs. Vous pouvez utiliser vaultRegion pour spécifier la région dans laquelle se trouve votre chambre forte et les clés secrètes seront résolues à partir de celle-ci. Cela 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.

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