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

Google Cloud コンソール

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

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

   [稼働時間チェック] に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。

2. [稼働時間チェックの作成] をクリックします。
3. [タイトル] にタイトルを入力し、[次へ] をクリックします。
4. ターゲットを入力し、[次へ] をクリックします。

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

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

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

Cloud Monitoring API

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

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

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

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

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

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

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

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

Google Cloud コンソール

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

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

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

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

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 conten] フィールドに正規表現を入力します。
3. 構成を確認するには、[Test] をクリックします。

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

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

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. [レスポンス コンテンツ] フィールドに数値または文字列リテラルを入力します。
4. 構成を確認するには、[Test] をクリックします。

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

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

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. 構成を確認するには、[Test] をクリックします。

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

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

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"
    }
],
...