カスタム変数の追加

.sideおよび.jsスクリプトの内容にカスタム変数を追加すると、これを使用して動的パラメータを定義できます。これにより、Application Performance Monitoringでスクリプトまたはモニターからこれらのパラメータを制御できます。たとえば、ユーザー名または要素選択名が変更されることが予想される場合や、モニターにアクセスできる他のユーザーにそのような値が表示されないように値をシークレットにする場合は、カスタム変数を使用できます。

カスタム・マーカーの追加

カスタム・マーカー・コマンドを.sideおよび.jsスクリプトの内容に追加できます。このスクリプトを使用して、カスタム・メッセージおよび期間をスクリプトからモニタリング・サービスのメトリック・エクスプローラに渡すことができます。これにより、「DURATION: Check Elements」や操作(たとえば、setValue)などのCustomMarkerディメンションをモニタリング・サービスに渡すことができます。CustomMarkerディメンションはCustomMetricメトリックで使用でき、このディメンションを使用すると、ログインからページ全体のロードまでの期間など、トランザクション・ステップの期間マーカーとして次の操作をスクリプトに追加できます。

• setValue: スクリプトの開始時間からこの操作がコールされるまでの期間を記録します。
• startTime: この操作とendTime操作の間の期間を記録します。
• endTime: startTime操作とこの操作の間の期間を記録します。

startTimeおよびendTime操作は相互に連携して動作します。startTimeおよびendTime操作を含むCustomMarkerの場合、メトリック値は<endTime - startTime>です。

CustomMarkerディメンションおよび操作のコマンドと例を次に示します。

• サイドスクリプト:

  実行する操作でコマンド・ブロックを追加します。コマンド値をカスタム・コマンドとして認識するには、コマンド値をoraSynCustomMarkerにする必要があります。コマンド・パラメータtargetおよびvalueの値は、それぞれCustomMarkerディメンションおよび操作の値である必要があります。

  .sideスクリプトでカスタム・マーカーを取得するために使用するコマンドを次に示します:

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

  次に例を示します:

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

• Jsスクリプト:

  次のコマンドを追加します。

  oraSynCustomMarker(customMarker, customOperation)

  customMarkerをCustomMarkerディメンションの値に置き換え、CustomOperationをディメンションで実行する操作に置き換えます。次に例を示します:

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

• Playwrightスクリプト:

  次のフォーマットを使用します:

  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 

メトリックがアラーム指定トリガーを満たしたときに通知されるCustomMetricおよびCustomMarkerディメンションを使用して、モニタリング・サービスにアラームを作成することもできます。アラーム機能およびその作成方法の詳細は、アラームの管理を参照してください。

カスタムスクリーンショットを追加

.sideおよび.tsスクリプトにコマンドを追加して、カスタム・スクリーンショットを取得できます。この機能を使用すると、問題を診断するために、スクリプトの実行中の任意の時点でスクリーンショットを撮ることができます。標準のスクリーンショットに加えて、最大10個のカスタム・スクリーンショットを取ることができます。

マルチファクタ認証(MFA)の使用

可用性モニタリング・トランザクションは、認証シークレットを付与された時間ベースのワンタイム・パスワード(TOTP)トークンを生成するマルチファクタ認証(MFA)をサポートしています。このTOTPを生成するには、モニターの作成時に秘密キーを指定する必要があります。

Vaultシークレットの使用

1. パブリック・バンテージ・ポイント・ポリシー

   APMサービスのポリシーを設定して、特定のボールトまたはコンパートメント内のシークレットにアクセスできます:

   • 特定のボールト:

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

   • 特定のコンパートメント(コンパートメントの名前を使用):

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

     特定のコンパートメント(コンパートメントのIDを使用):

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

2. 専用のバンテージ・ポイント・ポリシー

   APMサービスのポリシーを設定して、コンパートメントの名前またはIDを使用してコンパートメント内のシークレットにアクセスできます:

   • 特定のコンパートメント(コンパートメントの名前を使用):

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

   • 特定のコンパートメント(コンパートメントのIDを使用):

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

3. スクリプトのタイプに応じて、次の構文を使用します。

   • .sideスクリプトの場合は、次の構文を使用します。

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

     例:

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

   • .tsスクリプトの場合は、次の構文を使用します。

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

   • .jsスクリプトの場合は、次の構文を使用します。

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

     例:

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

   このsecretOcidは、実行中に現在のシークレット値をフェッチするために解決されます。

   <ORASREG>構文はオプションです。ボールト・サービスがモニターとは異なるリージョンにある場合に使用できます。vaultRegionを使用して、ボールトとシークレットをそこから解決するリージョンを指定できます。リージョン間で同じスクリプトを使用できます。スクリプトには1つの<ORASREG>region</ORASREG>のみが存在する必要があります。

   ノート
   
   シークレット値の最大長は255です。