合成モニターを管理する

コンソール

Google Cloud プロジェクトの合成モニターを一覧表示する手順は次のとおりです。

1. Google Cloud コンソールで、[ 合成モニタリング] ページに移動します。

   [合成モニタリング] に移動

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

2. Google Cloud コンソールのツールバーで、 Google Cloud プロジェクトを選択します。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトを選択します。

3. 省略可: 一覧表示される合成モニターを制限するには、フィルタを追加します。

   各フィルタは、名前と値で構成されています。値は、合成モニタリングの名前に完全に一致するように設定することも、部分一致するように設定することもできます。一致結果では大文字と小文字は区別されません。たとえば、名前に default を含むすべての合成モニターを一覧表示するには、次の操作を行います。

   • [表をフィルタリング] をクリックし、[表示名] を選択します。
   • default と入力して、Return キーを押します。

   複数のフィルタがある場合、OR フィルタを挿入しない限り、論理 AND によって自動的に結合されます。上記の例では、OR フィルタを使用して、名前が default または Testing check と一致した場合に、稼働時間チェックが表示されるようにしています。

[合成モニター] ページには、合成モニターごとに次の情報が表示されます。

• 最新の実行のステータス。
• その合成モニターに関する詳細情報へのリンク。
• 成功率と平均実行時間。
• アラート ポリシーの数。
• 合成モニターを編集、コピー、削除したり、アラート ポリシーを作成したりするには、more_vert（その他のオプション）メニューを使用します。

gcloud

稼働時間チェックと合成モニターを一覧表示するには、gcloud monitoring uptime list-configs コマンドを実行します。

gcloud monitoring uptime list-configs --project=PROJECT_ID

前述のコマンドを実行する前に、次のように置き換えます。

• PROJECT_ID: プロジェクトの ID。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトを選択します。

返されるデータには次の情報が含まれます。

• 名前と表示名。
• チェック ID。
• モニタリング対象リソース。
• チェックの間隔。

結果にフィルタを適用して並べ替えるよう Google Cloud CLI コマンドを構成できます。

REST

稼働時間チェックなど、 Google Cloud プロジェクト内の合成モニターを一覧表示するには、projects.uptimeCheckConfigs.list メソッドを呼び出します。

1. projects.uptimeCheckConfigs.list をクリックします。

2. API Explorer を使用します。

   メソッドの親 をプロジェクトの名前に設定します。必ず次の形式を使用してください。

   projects/PROJECT_ID
   

   前の式で、PROJECT_ID は Google Cloud プロジェクト ID です。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトを選択します。

合成モニターの場合、結果には syntheticMonitor というラベルの付いたフィールドが含まれています。

コンソール

Google Cloud プロジェクトの合成モニターの詳細を表示する手順は次のとおりです。

1. Google Cloud コンソールで、[ 合成モニタリング] ページに移動します。

   [合成モニタリング] に移動

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

2. Google Cloud コンソールのツールバーで、 Google Cloud プロジェクトを選択します。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトを選択します。

3. [合成モニターの詳細] ページを開くには、表示する合成モニターを見つけて、その名前をクリックします。

   Cloud Run functions の関数が提供する [関数の詳細] ページから Cloud Run functions の関数を表示するには、[コード] タブを選択してから、関数の名前をクリックします。[関数の詳細] ページが新しいウィンドウで開きます。このページのタブでは、指標、ログ、構成情報を表示できます。

gcloud

稼働時間チェックまたは合成モニターの詳細を一覧表示するには、gcloud monitoring uptime describe コマンドを実行します。

gcloud monitoring uptime describe CHECK_ID --project=PROJECT_ID

前述のコマンドを実行する前に、次のように置き換えます。

• PROJECT_ID: プロジェクトの ID。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトを選択します。
• CHECK_ID: 稼働時間チェックまたは合成モニターの ID。ID を確認するには、gcloud monitoring uptime list-configs コマンドを実行して name フィールドを確認します。詳細については、合成モニターの固有識別子を確認するをご覧ください。

稼働時間チェックで返されるデータには、次の情報が含まれます。

• 名前と表示名。
• チェック ID。
• モニタリング対象リソース。
• チェックの間隔。

REST

Google Cloud プロジェクト内の特定の合成モニターの詳細を一覧表示するには、projects.uptimeCheckConfigs.get メソッドを呼び出します。

1. projects.uptimeCheckConfigs.get をクリックします。

2. API Explorer を使用します。

   メソッドの親 を合成モニターの ID に設定します。次の形式を使用してください。

   projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
   

   上の式で:

   • PROJECT_ID は Google Cloud のプロジェクト ID です。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトを選択します。
   • CHECK_ID は、合成モニターの ID です。

   たとえば、親フィールドの値は次のようになります。

   projects/my-project/uptimeCheckConfigs/10863117100295372627
   

   projects.uptimeCheckConfigs.list メソッドを発行すると、CHECK_ID の値を確認できます。返される結果の数を減らすには、フィルタを設定します。たとえば、フィルタ displayName="MySyntheticMonitor" を追加します。

コンソール

[合成モニターの詳細] ページを使用して、合成モニターまたはその Cloud Run functions の関数を編集するには、次の操作を行います。

1. Google Cloud コンソールで、[ 合成モニタリング] ページに移動します。

   [合成モニタリング] に移動

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

2. Google Cloud コンソールのツールバーで、 Google Cloud プロジェクトを選択します。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトを選択します。
3. 編集する合成モニターを見つけて、more_vert（その他のオプション）をクリックし、[編集] を選択します。

4. 省略可: Cloud Run functions の関数を編集するには、[関数を編集] をクリックして変更を加え、[関数を適用] をクリックします。

   無効なリンク チェッカーの場合、元の URI またはテストするリンクを定義するオプションを変更するには、Cloud Run functions の関数を編集し、index.js ファイルの options オブジェクトを更新します。このオブジェクトのフィールドと構文については、broken-links-ok/index.js をご覧ください。

5. 変更を維持するには、[保存] をクリックします。それ以外の場合は、[キャンセル] をクリックします。

gcloud

稼働時間チェックまたは合成モニターを変更するには、gcloud monitoring uptime update コマンドを実行します。

gcloud monitoring uptime update CHECK_ID OPTIONAL_FLAGS --project=PROJECT_ID

前述のコマンドを実行する前に、次のように置き換えます。

• PROJECT_ID: プロジェクトの ID。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトを選択します。

• CHECK_ID: 稼働時間チェックまたは合成モニターの ID。ID を確認するには、gcloud monitoring uptime list-configs コマンドを実行して name フィールドを確認します。詳細については、稼働時間チェックの固有識別子を確認するをご覧ください。

• 変更するフィールドを定義します。合成モニターの場合、更新できるフィールドは次のとおりです。

  • 期間
  • 表示名
  • タイムアウト
  • ユーザーラベル

たとえば、合成モニターの期間を 10 分に設定するには、次のコマンドを実行します。

gcloud monitoring uptime update CHECK_ID --period=10 --project=PROJECT_ID

REST

アラート ポリシーと関数は合成モニターに含まれていないため、このセクションで説明する手順で編集することはできません。

• アラート ポリシーを変更するには、 Google Cloud コンソールを使用するか、alertPolicies.patch メソッドを呼び出します。詳細については、API によるアラート ポリシーの管理をご覧ください。

• Cloud Run functions の関数を変更するには、関数ソースを更新した後に関数を再デプロイする必要があります。詳細については、Cloud Run functions の関数をデプロイするをご覧ください。

合成モニターを編集するには、projects.uptimeCheckConfigs.patch メソッドを呼び出します。

1. projects.uptimeCheckConfigs.patch をクリックします。

2. API Explorer を使用します。

   1. メソッドの親 を合成モニターの ID に設定します。ID は次の形式になります。

      projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
      

      上の式で:

      • PROJECT_ID はプロジェクト ID です。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトを選択します。
      • CHECK_ID は、合成モニターの ID です。

      projects.uptimeCheckConfigs.list メソッドを発行すると、CHECK_ID の値を確認できます。返される結果の数を減らすには、フィルタを設定します。たとえば、フィルタ displayName="MySyntheticMonitor" を追加します。

   2. メソッドのクエリ パラメータ updateMask を設定して、オブジェクト内の変更するフィールドを特定します。たとえば、displayName の値を更新する場合、クエリ パラメータは次のようになります。

      updateMask=displayName
      

コンソール

Google Cloud プロジェクトの合成モニターをコピーする手順は次のとおりです。

1. Google Cloud コンソールで、[ 合成モニタリング] ページに移動します。

   [合成モニタリング] に移動

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

2. Google Cloud コンソールのツールバーで、 Google Cloud プロジェクトを選択します。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトを選択します。

3. 編集する合成モニターを見つけて、more_vert（その他のオプション）をクリックし、[コピー] を選択します。

   [合成チェックのコピー] ダイアログが開きます。ダイアログには、Cloud Run functions の関数のコピーなどのフィールドが事前入力されています。

4. [関数を作成] をクリックし、必要に応じて関数を更新して、[関数を適用] をクリックします。

5. 変更を維持するには、[作成] をクリックします。それ以外の場合は、[キャンセル] をクリックします。

   [作成] をクリックすると、Cloud Run functions の関数が作成されてデプロイされ、合成モニターが作成されます。

gcloud

合成モニターをコピーできる Google Cloud CLI メソッドはありません。

REST

合成モニターをコピーできる API メソッドはありません。ただし、次の手順でコピーを作成できます。

1. projects.uptimeCheckConfigs.get メソッドを呼び出してレスポンスを保存します。詳細については、合成モニターの詳細を表示するをご覧ください。
2. レスポンスを編集します。
3. projects.uptimeCheckConfigs.create メソッドを呼び出し、編集したレスポンスをメソッドに渡します。

コンソール

合成モニターと、関連するアラート ポリシーを削除する手順は次のとおりです。

1. Google Cloud コンソールで、[ 合成モニタリング] ページに移動します。

   [合成モニタリング] に移動

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

2. Google Cloud コンソールのツールバーで、 Google Cloud プロジェクトを選択します。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトを選択します。

3. 削除する合成モニターを見つけて、名前をクリックします。

4. 省略可: Cloud Run functions の関数を削除するには、[コード] タブを選択して、関数の名前をクリックします。[関数の詳細] ページが新しいウィンドウで開きます。

5. [合成モニターの詳細] ページをクリックし、[delete削除] をクリックして、ダイアログを完了します。

   これで、合成モニターが削除されました。

6. Cloud Run functions の関数を削除するには、[関数の詳細] ページに移動し、delete [削除] をクリックして、ダイアログを完了します。

gcloud

稼働時間チェックまたは合成モニターを削除するには、gcloud monitoring uptime delete コマンドを実行します。

gcloud monitoring uptime delete CHECK_ID  --project=PROJECT_ID

前述のコマンドを実行する前に、次のように置き換えます。

• PROJECT_ID: プロジェクトの ID。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトを選択します。
• CHECK_ID: 稼働時間チェックまたは合成モニターの ID。ID を確認するには、gcloud monitoring uptime list-configs コマンドを実行して name フィールドを確認します。詳細については、合成モニターの固有識別子を確認するをご覧ください。

REST

合成モニターとそれに関連するアラート ポリシーを削除するには、projects.uptimeCheckConfigs.delete メソッドを呼び出します。

1. projects.uptimeCheckConfigs.delete をクリックします。

2. API Explorer を使用します。

   メソッドの親 を合成モニターの ID に設定します。次の形式を使用してください。

   projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
   

   上の式で:

   • PROJECT_ID はプロジェクト ID です。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトを選択します。
   • CHECK_ID は、合成モニターの ID です。

   projects.uptimeCheckConfigs.list メソッドを発行すると、CHECK_ID の値を確認できます。返される結果の数を減らすには、フィルタを設定します。たとえば、フィルタ displayName="MySyntheticMonitor" を追加します。