Benutzerdefinierte Variablen hinzufügen

Sie können dem Inhalt der .side- und .js-Skripte benutzerdefinierte Variablen hinzufügen, mit denen dynamische Parameter definiert werden können. Auf diese Weise können Sie diese Parameter über das Skript oder den Monitor in Application Performance Monitoring steuern. Beispiel: Wenn ein Benutzername oder ein Elementauswahlname geändert wird oder Sie einen solchen Wert vor anderen Benutzern mit Zugriff auf den Monitor verbergen möchten, können Sie benutzerdefinierte Variablen verwenden.

Benutzerdefinierte Marker hinzufügen

Sie können benutzerdefinierte Markierungsbefehle zum Inhalt der Skripte .side und .js hinzufügen, mit denen eine benutzerdefinierte Nachricht und Dauer vom Skript an Metrik-Explorer im Monitoring-Service übergeben werden kann. Dadurch können Sie eine CustomMarker-Dimension übergeben, z.B. "DURATION: Check Elements" und einen Vorgang, z.B. setValue an den Monitoring-Service. Die Dimension CustomMarker ist mit der Metrik CustomMetric verfügbar. Mit dieser Dimension können Sie dem Skript die folgenden Vorgänge als Dauermarker für Transaktionsschritte hinzufügen, wie die Dauer zwischen Anmeldung und vollständigem Laden von Seiten:

• setValue: Zeichnet die Dauer zwischen der Startzeit des Skripts bis zum Aufruf dieses Vorgangs auf.
• startTime: Zeichnet die Dauer zwischen diesem Vorgang und dem Vorgang endTime auf.
• endTime: Zeichnet die Dauer zwischen dem Vorgang startTime und diesem Vorgang auf.

Beachten Sie, dass die Vorgänge startTime und endTime miteinander kombiniert werden. Bei einem CustomMarker mit den Vorgängen startTime und endTime lautet der Metrikwert <endTime - startTime>.

Nachfolgend finden Sie die Befehle und Beispiele für die Dimension und Vorgänge CustomMarker:

• Seitenskript:

  Fügen Sie Befehlsblöcke mit dem Vorgang hinzu, den Sie ausführen möchten. Der Befehlswert muss oraSynCustomMarker lauten, damit er als benutzerdefinierter Befehl erkannt wird. Die Werte für die Befehlsparameter target und value müssen der Wert der Dimension CustomMarker bzw. des Vorgangs sein.

  Mit dem folgenden Befehl können Sie einen benutzerdefinierten Marker in einem .side-Skript erfassen:

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

  Beispiel:

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

• JS-Skript:

  fügen Sie den folgenden Befehl hinzu:

  oraSynCustomMarker(customMarker, customOperation)

  Ersetzen Sie customMarker durch den Wert der CustomMarker-Dimension und CustomOperation durch den Vorgang, der für die Dimension ausgeführt werden soll. Beispiel:

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

• Playwright-Skript:

  Verwenden Sie das folgende Format:

  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 

Sie können auch Alarme im Monitoring-Service mit CustomMetric und der CustomMarker-Dimension erstellen, die benachrichtigt werden sollen, wenn die Metrik alarmspezifische Trigger erfüllt. Informationen zum Feature "Alarme" und zu deren Erstellung finden Sie unter Alarme verwalten.

Benutzerdefinierte Screenshots hinzufügen

Sie können einen Befehl zu den Skripten .side und .ts hinzufügen, um benutzerdefinierte Screenshots zu erfassen. Mit dieser Funktion können Sie zu jedem Zeitpunkt während der Ausführung des Skripts Screenshots erstellen, um Probleme zu diagnostizieren. Zusätzlich zu den Standard-Screenshots können Sie maximal zehn benutzerdefinierte Screenshots erstellen.

Multifaktor-Authentifizierung (MFA) verwenden

Availability Monitoring Transactions unterstützt die Multifaktor-Authentifizierung (MFA), die ein TOTP-(Time-Based One-Time Password-)Token generiert, dem das Authentifizierungs-Secret erteilt wird. Für die Generierung dieses TOTP müssen Sie den Secret Key bei der Erstellung des Monitors angeben.

Vault-Secrets verwenden

1. Policy für öffentliche Standorte

   Sie können Policys für den APM-Service festlegen, um auf Secrets in einem bestimmten Vault oder Compartment zuzugreifen:

   • Ein bestimmter Vault:

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

   • Ein bestimmtes Compartment mit dem Namen des Compartments:

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

     Ein bestimmtes Compartment mit der ID des Compartments:

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

2. Policy für dedizierte Standorte

   Sie können Policys für den Zugriff des APM-Service auf Secrets in einem Compartment mit dem Namen oder der ID des Compartments festlegen:

   • Ein bestimmtes Compartment mit dem Namen des Compartments:

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

   • Ein bestimmtes Compartment mit der ID des Compartments:

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

3. Verwenden Sie je nach Skripttyp die folgende Syntax:

   • Verwenden Sie für das Skript .side die folgende Syntax:

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

     Beispiel:

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

   • Verwenden Sie für das Skript .ts die folgende Syntax:

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

   • Verwenden Sie für das Skript .js die folgende Syntax:

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

     Beispiel:

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

   Diese secretOcid wird während der Ausführung aufgelöst, um aktuelle Secret-Werte abzurufen.

   Die <ORASREG>-Syntax ist optional. Sie kann verwendet werden, wenn sich Ihr Vault-Service in einer anderen Region als Monitore befindet. Mit vaultRegion können Sie angeben, in welcher Region sich der Vault befindet und in welcher die Secrets dort aufgelöst werden. Dadurch kann dasselbe Skript regionsübergreifend verwendet werden. Beachten Sie, dass nur eine <ORASREG>region</ORASREG> im Skript vorhanden sein sollte.

   Hinweis
   
   Die maximale Länge für den Secret-Wert beträgt 255.