レスポンス データを検証する

Google Cloud コンソール

レスポンス データを検証する稼働時間チェックを作成するには、次の操作を行います。

1. Google Cloud コンソールで、[ 稼働時間チェック] ページに移動します。

   稼働時間チェックに移動する

   このページを検索バーで検索する場合は、小見出しが「Monitoring」の結果を選択します。

2. Google Cloud コンソールのツールバーで、 Google Cloud プロジェクトを選択します。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトを選択します。
3. [稼働時間チェックの作成] をクリックします。
4. [タイトル] にタイトルを入力し、[次へ] をクリックします。
5. ターゲットを入力して、[次へ] をクリックします。

6. [レスポンスの検証] を構成します。

   • レスポンス データを検証するには、[コンテンツ マッチが有効] になっていることを確認し、レスポンスの検証に関連するフィールドを入力します。これらのオプションの詳細については、このドキュメントの次のセクションをご覧ください。
   • HTTP 稼働時間チェックの場合は、許容されるレスポンス コードを構成します。デフォルトでは、HTTP 稼働時間チェックで 2xx レスポンスはすべて正常なレスポンスと見なされます。

7. [次へ] をクリックし、稼働時間チェックの構成を完了します。

Cloud Monitoring API

レスポンス データを検証するように稼働時間チェックを構成するには、UptimeCheckConfig オブジェクトの contentMatchers 配列にデータを入力します。

ContentMatcher オブジェクトには次のフィールドがあります。

• matcher: 比較方法を記述します。値の一覧については、ContentMatcherOption をご覧ください。

  CONTENT_MATCHER_OPTION_UNSPECIFIED 値は使用しないでください。

• content: 検索する値をレスポンス データに格納します。値は文字列リテラルまたは正規表現です。

• jsonPathMatcher: 検索する JSONpath と、比較方法を表す JsonPathMatcher オブジェクトを保存します。

  稼働時間チェックが特定の JSONpath を検証する場合を除き、このフィールドは省略します。

このドキュメントの残りの部分では、コンテンツ マッチタイプの使用方法について説明します。

Google Cloud コンソール

稼働時間チェックを構成してレスポンス データにリテラル部分文字列が含まれる場合に成功となるようにするには、次の設定を使用します。

1. [Response Content match type] メニューで、[次を含む] を選択します。
2. [Response content] フィールドにリテラル部分文字列を入力します。
3. 構成を確認するには、[テスト] をクリックします。

レスポンス データにリテラル部分文字列が含まれている場合に稼働時間チェックが失敗となるように構成するには、次の設定を使用します。

1. [Response Content match type] メニューで、[次を含まない] を選択します。
2. [Response content] フィールドにリテラル部分文字列を入力します。
3. 構成を確認するには、[テスト] をクリックします。

Cloud Monitoring API

稼働時間チェックを構成してレスポンス データにリテラル部分文字列が含まれる場合に成功となるようにするには、次の値を使用します。

...
"contentMatchers": [
    {
      "content": "Set to the string to be matched.",
      "matcher": "CONTAINS_STRING"
    }
],
...

稼働時間チェックを構成してレスポンス データにリテラル部分文字列が含まれる場合に失敗となるようにするには、次の値を使用します。

...
"contentMatchers": [
    {
      "content": "Set to the string to be matched.",
      "matcher": "NOT_CONTAINS_STRING"
    }
],
...

Google Cloud コンソール

レスポンス データが正規表現に一致する場合に成功となる稼働時間チェックを構成するには、次の設定を使用します。

1. [Response Content match type] メニューで、[Matches regex] を選択します。
2. [Response content] フィールドに正規表現を入力します。
3. 構成を確認するには、[テスト] をクリックします。

レスポンス データが正規表現と一致する場合に稼働時間チェックが失敗となるように構成するには、次の設定を使用します。

1. [Response Content match type] メニューで、[Does not match regex] を選択します。
2. [Response content] フィールドに正規表現を入力します。
3. 構成を確認するには、[テスト] をクリックします。

Cloud Monitoring API

レスポンス データが正規表現に一致するときに成功となるように稼働時間チェックを構成するには、次の値を使用します。

...
"contentMatchers": [
    {
      "content": "Set to the regular expression to be matched.",
      "matcher": "MATCHES_REGEX"
    }
],
...

レスポンス データが正規表現と一致する場合に稼働時間チェックが失敗となるように構成するには、次の値を使用します。

...
"contentMatchers": [
    {
      "content": "Set to the regular expression to be matched.",
      "matcher": "NOT_MATCHES_REGEX"
    }
],
...

Google Cloud コンソール

稼働時間チェックを構成して、レスポンス データの特定の JSONpath が文字列リテラルと一致した場合に成功となるようにするには、次の設定を使用します。

1. [Response content match type] メニューで、[Matches at JSONPath] を選択します。
2. [JSONPath] フィールドにパスを入力します。
3. [Response content] フィールドに数値または文字列リテラルを入力します。
4. 構成を確認するには、[テスト] をクリックします。

稼働時間チェックを構成して、レスポンス データの特定の JSONpath が文字列リテラルと一致した場合に失敗となるようにするには、次の設定を使用します。

1. [Response content match type] メニューで、[Does not match at JSONPath] を選択します。
2. [JSONPath] フィールドにパスを入力します。
3. [Response content] フィールドに数値または文字列リテラルを入力します。
4. 構成を確認するには、[テスト] をクリックします。

Cloud Monitoring API

JSON 形式のレスポンスの特定のフィールドが、数値または文字列リテラルと一致する場合に成功となるように稼働時間チェックを構成するには、ContentMatcher オブジェクトに対して次の値を使用します。

...
"contentMatchers": [
    {
       "content" : "Set to a number, a boolean, or the string to be matched.",
       "matcher" : "MATCHES_JSON_PATH",
       "jsonPathMatcher" : {
           "jsonPath" : "Set to the JSONpath.",
           "jsonMatcher" : "EXACT_MATCH"
    }
],
...

JSON 形式のレスポンスの特定のフィールドが数値または文字列リテラルと一致した場合に稼働時間チェックが失敗となるように構成するには、ContentMatcher オブジェクトに対して次の値を使用します。

...
"contentMatchers": [
    {
       "content" : "Set to a number, a boolean, or the string to be matched.",
       "matcher" : "NOT_MATCHES_JSON_PATH",
       "jsonPathMatcher" : {
           "jsonPath" : "Set to the JSONpath.",
           "jsonMatcher" : "EXACT_MATCH"
    }
],
...

Google Cloud コンソール

稼働時間チェックを構成して、レスポンス データの特定の JSONpath が正規表現と一致した場合に成功となるようにするには、次の設定を使用します。

1. [Response content match type] メニューで、[Matches at JSONPath] を選択します。
2. [JSONPath] フィールドにパスを入力します。
3. [Response conten] フィールドに正規表現を入力します。
4. 構成を確認するには、[テスト] をクリックします。

稼働時間チェックを構成して、レスポンス データの特定の JSONpath が正規表現と一致した場合に失敗となるようにするには、次の設定を使用します。

1. [Response content match type] メニューで、[Does not match at JSONPath] を選択します。
2. [JSONPath] フィールドにパスを入力します。
3. [Response conten] フィールドに正規表現を入力します。
4. 構成を確認するには、[テスト] をクリックします。

Cloud Monitoring API

稼働時間チェックを構成して、JSON 形式のレスポンスの特定のフィールドが正規表現と一致した場合に成功となるようにするには、ContentMatcher オブジェクトに次の値を使用します。

...
"contentMatchers": [
    {
       "content" : "Set to the regular expression to be matched."
       "matcher" : "MATCHES_JSON_PATH",
       "jsonPathMatcher" : {
           "jsonPath" : "Set to the JSONpath.",
           "jsonMatcher" : "REGEX_MATCH"
    }
],
...

稼働時間チェックを構成して、JSON 形式のレスポンスの特定のフィールドが正規表現と一致した場合に失敗となるようにするには、ContentMatcher オブジェクトに次の値を使用します。

...
"contentMatchers": [
    {
       "content" : "Set to the regular expression to be matched.",
       "matcher" : "NOT_MATCHES_JSON_PATH",
       "jsonPathMatcher" : {
           "jsonPath" : "Set to the JSONpath.",
           "jsonMatcher" : "REGEX_MATCH"
    }
],
...