非公開稼働時間チェックを作成する

このドキュメントでは、非公開稼働時間チェックを構成する方法について説明します。非公開の稼働時間チェックを使用すると、Identity and Access Management（IAM）の制限と VPC Service Controls の境界を適用しながら、お客様の Virtual Private Cloud（VPC）ネットワークへの HTTP リクエストまたは TCP リクエストを有効にできます。非公開稼働時間チェックでは、仮想マシン（VM）や L4 内部ロードバランサ（ILB）などのリソースにプライベートネットワーク経由でリクエストを送信できます。

プライベートネットワークにあるリソースの内部 IP アドレスは、プライベートネットワークアクセスが有効になっている Service Directory サービスとして記録されます。プライベート稼働時間チェックを使用するには、Service Directory プロダクトを使用してプライベートネットワークアクセスを構成する必要があります。

非公開稼働時間チェックを格納する Google Cloud プロジェクトと、Service Directory サービスを格納する Google Cloud プロジェクトは、異なるプロジェクトでも構いません。Cloud Monitoring を使用すると、指標スコープで 1 つのプロジェクトから複数の Google Cloud プロジェクトのリソースをモニタリングできます。稼働時間チェックが定義されているプロジェクトは、指標スコープのスコーピングプロジェクトになります。指標スコープは、スコーピングプロジェクトでモニタリングするすべてのプロジェクトのリストです。Service Directory サービスは、スコーピングプロジェクト、または指標スコープのプロジェクトで定義できます。指標スコープの詳細については、指標スコープの概要をご覧ください。

プライベートネットワークとそのリソース（VM やロードバランサなど）は、別の Google Cloud プロジェクトに存在する可能性もあります。このプロジェクトは、稼働時間チェックのスコーピングプロジェクトの指標スコープに存在する必要はありません。 Service Directory サービスは稼働時間の指標を収集するため、指標スコープ内に存在する必要がありますが、カプセル化されたリソースはそうではありません。

このドキュメントでは、Google Cloud コンソールまたは API を使用して、プライベートネットワークをセットアップし、その Service Directory リソースを構成する方法について説明します。ここでのAPIの例では、プライベートネットワークと Service Directory サービスが、稼働時間チェックのスコーピングプロジェクトに存在することを前提としています。ただし、非公開稼働時間チェックを作成するでは、API を使用して指標スコープで Service Directory サービスを使用する稼働時間チェックを作成する方法についても説明します。

公開 IP アドレスを使用する稼働時間チェックの構成方法については、公開稼働時間チェックを作成するをご覧ください。稼働時間チェックの管理とモニタリングに関する情報については、このドキュメントの次のステップのセクションをご覧ください。

始める前に

次の API を有効にします。
- Cloud Monitoring API: monitoring.googleapis.com
- Service Directory API: servicedirectory.googleapis.com
- Service Networking API: servicenetworking.googleapis.com
- Compute Engine API: compute.googleapis.com
API を有効にするには、gcloud CLI または Google Cloud コンソールを使用します。次のタブでは、gcloud CLI をインストールして Cloud Monitoring API を有効にする方法について説明します。
Google Cloud コンソール
1. Google Cloud コンソールで、API を有効にする Google Cloud プロジェクトを選択し、[API とサービス] ページに移動します。
  
  [API とサービス] に移動
2. [API とサービスを有効にする] ボタンをクリックします。
3. 「Monitoring」を検索します。
4. 検索結果で、[Stackdriver Monitoring API] をクリックします。
5. [API が有効です]が表示されている場合、その API はすでに有効になっています。有効になっていない場合は、[有効にする] をクリックします。
gcloud CLI
1. ワークステーションに Google Cloud CLI がまだインストールされていない場合は、gcloud CLI のインストールをご覧ください。
2. Monitoring API が有効になっているかどうかを確認するには、ワークステーションで、次のコマンドを実行します（PROJECT_ID は API を有効にするプロジェクトの ID に置き換えます）。
  gcloud services list --project=PROJECT_ID
  出力に monitoring.googleapis.com が表示されている場合、API は有効になっています。
3. API が有効になっていない場合は、次のコマンドを実行して有効にします。
  gcloud services enable monitoring --project=PROJECT_ID
  詳細については、gcloud services をご覧ください。
他の API を有効にする手順も同じです。
- Google Cloud コンソールを使用するには、表示名（「Service Directory API」など）を検索します。
- gcloud CLI を使用するには、googleapis.com 名の最初の要素（servicedirectory など）を指定します。
通知の受信に使用する通知チャンネルを構成します。複数の種類の通知チャンネルを作成することをおすすめします。詳しくは、通知チャンネルの作成と管理をご覧ください。
プライベートネットワークを構成し、そのプライベートネットワークにアクセスできるように VM または ILB を構成します。詳しくは、プライベートサービスアクセスをご覧ください。

ILB をターゲットとする非公開チェックは、稼働時間チェッカーがあるリージョンに限定されます。稼働時間チェックリージョン USA には、USA_OREGON、USA_IOWA、USA_VIRGINIA リージョンが含まれます。各 USA_* リージョンには 1 つのチェッカーがあり、USA には 3 つすべてが含まれます。その他の稼働時間チェックリージョン（EUROPE、SOUTH_AMERICA、ASIA_PACIFIC）には、それぞれチェッカーが 1 つあります。この制限を取り除くには、ロードバランサへのグローバルアクセスを構成する必要があります。グローバルアクセスを構成する方法については、このドキュメントの Service Directory リソースを構成するセクションの ILB タブをご覧ください。

グローバルアクセスを許可しない ILB を確認する場合は、ILB に次のいずれかのリージョンを選択します。
- us-east4
- us-central1
- us-west1
- europe-west1
- southamerica-east1
- asia-southeast1
使用するインターフェースを決定します。
- Google Cloud コンソール: VM がリクエストを処理しているときに稼働時間チェックを作成できます。このインターフェースでは、Service Directory リソースの構成、サービスアカウントの認可、ネットワークファイアウォールルールの構成の手順を確認できます。
- コマンドラインインターフェース: Google Cloud CLI と Cloud Monitoring API を使用して、ILB と VM がリクエストを処理するときに非公開稼働時間チェックを作成できます。
コマンドラインを使用して非公開稼働時間チェックを構成する場合は、前提条件の手順を完了します。

非公開稼働時間チェックを作成する

このセクションでは、Service Directory サービスのプライベート稼働時間チェックを作成して構成する方法について説明します。

Google Cloud コンソールを使用するには、[Google Cloud コンソール] タブを選択します。
Cloud Monitoring API を使用し、稼働時間チェックと同じ Google Cloud プロジェクトに Service Directory サービスを構成するには、[API: スコーピングプロジェクト] タブを選択します。
Cloud Monitoring API を使用し、稼働時間チェックのプロジェクトの指標スコープでモニタリングされるプロジェクトに Service Directory サービスを構成するには、[API: モニタリング対象プロジェクト] タブを選択します。

Google Cloud コンソール

Google Cloud コンソールを使用して稼働時間チェックを作成するには、次の操作を行います。

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

検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
[稼働時間チェックの作成] をクリックします。
非公開の稼働時間チェックを指定します。
1. プロトコルを選択します。プロトコルは HTTP、HTTPS、TCP のいずれかです。
2. [内部 IP] リソースタイプを選択します。
プロジェクトに Service Directory サービスが構成されていない場合、または Service Directory サービスを作成する場合は、表示および 非公開稼働時間チェックの前提条件ペインに入力します:
1. プロンプトが表示されたら、Compute Engine API または Service Directory API を有効にします。API の有効化には 1 分ほどかかることがあります。
2. 表示されている場合は、 [サービスアカウント] を開き、[サービスアカウントを作成] をクリックします。
  
  Monitoring サービスアカウントが存在しない場合、サービスアカウントが作成されます。次に、Monitoring はサービスアカウントに 2 つの Service Directory ロールを付与します。
3. [Service Directory] メニューを開き、次の操作を行います。
  1. [リージョン] を開き、リクエストを処理している VM のリージョンを選択します。
  2. [名前空間] を展開し、既存の Service Directory の名前空間を選択するか、[名前空間を作成] をクリックして名前空間を作成します。
  3. [サービス名] をクリックしてサービス名を入力します。サービスは、非公開稼働時間チェックのターゲットです。
  4. [エンドポイント名] をクリックし、エンドポイント名を入力します。エンドポイントは、サービスがリクエストを処理するために使用できる IP アドレスとポートの値のペアです。サービスに複数のエンドポイントがある場合は、1 つのエンドポイントがランダムに選択されます。
  5. [ネットワーク] を開き、プライベートネットワークを選択します。
  6. [インスタンス] を開き、リクエストを処理しているプライベートネットワーク上の VM を選択します。インスタンスを選択すると、その内部 IP アドレスが表示されます。
  7. [完了] をクリックします。
4. [ファイアウォールルール] を開きます。
  1. [ネットワーク] を開き、ネットワークルールが適用されているネットワークを選択します。
  2. [ファイアウォールルールを作成] をクリックします。
    
    このファイアウォールルールにより、ルート 35.199.192.0/19 からの受信 TCP トラフィックが有効になります。35.199.192.0/19 からのルートは、限定公開ルーティングを使用する転送先への接続をサポートします。詳細については、VPC ルートをご覧ください。
[非公開稼働時間チェック] ペインで、使用する Service Directory サービスを指定するには、次のいずれかを行います。
- [完全修飾サービス名を使用する] を選択し、サービスの完全修飾名を入力します。
```
projects/SERVICE_DIRECTORY_PROJECT_ID/locations/REGION/namespaces/PRIVATE_NAMESPACE/services/PRIVATE_SERVICE
```
- メニューを使用して、リージョン、Namespace、Service を選択します。サービスを作成した場合、これらのフィールドは自動的に選択されます。
[非公開稼働時間チェック] ペインで、稼働時間チェックのターゲットの説明を入力します。
1. 省略可: リクエストのパスコンポーネントを入力します。
  
  HTTP または HTTPS プロトコルを使用するプライベート稼働時間チェックは、http://target/path にリクエストを送信します。この表現の target は、Service Directory エンドポイントで構成された内部 IP アドレスです。
  
  パスフィールドを空白のままにするか、値を / に設定すると、リクエストは http://target/ に発行されます。
2. 省略可: 稼働時間チェックを実行する頻度を設定するには、[Check frequency] フィールドを使用します。
3. 省略可: チェッカーリージョンを構成するか、認証、HTTP および HTTPS チェックのヘッダー、その他の値を選択するには、[More target options] をクリックします。
  - リージョン: 稼働時間チェックがリクエストを受信するリージョンを選択します。稼働時間チェックには、少なくとも 3 つのチェッカーが必要です。3 つのチェッカーがある米国を除くすべてのリージョンには、1 つのチェッカーがあります。デフォルト設定の [グローバル] にはすべてのリージョンが含まれています。
  - リクエストメソッド: GET または POST を選択します。
  - 本文: HTTP POST チェックの場合、URL エンコードされた本文を入力します。エンコードは自分で行う必要があります。他のすべてのチェックでは、このフィールドは空のままにします。
  - ホストヘッダー: 非公開稼働時間チェックを構成する場合は、このフィールドを設定しないでください。
  - ポート: ここで設定した値は、Service Directory エンドポイント構成のポートを上書きします。エンドポイント構成を使用する場合は、ここで値を設定しないでください。
  - カスタムヘッダー: カスタムヘッダーを追加し、必要に応じて暗号化します。暗号化すると、ヘッダーの値はフォームに表示されません。認証に関連するヘッダーを他のユーザーに表示しないように暗号化を使用します。
  - [Authentication]: 単一のユーザー名とパスワードを指定します。これらの値は Authorization ヘッダーとして送信されます。ここで値を設定する場合、これとは別に Authorization ヘッダーを設定しないでください。Authorization ヘッダーを設定する場合は、ここに値を設定しないでください。フォームではパスワードは常に非表示です。
[続行] をクリックし、レスポンス要件を構成します。このセクションの設定にはすべてデフォルト値があります。
- 稼働時間チェックのタイムアウト期間を設定するには、[レスポンスのタイムアウト] フィールドを使用します。この期間内に複数のロケーションからレスポンスを受け取らなかった場合、稼働時間チェックは失敗となります。
- コンテンツマッチングを実行するように稼働時間チェックを構成するには、トグルラベルが [コンテンツマッチングが有効] になっていることを確認します。
  - オプションのメニューから [レスポンスのコンテンツのマッチタイプ] を選択します。このフィールドは、レスポンスのコンテンツと返されたデータをどのように比較するかを指定します。たとえば、レスポンスのコンテンツが abcd で、コンテンツのマッチタイプが [Contains] であるとします。稼働時間チェックが成功するのは、レスポンスデータに abcd が含まれている場合のみです。詳細については、レスポンスデータを検証するをご覧ください。
  - [レスポンスのコンテンツ] を入力します。レスポンスのコンテンツには 1024 バイト以下の文字列を指定する必要があります。API では、このフィールドでは ContentMatcher オブジェクトです。
- 稼働時間チェックが原因でログエントリが作成されないようにするには、[チェックの失敗をログに出力] をオフにします。
- HTTP 稼働時間チェックの場合は、許容されるレスポンスコードを構成します。デフォルトでは、HTTP 稼働時間チェックで 2xx レスポンスはすべて正常なレスポンスと見なします。
[続行] をクリックして、アラートポリシーと通知を構成します。

稼働時間チェックが失敗した場合に通知を受け取るには、アラートポリシーを作成して、そのポリシーの通知チャネルを構成します。
1. 省略可: アラートポリシーの名前を更新します。
2. 省略可: [Duration] フィールドで、稼働時間チェックの失敗の通知を送信するまでの時間を選択します。デフォルトでは、2 つ以上のリージョンが 1 分以上の稼働時間チェックの失敗を報告したときに通知が送信されます。
3. [通知チャネル] というラベルのボックスで、 [メニュー] を展開し、追加するチャネルを選択して、[OK] をクリックします。
  
  メニューでは、通知がチャネルタイプごとにアルファベット順にグループ化されます。
アラートポリシーを作成しない場合は、切り替えボタンのテキストが [アラートを作成しない] になっていることを確認します。
[続行] をクリックし、稼働時間チェックを完了します。
1. 稼働時間チェックのわかりやすいタイトルを入力します。
2. 省略可: 稼働時間チェックにユーザー定義のラベルを追加する手順は次のとおりです。
  1. [ユーザーラベルを表示] をクリックします。
  2. [Key] フィールドにラベルの名前を入力します。ラベル名の先頭は小文字にする必要があり、小文字、数字、アンダースコア、ダッシュを使用できます。たとえば、「severity」と入力します。
  3. [Value] フィールドにラベルの値を入力します。ラベルの値には、英小文字、数字、アンダースコア、ダッシュを使用できます。たとえば、「critical」と入力します。
  4. 追加するラベルごとに、[ユーザーラベルを追加します] をクリックして、ラベルのキーと値を入力します。
3. 稼働時間チェックの構成を確認するには、[TEST] をクリックします。結果が期待どおりでない場合は、トラブルシューティングを参照して構成を修正し、検証ステップを繰り返します。
4. [作成] をクリックします。

API: プロジェクトのスコーピング

非公開稼働時間チェックの構成を作成するには、UptimeCheckConfig オブジェクトを作成し、そのオブジェクトを Cloud Monitoring API で uptimeCheckConfigs.createメソッドに渡します。

非公開稼働時間チェックの UptimeCheckConfig オブジェクトは、次の点で公開稼働時間チェックのオブジェクトとは異なります。

稼働時間チェックの構成で指定するモニタリング対象リソースは、タイプ servicedirectory_service である必要があります。このリソースタイプには次のラベルがあります。
- project_id: Service Directory サービスに関連付けられているプロジェクト ID。
- location: サービスに関連付けられたクラウドリージョン。
- namespace_name: Service Directory の名前空間。
- service_name: Service Directory サービスの名前。
注: これらのラベルの値は、Service Directory リソースの構成時に決定されます。
稼働時間チェックの構成で port 値を指定する必要はありません。Service Directory エンドポイントのポート値は稼働時間チェック構成の設定値をオーバーライドします。Service Directory 構成にポートが指定されていない場合は、チェックが失敗します。
稼働時間チェックの構成では、checker_type フィールドに値 VPC_CHECKERS を指定する必要があります。この値は、非公開稼働時間チェックに必要です。デフォルトでは、稼働時間チェックは公開されるため、公開稼働時間チェックではこのフィールドを指定する必要はありません。

次の JSON コードは、プライベートネットワーク上の VM インスタンスに構成された Service Directory リソースを使用した、非公開稼働時間チェックの UptimeCheckConfig オブジェクトを示しています。

{
  "displayName": "private-check-demo",
  "monitoredResource": {
    "type": "servicedirectory_service",
    "labels": {
      "project_id": "SERVICE_DIRECTORY_PROJECT_ID",
      "service_name": "PRIVATE_SERVICE",
      "namespace_name": "PRIVATE_NAMESPACE",
      "location": "REGION"
    }
  },
  "httpCheck": {
    "requestMethod": "GET"
  },
  "period": "60s",
  "timeout": "10s",
  "checker_type": "VPC_CHECKERS"
}'

Service Directory サービスが稼働時間チェックと同じ Google Cloud プロジェクトにある場合に、非公開稼働時間チェックを作成するには、次の手順に従います。

gcloud CLI のデフォルトの Google Cloud プロジェクトを設定します。
```
gcloud config set project PROJECT_ID
```
プロジェクト ID を格納する環境変数を作成します。
```
export PROJECT_ID=$(gcloud config get-value core/project)
```
アクセストークンを保持する環境変数を作成します。
```
export TOKEN=`gcloud auth print-access-token`
```

curl ツールを使用して uptimeCheckConfigs.create メソッドを呼び出し、それに構成オブジェクトをポストします。

curl https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/uptimeCheckConfigs \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
--request POST --data '{
"displayName": "private-check-demo",
"monitoredResource": {
  "type": "servicedirectory_service",
  "labels": {
    "project_id": "'"$PROJECT_ID"'",
    "service_name": "PRIVATE_SERVICE",
    "namespace_name": "PRIVATE_NAMESPACE",
    "location": "REGION"
  }
},
"httpCheck": {
  "requestMethod": "GET"
},
"period": "60s",
"timeout": "10s",
"checker_type": "VPC_CHECKERS"
}'

稼働時間チェックの作成に失敗した場合は、サービスアカウントに必要なロールがあることを確認します。詳細については、稼働時間チェックの作成に失敗するをご覧ください。

API: モニタリング対象プロジェクト

非公開稼働時間チェックの UptimeCheckConfig オブジェクトは、次の点で公開稼働時間チェックのオブジェクトとは異なります。

稼働時間チェックの構成で指定するモニタリング対象リソースは、タイプ servicedirectory_service である必要があります。このリソースタイプには次のラベルがあります。
- project_id: Service Directory サービスに関連付けられているプロジェクト ID。
- location: サービスに関連付けられたクラウドリージョン。
- namespace_name: Service Directory の名前空間。
- service_name: Service Directory サービスの名前。
注: これらのラベルの値は、Service Directory リソースの構成時に決定されます。
稼働時間チェックの構成で port 値を指定する必要はありません。Service Directory エンドポイントのポート値は稼働時間チェック構成の設定値をオーバーライドします。Service Directory 構成にポートが指定されていない場合は、チェックが失敗します。
稼働時間チェックの構成では、checker_type フィールドに値 VPC_CHECKERS を指定する必要があります。この値は、非公開稼働時間チェックに必要です。デフォルトでは、稼働時間チェックは公開されるため、公開稼働時間チェックではこのフィールドを指定する必要はありません。

{
  "displayName": "private-check-demo",
  "monitoredResource": {
    "type": "servicedirectory_service",
    "labels": {
      "project_id": "SERVICE_DIRECTORY_PROJECT_ID",
      "service_name": "PRIVATE_SERVICE",
      "namespace_name": "PRIVATE_NAMESPACE",
      "location": "REGION"
    }
  },
  "httpCheck": {
    "requestMethod": "GET"
  },
  "period": "60s",
  "timeout": "10s",
  "checker_type": "VPC_CHECKERS"
}'

Service Directory サービスが、稼働時間チェックの Google Cloud プロジェクトの指標スコープによってモニタリングされている Google Cloud プロジェクトにある場合に、非公開稼働時間チェックを作成するには、次のようにします。

稼働時間チェックを作成する Google Cloud プロジェクトがデフォルトになるように gcloud CLI を構成します。
```
gcloud config set project PROJECT_ID
```
プロジェクト ID を格納する環境変数を作成します。
```
export PROJECT_ID=$(gcloud config get-value core/project)
```
Service Directory サービスが定義されている Google Cloud プロジェクトのプロジェクト ID を格納する環境変数を作成します。
```
export MONITORED_PROJECT_ID=MONITORED_PROJECT_ID
```
このプロジェクトは、稼働時間チェックのプロジェクトの指標スコープ内にある必要があります。
アクセストークンを保持する環境変数を作成します。
```
export TOKEN=`gcloud auth print-access-token`
```

curl ツールを使用して uptimeCheckConfigs.create メソッドを呼び出し、それに構成オブジェクトをポストします。

curl https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/uptimeCheckConfigs \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
--request POST --data '{
"displayName": "private-check-demo",
"monitoredResource": {
  "type": "servicedirectory_service",
  "labels": {
    "project_id": "'"$MONITORED_PROJECT_ID"'",
    "service_name": "PRIVATE_SERVICE",
    "namespace_name": "PRIVATE_NAMESPACE",
    "location": "REGION"
  }
},
"httpCheck": {
  "requestMethod": "GET"
},
"period": "60s",
"timeout": "10s",
"checker_type": "VPC_CHECKERS"
}'

稼働時間チェックの結果が Monitoring に送信され始めるまでに、最大 5 分の遅延が発生する可能性があります。その間、稼働時間チェックダッシュボードには「データがありません」というステータスが表示されます。

前提条件の手順

Google Cloud コンソールのインターフェースを使用する場合は、非公開稼働時間チェックを作成するに移動してください。Google Cloud コンソールでは、前提条件のすべての手順について説明しています。

コマンドラインを使用して非公開稼働時間チェックを構成する場合は、稼働時間チェックを作成するには、まず次の手順を行う必要があります。

Service Directory リソースを構成する
サービスアカウントを承認する
ファイアウォールルールの構成

Service Directory リソースを構成する

非公開稼働時間チェックでは、Service Directory サービスによって録音された内部 IP アドレスを使用してリソースの可用性を判断します。Service Directory は、次のリソースに構成できます。

プライベートネットワークの VM
L4 内部ロードバランサ（ILB）

非公開稼働時間チェックを使用するには、次の Service Directory リソースを構成する必要があります。

エンドポイント: エンドポイントは、サービスがリクエストを処理するために使用できる IP アドレスとポートの値のペアです。サービスに複数のエンドポイントがある場合は、1 つのエンドポイントがランダムに選択されます。
サービス: サービスは、一連の動作を提供するエンドポイントの集まりです。サービスは、非公開稼働時間チェックのターゲットです。
名前空間: 名前空間はサービス名とその関連エンドポイントのセットを保持します。名前空間を使用すると、サービスをグループ化して、一貫した管理を行えます。

これらのリソースは、gcloud CLI または Google Cloud　コンソールで構成できます。コンソールを使用する場合、構成手順は [稼働時間チェックを作成] ダイアログに表示されます。

Google Cloud コンソール

Google Cloud コンソールを使用する場合、稼働時間チェックのリソースタイプとして [内部 IP] を選択すると、Service Directory とサービスを作成するように求められます。

gcloud CLI - VM

このドキュメントでサービス、名前空間、エンドポイントに使用されているコマンドについては、gcloud service-directory コマンドグループをご覧ください。

VM 用の Service Directory リソースを作成するには、次の操作を行います。

Service Directory リソースを作成する Google Cloud プロジェクトをデフォルトとして使用するように Google Cloud CLI を構成します。
```
gcloud config set project PROJECT_ID
```

プロジェクト ID とプロジェクト番号を格納する環境変数を作成します。

export PROJECT_ID=$(gcloud config get-value core/project)

export PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format='get(projectNumber)')

Service Directory の名前空間を作成します。

gcloud service-directory namespaces create PRIVATE_NAMESPACE --location=REGION

その名前空間に Service Directory サービスを作成します。

gcloud service-directory services create PRIVATE_SERVICE \
--namespace PRIVATE_NAMESPACE --location=REGION

プライベートネットワークにある VM の IP アドレスを保持する環境変数を作成します。

export INTERNAL_IP=$(gcloud compute instances describe --zone=ZONE \
PRIVATE_SERVICE_INSTANCE --format='get(networkInterfaces[0].networkIP)')

内部 IP アドレスとポートを含む Service Directory エンドポイントを作成します。

gcloud service-directory endpoints create PRIVATE_ENDPOINT \
--location=REGION --namespace=PRIVATE_NAMESPACE \
--service=PRIVATE_SERVICE \
--network=projects/$PROJECT_NUMBER/locations/global/networks/PRIVATE_CHECK_NETWORK \
--address=$INTERNAL_IP --port=80

gcloud CLI - L4 ILB

非公開稼働時間チェックを使用して、L4 ILB に対する Service Directory リソースを作成することで、L4 内部ロードバランサ（ILB）の可用性をモニタリングできます。

新しい L4 ILB を作成する場合は、Service Directory による自動統合を使用できます。詳細については、Service Directory で内部ロードバランサを構成するをご覧ください。

Service Directory による自動統合を使用せずに作成された L4 ILB がある場合は、次の手順により Service Directory リソースを手動で構成できます。

Service Directory リソースを作成する Google Cloud プロジェクトをデフォルトとして使用するように Google Cloud CLI を構成します。
```
gcloud config set project PROJECT_ID
```

プロジェクト ID とプロジェクト番号を格納する環境変数を作成します。

export PROJECT_ID=$(gcloud config get-value core/project)

export PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format='get(projectNumber)')

すべての稼働時間チェッカーが L4 ILB にデータを転送できるようにするには、ILB へのグローバルアクセスを有効にします。
```
gcloud compute forwarding-rules update ILB_FORWARDING_RULE_NAME \
--region=ILB_REGION --allow-global-access
```
L4 ILB がグローバルアクセスを許可しない場合、稼働時間の指標は、ILB_REGION が次のいずれかである場合にのみ利用できます。
- us-east4
- us-central1
- us-west1
- europe-west1
- southamerica-east1
- asia-southeast1

Service Directory の名前空間を作成します。

gcloud service-directory namespaces create PRIVATE_NAMESPACE_FOR_ILB\
--location=REGION

その名前空間に Service Directory サービスを作成します。

gcloud service-directory services create PRIVATE_SERVICE_FOR_ILB \
--namespace PRIVATE_NAMESPACE_FOR_ILB --location=REGION

プライベートネットワークにあるロードバランサの IP アドレスを保持する環境変数を作成します。

export INTERNAL_IP=$( gcloud compute forwarding-rules describe ILB_FORWARDING_RULE_NAME\
--region=ILB_REGION --format='get(IPAddress)')

内部 IP アドレスとポートを含む Service Directory エンドポイントを作成します。

gcloud service-directory endpoints create PRIVATE_ENDPOINT_FOR_ILB \
--location=ILB_REGION --namespace=PRIVATE_NAMESPACE_FOR_ILB \
--service=PRIVATE_SERVICE_FOR_ILB \
--network=projects/$PROJECT_NUMBER/locations/global/networks/PRIVATE_CHECK_NETWORK \
--address=$INTERNAL_IP --port=80

サービスアカウントを承認する

稼働時間チェックは、Monitoring 所有のサービスアカウントを使用して、Service Directory サービスとのやり取りを管理します。サービスアカウントの名前は次の形式です。

service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com

このサービスアカウントが存在しない場合、非公開稼働時間チェックを作成するときに Monitoring によってサービスアカウントが作成されます。このサービスアカウントは作成できません。

非公開稼働時間チェックを作成すると、Monitoring はサービスアカウントに 2 つの Service Directory のロールを付与しようとします。ただし、API を使用する場合、Google Cloud プロジェクトの設定により、Monitoring がサービスアカウントにロールを付与できない可能性があります。この場合、稼働時間チェックの作成は失敗します。

このセクションでは、既存のサービスアカウントに必要なロールを付与する方法について説明します。

Google Cloud コンソール

Google Cloud コンソールを使用する場合、稼働時間チェックのリソースタイプとして [内部 IP] を選択すると、サービスアカウントを承認するように求められます。

API: プロジェクトのスコーピング

既存のサービスアカウントに Service Directory のロールを付与するには、次の操作を行います。

稼働時間チェックを作成する Google Cloud プロジェクトがデフォルトになるように gcloud CLI を構成します。
```
gcloud config set project PROJECT_ID
```

プロジェクト ID とプロジェクト番号を格納する環境変数を作成します。

export PROJECT_ID=$(gcloud config get-value core/project)

export PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format='get(projectNumber)')

次のコマンドを実行します。

gcloud projects add-iam-policy-binding $PROJECT_ID \
--member='serviceAccount:service-'$PROJECT_NUMBER'@gcp-sa-monitoring-notification.iam.gserviceaccount.com' \
--role='roles/servicedirectory.viewer'

gcloud projects add-iam-policy-binding $PROJECT_ID \
--member='serviceAccount:service-'$PROJECT_NUMBER'@gcp-sa-monitoring-notification.iam.gserviceaccount.com' \
--role='roles/servicedirectory.pscAuthorizedService'

上記のコマンドは、サービスアカウントに次のロールを付与します。

roles/servicedirectory.viewer
roles/servicedirectory.pscAuthorizedService

API: モニタリング対象プロジェクト

既存のサービスアカウントに Service Directory のロールを付与するには、次の操作を行います。

稼働時間チェックを作成する Google Cloud プロジェクトがデフォルトになるように gcloud CLI を構成します。
```
gcloud config set project PROJECT_ID
```

プロジェクト ID とプロジェクト番号を格納する環境変数を作成します。

export PROJECT_ID=$(gcloud config get-value core/project)

export PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format='get(projectNumber)')

Service Directory サービスが定義されているプロジェクトのプロジェクト ID を保持する環境変数を作成します。
```
export MONITORED_PROJECT_ID=MONITORED_PROJECT_ID
```
このプロジェクトは、稼働時間チェックのプロジェクトの指標スコープ内にある必要があります。
ネットワークが定義されているプロジェクトのプロジェクト ID を保持する環境変数を作成します。
```
export NETWORK_PROJECT_ID=NETWORK_PROJECT_ID
```
このプロジェクトは、稼働時間チェックのプロジェクトの指標スコープに存在する必要はありません。
次のコマンドを実行します。
```
gcloud projects add-iam-policy-binding $MONITORED_PROJECT_ID \
--member='serviceAccount:service-'$PROJECT_NUMBER'@gcp-sa-monitoring-notification.iam.gserviceaccount.com' \
--role='roles/servicedirectory.viewer'
```
```
gcloud projects add-iam-policy-binding $NETWORK_PROJECT_ID \
--member='serviceAccount:service-'$PROJECT_NUMBER'@gcp-sa-monitoring-notification.iam.gserviceaccount.com' \
--role='roles/servicedirectory.pscAuthorizedService'
```
上記のコマンドは、サービスアカウントに次のロールを付与します。
- Service Directory サービスが構成されているモニタリング対象プロジェクト（$SERVICE_MONITORED_PROJECT_ID）の場合 roles/servicedirectory.viewer。
- プライベートネットワークが構成されているプロジェクト（$NETWORK_PROJECT_ID）の場合 roles/servicedirectory.pscAuthorizedService。

ファイアウォールルールを構成する

ルート 35.199.192.0/19 からの受信 TCP トラフィックを有効にするファイアウォールルールを作成する必要があります。35.199.192.0/19 からのルートは、限定公開ルーティングを使用する転送先への接続をサポートします。詳細については、VPC ルートをご覧ください。

Google Cloud コンソール

Google Cloud コンソールを使用する場合、稼働時間チェックのリソースタイプとして [内部 IP] を選択すると、ファイアウォールルールを構成するように求められます。

gcloud CLI

プライベートネットワークアクセスのファイアウォールを通過する TCP 受信トラフィックを許可するファイアウォールルールを作成するには、次のコマンドを実行します。

稼働時間チェックを作成する Google Cloud プロジェクトがデフォルトになるように gcloud CLI を構成します。
```
gcloud config set project PROJECT_ID
```
プロジェクト ID とプロジェクト番号を格納する環境変数を作成します。
```
export PROJECT_ID=$(gcloud config get-value core/project)
```
ネットワークルールを作成します。
```
gcloud compute firewall-rules create PRIVATE_CHECK_NETWORK_HOPE_RULE \
--network="PRIVATE_CHECK_NETWORK"  \
--action=allow   --direction=ingress   --source-ranges="35.199.192.0/19" \
--rules=tcp   --project="$PROJECT_ID"
```
上記のコマンドでは、PRIVATE_CHECK_NETWORK は、このルールが関連付けられているネットワークで、PRIVATE_CHECK_NETWORK_HOPE_RULE はファイアウォールルールの名前です。

このステップの詳細については、ネットワークプロジェクトを構成するをご覧ください。

制限事項

非公開稼働時間チェックを使用する場合、構成に関係なく SSL 証明書の検証は無効になります。

非公開稼働時間チェックは、リダイレクトが設定されているエンドポイントをサポートしていません。

トラブルシューティング

このセクションでは、非公開稼働時間チェックの使用時に発生する可能性のあるエラーとその解決方法について説明します。

稼働時間チェックの作成に失敗する

Google Cloud プロジェクトの設定により、稼働時間チェックが Service Directory サービスとのやり取りを管理する際に使用するサービスアカウントに割り当てられたロールを変更できなくなる場合があります。この場合、稼働時間チェックの作成は失敗します。

このセクションでは、サービスアカウントに必要なロールを付与する方法について説明します。

Google Cloud コンソール

Google Cloud コンソールを使用して非公開の稼働時間チェックを作成すると、Google Cloud コンソールは Service Directory のロールをサービスアカウントに付与するコマンドを実行します。

サービスアカウントにロールを付与する方法については、サービスアカウントを承認するをご覧ください。

API: プロジェクトのスコーピング

1 つの Google Cloud プロジェクトで、Service Directory サービスとプライベートリソースのプライベート稼働時間チェックを初めて作成する際には、リクエストが成功することも失敗することもあります。結果は、プロジェクトでサービスアカウントに対する自動的なロール付与を無効にしているかどうかによって変わります。

プロジェクトでサービスアカウントに対する自動的なロール付与が許可されている場合、最初の稼働時間チェックは正常に作成されます。サービスアカウントが作成され、必要なロールが付与されます。
プロジェクトでサービスアカウントに対する自動的なロール付与が許可されていない場合、最初の稼働時間チェックの作成は失敗します。サービスアカウントは作成されますが、ロールは付与されません。

稼働時間チェックの作成に失敗した場合は、次の操作を行います。

サービスアカウントを承認する。
権限が反映されるまで数分待ちます。
非公開稼働時間チェックを再度作成してください。

API: モニタリング対象プロジェクト

モニタリング対象プロジェクトの Service Directory サービスまたは別の Google Cloud プロジェクトのプライベートリソースを対象とする非公開稼働時間チェックを初めて作成するときに、リクエストが失敗し、Monitoring サービスアカウントが作成されます。

サービスアカウントを承認する方法は、使用している Google Cloud プロジェクトの数とその関係によって異なります。最大 4 つのプロジェクトが関与する場合があります。

非公開稼働時間チェックを定義したプロジェクト。
Service Directory サービスを構成したモニタリング対象プロジェクト。
VPC ネットワークを構成したプロジェクト。
ネットワークリソース（VM やロードバランサなど）が構成されているプロジェクト。このプロジェクトには、ここで説明するサービスアカウントの承認でのロールがありません。

最初の稼働時間チェックの作成に失敗した場合は、次の手順を行います。

サービスアカウントを承認する。
権限が反映されるまで数分待ちます。
非公開稼働時間チェックを再度作成してください。

アクセスが拒否されました

VPC_ACCESS_DENIED という結果で稼働時間チェックが失敗しています。この結果は、ネットワーク構成やサービスアカウントの承認の一部が正しくないことを意味します。

稼働時間チェックの作成が失敗するの説明に沿って、スコーピングプロジェクトまたはモニタリング対象プロジェクトを使用するためのサービスアカウントの承認を確認します。

プライベートネットワークへのアクセスについての詳細は、ネットワークプロジェクトを構成するをご覧ください。

非公開稼働時間チェックからの異常な結果

複数の VM を含む Service Directory サービスがあり、サービス構成には複数のエンドポイントが含まれます。いずれかの VM をシャットダウンしても、稼働時間チェックは成功を示します。

サービス構成に複数のエンドポイントがある場合は、ランダムに 1 つが選択されます。選択したエンドポイントに関連付けられた VM が実行されている場合、VM の 1 つが停止していても、稼働時間チェックは成功します。

デフォルトのヘッダー

稼働時間チェックからエラーまたは予期しない結果が返されます。これは、デフォルトのヘッダー値をオーバーライドした場合に発生することがあります。

非公開稼働時間チェックのリクエストがターゲットエンドポイントに送信されると、リクエストには次のヘッダーと値が含まれます。

ヘッダー	値
`HTTP_USER_AGENT`	`GoogleStackdriverMonitoring-UptimeChecks(https://cloud.google.com/monitoring)`
`HTTP_CONNECTION`	`keep-alive`
`HTTP_HOST`	Service Directory エンドポイントの IP
`HTTP_ACCEPT_ENCODING`	`gzip`、`deflate`、`br`
`CONTENT_LENGTH`	稼働時間の投稿データから計算

これらの値をオーバーライドしようとすると、次のようになる可能性があります。

稼働時間チェックでエラーが報告される
オーバーライド値は破棄され、テーブル内の値で置き換えられる

データが表示されない

稼働時間チェックが Service Directory サービスとは異なる Google Cloud プロジェクトにある場合、稼働時間チェックのダッシュボードにデータが表示されません。

稼働時間チェックを含む Google Cloud プロジェクトが、Service Directory サービスを含む Google Cloud プロジェクトをモニタリングしていることを確認します。

モニタリング対象プロジェクトを一覧表示して追加する方法については、複数のプロジェクトの指標スコープを構成するをご覧ください。

非公開稼働時間チェックを作成する

始める前に

Google Cloud コンソール

gcloud CLI

非公開稼働時間チェックを作成する

Google Cloud コンソール

API: プロジェクトのスコーピング

API: モニタリング対象プロジェクト

前提条件の手順

Service Directory リソースを構成する

Google Cloud コンソール

gcloud CLI - VM

gcloud CLI - L4 ILB

サービス アカウントを承認する

Google Cloud コンソール

API: プロジェクトのスコーピング

API: モニタリング対象プロジェクト

ファイアウォール ルールを構成する

Google Cloud コンソール

gcloud CLI

制限事項

トラブルシューティング

稼働時間チェックの作成に失敗する

Google Cloud コンソール

API: プロジェクトのスコーピング

API: モニタリング対象プロジェクト

アクセスが拒否されました

非公開稼働時間チェックからの異常な結果

デフォルトのヘッダー

データが表示されない

次のステップ

サービスアカウントを承認する

ファイアウォールルールを構成する