可用性モニタリング機能を設定するには、地理的位置全体にわたってアプリケーションの可用性とパフォーマンスをモニターするためのモニターを作成し、メトリックをOracle Cloud Infrastructureに送信する必要があります。

1. 「可用性モニタリング」ページに移動します。
2. 左側のペインで、「モニター」が選択されていることを確認します。
3. 左側のペインで、モニターを作成するコンパートメントとAPMドメインを選択します。
4. 「モニターの作成」をクリックします。
   モニターの作成ウィザードが表示されます。
5. 「モニター定義」ページで:
   1. 名前: モニターの一意の名前を入力します。

      名前には最大255文字の英数字を使用できます。ハイフンとアンダースコアは、2つの特殊文字のみ使用できます。たとえば、名前の先頭または末尾、または文字の間にある2文字とアンダースコアの間にハイフンを追加できます。空白は使用できません。

   2. タイプ: 次のいずれかのモニター・タイプを選択します:
      • ブラウザ: ブラウザによってロードされた単一URLのパフォーマンスをテストします。
      • スクリプト化ブラウザ: .sideスクリプト・ファイルに記録された完全なユーザー・トランザクション・ワークフローのパフォーマンスをテストします。
      • REST: RESTコールによってロードされた単一URLのパフォーマンスをテストします。
      • スクリプト化REST: .jsスクリプト・ファイルに記録された完全なユーザー・トランザクション・ワークフローのパフォーマンスをテストします。
      • ネットワーク: ホストにpingすることで実現されるネットワーク・サーバーまたはホストの可用性およびパフォーマンスをテストします。
      • DNS: DNSの可用性を検証およびテストします。
      • SQL: SQL問合せのパフォーマンスを測定し、ユーザーが可用性またはロード時間の問題を検出できるようにします。
      • FTP: FTP操作のパフォーマンスを測定し、ユーザーが可用性またはレイテンシの問題を検出できるようにします。ターゲットFTPサーバーの詳細を入力として取得し、リクエストされた操作を実行して様々なタイミング・メトリックを生成します。
   3. 前のステップで選択したモニター・タイプに基づいて、表示されるフィールドを更新します:
      • 「ブラウザ」モニター・タイプの場合:
        1. ベースURL: モニターを実行するベースURLを指定します。
        2. レスポンスの検証: オプションで次のチェック・ボックスを選択します:
           • レスポンス・コード:有効なHTTPステータス・コードをカンマで区切って指定します。例: 200,401また、2xx, 3xx, 4xxという形式も使用できます。
           • レスポンス・コンテンツの検証:レスポンス・ヘッダーおよび本文で予期されるレスポンスを検証するために、文字列またはREGEXを追加します。
        3. レスポンス・コンテンツの検証 オプション: オプションで、予期されるレスポンス・コンテンツを検証するための文字列を追加します。詳細は、「レスポンス・コンテンツの検証(オプション)」を参照してください。
        4. オプション: オプションで、次のチェック・ボックスを選択します:
           • SSLの検証: SSL証明書の有効性を検証するには、このオプションを選択します。
           • スナップショットの有効化: 実行中にスクリーンショットを収集するためにモニターを有効または無効にするには、このオプションを選択します。デフォルトでは、これは有効です。
           • DNSのオーバーライド: 標準のDNS解決を使用するかわりに、ターゲットのドメイン名が解決されるIPアドレスを指定するには、このオプションを選択します。
      • 「スクリプト化ブラウザ」モニター・タイプの場合:
        1. スクリプト: ドロップダウン・リストからスクリプト・ファイルを選択します。これには、作成した.sideスクリプトの名前が移入されます。
        2. ベースURL オプション: 選択した.sideスクリプト・ファイルに基づいて、モニターが実行されるベースURLがこのフィールドに移入されます。オプションで、このフィールドにベースURLを指定することもできます。
        3. スクリプト・パラメータ: スクリプト・ファイルの内容でスクリプト・パラメータが定義されている場合は、「スクリプト・パラメータ」フィールドにスクリプト・パラメータが表示されます。パラメータの値を置換するように選択できます。スクリプトの作成時またはアップロード時に「値はシークレットです」オプションが使用された場合、パラメータ値は表示されません。
        4. オプション: オプションで、次のチェック・ボックスを選択します:
           • SSLの検証: SSL証明書の有効性を検証するには、このオプションを選択します。
           • スナップショットの有効化: 実行中にスクリーンショットを収集するためにモニターを有効または無効にするには、このオプションを選択します。デフォルトでは、これは有効です。
           • DNSのオーバーライド: 標準のDNS解決を使用するかわりに、ターゲットのドメイン名が解決されるIPアドレスを指定するには、このオプションを選択します。
      • 「REST」モニター・タイプの場合:
        1. ベースURL: モニターを実行するベースURLを指定します。
        2. リクエスト構成メソッド: リクエスト構成メソッド(GETまたはPOST)を選択します。POSTメソッドの場合、オプションで「リクエスト本文」フィールドにリクエスト・ペイロード情報を入力できます。
        3. 認証タイプ: 認証のタイプを選択します:
           • なし: 認証が不要な場合は、このオプションを選択します。
           • 基本認証: 基本認証が必要な場合はこのオプションを選択し、「ユーザー名」および「パスワード」を指定します。
           • Bearerトークン: ベアラー認証が必要な場合はこのオプションを選択し、「トークン」を指定します。
           • OAuth: オープン認証が必要な場合はこのオプションを選択し、「認証スキーム」と、認証スキームに基づいて表示されるフィールドに情報を指定します。
           • リソース・プリンシパル:資格証明を指定せずに、オブジェクト・ストレージやボールトなどのOCIリソースへのアクセス権を付与し、モニターするには、このオプションを選択します。動的グループおよびポリシーを使用して、ファイングレイン制御を提供します。
             ノート
             
             リソース・プリンシパル認証を使用するには、動的グループを作成し、それにポリシーを追加してテナンシ内のリソースにアクセスし、APM可用性モニターにテナンシ内のOCIリソースへのアクセス権を付与する必要があります。詳細は、Oracle Cloud Infrastructureの前提条件の実行を参照してください。
        4. 問合せパラメータ オプション: オプションで、リクエスト構成問合せパラメータを指定します。
        5. ヘッダー・パラメータ オプション: オプションで、リクエスト構成ヘッダー・パラメータを指定します。
        6. クライアント証明書 オプション: オプションで、クライアント認証の証明書情報を指定します。
           • 秘密キー: 秘密キー・ファイルをアップロードします。
           • Certificate: クライアント証明書ファイルをアップロードします。
             ノート
             
             PEM形式は、秘密キーおよびクライアント証明書でサポートされています。
        7. レスポンスの検証: オプションで次のチェック・ボックスを選択します:
           • レスポンス・コード:有効なHTTPステータス・コードをカンマで区切って指定します。例: 200,401また、2xx, 3xx, 4xxという形式も使用できます。
           • レスポンス・コンテンツの検証: レスポンス・ヘッダーおよび本文で予期されるレスポンスを検証するために、文字列またはREGEXを追加します。
        8. オプション: オプションで、次のチェック・ボックスを選択します:
           • SSLの検証: SSL証明書の有効性を検証するには、このオプションを選択します。
           • リダイレクトのフォロー: このオプションを選択して、リダイレクトに従います。
           • DNSのオーバーライド: 標準のDNS解決を使用するかわりに、ターゲットのドメイン名が解決されるIPアドレスを指定するには、このオプションを選択します。
      • 「スクリプト化REST」モニター・タイプの場合:
        1. スクリプト: ドロップダウン・リストからスクリプト・ファイルを選択します。これには、作成した.jsスクリプトの名前が移入されます。
        2. ベースURL オプション: 選択した.jsスクリプト・ファイルに基づいて、モニターが実行されるベースURLがこのフィールドに移入されます。オプションで、このフィールドにベースURLを指定することもできます。
        3. スクリプト・パラメータ: スクリプト・ファイルの内容でスクリプト・パラメータが定義されている場合は、「スクリプト・パラメータ」フィールドにスクリプト・パラメータが表示されます。パラメータの値を置換するように選択できます。スクリプトの作成時またはアップロード時に「値はシークレットです」オプションが使用された場合、パラメータ値は表示されません。
        4. 認証:オプションで、次のチェック・ボックスを選択します:
           • リソース・プリンシパル:資格証明を指定せずに、オブジェクト・ストレージやボールトなどのOCIリソースへのアクセス権を付与し、モニターするには、このオプションを選択します。
             前提条件:リソース・プリンシパル認証を使用するには、次の前提条件を実行します:

             • ポリシー:動的グループを作成し、それにポリシーを追加してテナンシ内のリソースにアクセスし、APM可用性モニターにテナンシ内のOCIリソースへのアクセス権を付与します。詳細は、Oracle Cloud Infrastructureの前提条件の実行を参照してください。
             • Javaスクリプト・ファイルの変更:スクリプトで次の変更を行います。
               • oci-commonモジュールを含める

                 const common = require('oci-common');

               • 署名者の作成

                 const provider = common.ResourcePrincipalAuthenticationDetailsProvider.builder();const signer = new common.DefaultRequestSigner(provider)

               • 署名リクエスト

                 signer.signHttpRequest(options)

               • ヘッダーのコピー

                 var headers = {};

                 options.headers.forEach(function(i,v){

                 headers[v] = i;

                 });

        5. レスポンスの検証: オプションで次のチェック・ボックスを選択します:
           • レスポンス・コード:有効なHTTPステータス・コードをカンマで区切って指定します。例: 200,401また、2xx, 3xx, 4xxという形式も使用できます。
        6. オプション: オプションで、次のチェック・ボックスを選択します。
           • DNSのオーバーライド: 標準のDNS解決を使用するかわりに、ターゲットのドメイン名が解決されるIPアドレスを指定するには、このオプションを選択します。
      • 「ネットワーク」モニター・タイプの場合:
        1. ベースURL: モニターを実行するサーバーを指定します。
           サーバーのIPアドレスまたは完全修飾ドメイン名(FQDN)は、受け入れられる値です。例:

           • 192.168.1.1
           • example.com
           ノート
           
           TCPプロトコルを使用する場合は、ポート番号も指定する必要があります。例:

           • 192.168.1.1:8080
           • example.com:80
        2. プロトコル: モニターが使用するネットワーク・プロトコルを指定します。TCPまたはICMPです。

           TCPが選択されている場合、ポート番号は「ベースURL」パラメータに必須です。

           ICMPが選択されている場合、ポート番号は必要ありません。

        3. プローブ・モード: TCPネットワーク・プロトコルのプローブ・モードを指定します。SACKまたはSYNのいずれかです。「プローブ・モード」は、TCPネットワーク・プロトコルでのみ使用できます。
        4. IPV6の有効化: 選択されている場合は、ドメイン名または[IPv6]:portの形式のいずれかのターゲットを指定します。例: フォーマット: [2001:db8:3333:4444:5555:6666:7777:8888]:90またはoracle.com:90。
      • 「DNS」モニター・タイプの場合:
        1. 構成タイプ: DNSモニターの構成タイプを選択します:
           • DNSサーバー: ターゲット・サーバーに対して問合せを実行します。有効になっている場合、ターゲットの解決時間と可用性をネットワーク・メトリックとともに測定します。
           • DNSトレース: 親ゾーンから子ゾーンの認可サーバーに正しく委任されたDNSリクエストを検証します。
           • DNSSEC: ドメイン・ネーム・システム・セキュリティ拡張に従って、DNSレコードの信頼性を検証します。DNSSecトラスト・ツリーおよびデータ・チェーンのビューを提供します。
        2. ドメイン: モニターで使用されるドメイン名またはIPアドレスを指定します。
        3. レコード・タイプ: 使用可能なドロップダウン・リストを使用して、モニターで使用されるDNSレコード・タイプを指定します。
        4. 再帰問合せの送信: DNS問合せを再帰モードで送信する場合は、チェック・ボックスを選択します。このオプションは、「DNSサーバー」モニター構成タイプが選択されている場合にのみ使用できます。
        5. トランスポート・プロトコル: ドロップダウン・リストを使用してネットワーク・プロトコルを指定します。TCPまたはUDPです。

           このオプションは、「DNSサーバー」または「DNSトレース」モニター構成タイプが選択されている場合に使用できます。

        6. DNSサーバー: ドメイン・フィールドでドメイン名について問い合せるDNSネーム・サーバーのドメイン名またはIPアドレスを指定します。

           このオプションは、「DNSサーバー」モニター構成タイプが選択されている場合にのみ使用できます。

        7. IPV6の有効化: チェックした場合、DNSサーバーのIPv6アドレスまたはドメイン名を指定します。「レコード・タイプ」がPTRの場合、「ドメイン」は次の形式を使用する必要があります: 0.f.e.d.c.b.a.9.8.7.6.5.4.3.2.1.0.f.e.d.c.b.a.9.8.7.6.5.4.3.2.1.ip6.arpa。IPv6 PTRレコードは、.ip6.arpaドメインに格納されます。
      • 「SQL」モニター・タイプの場合:
        1. データベース・タイプ: データベース・タイプを選択します現在サポートされているOracleおよびMySQL。
        2. ユーザー名: データベース認証用のユーザー名を指定します。(必須)。
        3. パスワード・タイプ: データベース認証のタイプを指定します。次に、2つのサポートされる形式を示します。
           • シークレットOCID: OCIボールト・シークレットOCID。詳細は、リソース・プリンシパルでのVaultシークレットの使用を参照してください。
           • テキスト: プレーン・テキスト形式のパスワード。
        4. パスワード: データベース認証用のパスワード/シークレットocid。(必須)。詳細は、リソース・プリンシパルでのVaultシークレットの使用を参照してください。
        5. データベース・ロール: データベース・ロールを指定します。(オプション)。

           OracleデータベースおよびSYSデータベース・ユーザーの場合、データベース・ロールSYSDBAまたはSYSOPERを指定する必要があります。

           最小限の権限を持つデータベース・ユーザーでモニターを作成することをお薦めします。

        6. データベース接続タイプ: データベースの接続タイプを指定します。次の2つのタイプがサポートされています。
           • カスタムJDBC: このタイプには、カスタムJDBC URLが必要です。
           • Cloud Wallet: このオプションは、Oracleデータベースを選択する場合にのみ使用できます。
             1. データベース・ウォレット: データベース・クラウド・ウォレット構成zipファイルを指定します。(必須)。
             2. サービス名: 接続の確立に使用するデータベース・サービス名を指定します。(必須)。
        7. SQL問合せ: データベースからデータをフェッチするSQL問合せを指定します。SELECT文のみが許可されます。(必須)。
      • 「FTP」モニター・タイプの場合:
        1. プロトコル・タイプ: ターゲットFTPサーバーでサポートされるプロトコル(必須)。

           サポートされるタイプは、FTP、FTPS、SFTPです。

        2. リクエスト・タイプ: FTPによって実行されるリクエスト。(必須)。

           次のタイプがサポートされています: ダウンロード、アップロードおよびリスト。

        3. パス: ファイルまたはディレクトリへの絶対パス。

           「ダウンロード」要求タイプが選択されている場合のみ必須です。

           「アップロードおよびリスト」要求タイプが選択されている場合はオプションです。アップロードおよびリストにパスが指定されていない場合は、認証で指定されたFTPユーザーのホーム・ディレクトリがデフォルト・パスとして使用されます。

        4. ファイル・サイズ: 「ダウンロード」および「アップロード」要求タイプのファイル・サイズの上限。

           アップロード要求タイプにのみ必須です。

        5. コンテンツの検証:リスト・リクエスト・タイプでのみ使用できます。(オプション)。

           ユーザーは正規表現を指定して特定のファイルをリストできます。

        6. アクティブ・モード: FTPおよびFTPSプロトコルでのみサポートされます。(オプション)。

           データ転送のモードを制御し、FTPクライアントライブラリによって内部的に処理されます。有効にすると、クライアントはコマンドチャネルを確立し、サーバーはデータチャネルを確立します。

        7. 認証: (必須)
           • ユーザー名: FTP認証のユーザー名。
           • パスワード・タイプ:認証のタイプ。(オプション)。

             次の型がサポートされています。

             1. シークレットOCID: OCIボールト・シークレットOCID。詳細は、リソース・プリンシパルでのVaultシークレットの使用を参照してください。
             2. テキスト: プレーン・テキスト形式のパスワード。
           • パスワード: 認証用のパスワードまたはシークレットocid。詳細は、リソース・プリンシパルでのVaultシークレットの使用を参照してください。

   「次へ」をクリックします。

6. 「実行設定」ページで:
   1. バンテージ・ポイント: モニターを実行するバンテージ・ポイントを選択します。専用のバンテージ・ポイントを設定した場合は、ドロップダウン・リストにもリストされ、選択できます。専用バンテージ・ポイントの詳細は、専用バンテージ・ポイントの使用を参照してください。
   2. 次のいずれかのラジオボタンを選択して、モニター実行の頻度を決定します。
      • 間隔: このラジオ・ボタンを選択して、各モニター実行間の間隔を決定します。
      • 1回実行: モニターを1回のみ実行する場合は、このラジオ・ボタンを選択します。「1回実行」ラジオ・ボタンが選択されている場合、「スケジューリング・ポリシー」ドロップダウン・リストおよび「実行間の間隔(分)」フィールドは無効になります。
   3. スケジューリング・ポリシー: 選択したバンテージ・ポイントでモニター実行を安定させるには、次のいずれかのオプションを選択します。
      • すべて: このオプションを選択すると、選択したすべてのバンテージ・ポイントでモニターが同時に実行されます。
      • ラウンド・ロビン: 各バンテージ・ポイントでモニター実行を順次スケジュールするには、このオプションを選択します。この機能は、「実行間の間隔(分)」フィールドに指定された値と連携して機能します。たとえば、「実行間の間隔(分)」フィールドに10分が指定され、モニターが5つのバンテージ・ポイントで実行される場合、モニターは各実行の間の10分間隔でバンテージ・ポイントで順番に実行されます。すべてのバンテージ・ポイントでのモニター実行の合計期間は50分になり、その後、順次モニター実行が再度開始されます。
      • バッチ・ラウンド・ロビン: バンテージ・ポイントのバッチでモニター実行を順次スケジュールするには、このオプションを選択します。この機能は、「実行間のインターバル(分)」および「実行間のサブインターバル(分)」フィールドに指定された値と連携して機能します。このシナリオでは、モニターはバンテージ・ポイントのバッチで実行するようにスケジュールされており、各実行間の間隔は「実行間のサブ間隔(分)」フィールドに指定されています。「実行間の間隔(分)」フィールドの値は、すべてのバッチでモニター実行に要した合計時間を示します。

        各バッチのバンテージ・ポイントの数は、選択したバンテージ・ポイントの数と、「実行間の間隔(分)」および「実行間のサブ間隔(分)」フィールドに指定された値に基づいて自動的に計算されます。たとえば、バンテージ・ポイントが7、実行間の間隔(分) = 10分および実行間のサブ間隔(分) = 5分の場合、2つのバッチが作成されます。バンテージ・ポイントの最初のバッチには4つのバンテージ・ポイントがあり、2番目のバッチには3つのバンテージ・ポイントがあります。

        
        
        
        
        
   4. 実行間の間隔(分): モニター実行間の分数を指定します。デフォルトのインターバル期間は10分です。RESTモニター・タイプでは、1分をモニター実行間の間隔の最小期間として指定でき、他のモニター・タイプでは、最小期間として5分を指定できます。

      「スケジューリング・ポリシー」ドロップダウン・リストで「照合ラウンド・ロビン」オプションが選択されている場合、「実行間の間隔(分)」フィールドで選択した値は、すべてのバッチでモニター実行に要した合計時間を示します。

   5. 実行間のサブ間隔(分): バンテージ・ポイントのバッチでのモニター実行の分数を指定します。このフィールドは、「スケジューリング・ポリシー」ドロップダウン・リストで「バッチ・ラウンド・ロビン」オプションが選択されている場合にのみ表示されます。
   6. タイムアウト(分): タイムアウト値を指定します。これは許容される最大実行時間を示し、この時間内にモニター実行時間が完了しない場合は停止され、失敗としてマークされます。「実行間の間隔」の値は、「タイムアウト(分)」値の約3倍にする必要がありますが、「再試行の有効化」チェック・ボックスが選択されていない場合は、「タイムアウト(分)」値を「実行間の間隔」値の50%に設定できます。
   7. 再試行の有効化: 失敗した場合に実行を再試行するには、このチェック・ボックスを選択します。このチェック・ボックスはデフォルトでは選択されています。
   8. ネットワーク収集の有効化: このチェック・ボックスを選択すると、ネットワークからのデータ収集が有効になり、ネットワーク・パフォーマンスが監視されます。「スクリプト化されたREST」モニターの場合、このチェック・ボックスが表示されるのは、「ベースURL」が「定義のモニター」ページで指定されている場合のみです。

      「ネットワーク・コレクションの有効化」チェック・ボックスを選択すると、次のオプションが表示されます。

      • プロトコル: ネットワーク・プロトコルを選択します。
      • Probe Mode: Select a probe mode for the TCP network protocol. Note that the Probe Mode option is only available for the TCP network protocol.
      • Probe Per Hop: Specify the number of probe packets sent per hop.

   「次へ」をクリックします。

7. 「可用性構成(オプション)」ページで、「可用性構成の有効化」チェック・ボックスを選択して、モニターの可用性を計算するための基準を構成し、Oracle定義の「モニター」ダッシュボードの「可用性」ウィジェットで対応する詳細を表示できます。

   「可用性構成の有効化」チェック・ボックスを選択すると、次のオプションが表示されます:

   • 間隔当たりの許容最大失敗数: 1つの間隔で許容される失敗したモニター実行の最大数を指定します。指定した数の失敗したモニター実行を超える間隔は、UNAVAILABLEに分類されます。
   • 間隔ごとに許可される最小実行数: 間隔内で許可されるモニター実行の最小数を指定します。指定した数のモニター実行未満の間隔はUNKNOWNに分類され、可用性の計算から除外されます。

   「次へ」をクリックします。

   「モニター」ダッシュボードでモニターの可用性を表示する方法の詳細は、モニターの可用性の表示を参照してください。

8. 「タグ(オプション)」ページで、タグ付けメタデータ・システムを使用してモニターを編成およびトラッキングするように選択し、「次へ」をクリックします。
   「タグ・ネームスペース」ドロップダウン・リストで、apm-syntheticsという接頭辞が付いたネームスペースを選択し、最大5つのタグ・キーおよびタグ値を追加できます。これらのキーと値のペアは、ディメンションとして追加され、可用性モニタリング・メトリック(oracle_apm_syntheticsネームスペース)の追加修飾子として使用できます。これにより、モニターの他の側面を監視し、APM固有のタグを使用してモニターを編成および追跡できます。

   ノート
   
   タグ・キー名を既存のディメンションと同じにすることはできません。任意のタグ・ネームスペースを作成できますが、ディメンションとしてOracle Cloud Infrastructure Monitoringサービスにピックアップおよび公開されるのは、apm-synthetics接頭辞を持つネームスペースのみです。

   詳細情報:

   • 可用性モニタリングのディメンションおよびメトリック。使用可能なメトリック: oracle_apm_syntheticsを参照してください。
   • タグ付け。タグ付けの概要を参照してください。
9. 「サマリー」ページで、モニターのサマリーを確認します。
   モニター・タイプがRESTの場合は、「JSの表示」をクリックして、前のステップで指定した入力に基づいてJavascriptを表示できます。

   前のステップで指定した入力に基づいて、生成されたJavascriptを含むウィンドウが表示されます。右上隅には、「コピー」、「ダウンロード」または「スクリプトの作成」のオプションがあります。

   「スクリプトの作成」を選択すると、「スクリプトの作成」ページが表示され、Javascriptスクリプトが作成されます。作成したスクリプトを使用して、後でSCRIPTED RESTモニターを作成できます。

   「スクリプトの作成」ページで、スクリプト名を入力し、ステップに従って完了したら、「作成」をクリックしてJavascriptスクリプトを作成します。スクリプトの作成の詳細は、スクリプトの作成を参照してください。

10. 「作成」をクリックして、モニターを作成します。