内部パススルー ネットワーク ロードバランサのロギングとモニタリング

コンソール

1. Google Cloud コンソールで、[ロード バランシング] ページに移動します。

   [ロード バランシング] に移動

2. ロードバランサの名前をクリックします。

3. [edit 編集] をクリックしてから、[バックエンドの構成] をクリックします。

4. [バックエンド サービスを作成] を選択し、必須のバックエンド サービス フィールドに入力します。

5. [ロギングを有効にする] をクリックします。

6. [サンプルレート] の値を選択します。レートは 0.0～1.0（デフォルト）に設定できます。

7. 省略可: ログにすべてのオプション フィールドをすべて含めるには、[任意項目] セクションで [すべてのオプションのフィールドを含める] をクリックします。

8. バックエンド サービスの編集を終了するには、[更新] をクリックします。

9. ロードバランサの編集を終了するには、[更新] をクリックします。

gcloud

gcloud compute backend-services create コマンドを使用してバックエンド サービスを作成し、ロギングを有効にします。

gcloud compute backend-services create BACKEND_SERVICE \
  --region=REGION \
  --enable-logging \
  --logging-sample-rate=SAMPLE_RATE
  --logging-optional=LOGGING_OPTIONAL \
  --logging-optional-fields=OPTIONAL_FIELDS

次のように置き換えます。

• BACKEND_SERVICE: バックエンド サービスの名前。
• REGION: 作成するバックエンド サービスのリージョン。

• SAMPLE_RATE: このフィールドは、このバックエンド サービスでロギングが有効になっている場合にのみ指定できます。

  フィールドの値は 0.0 から 1.0 の間にする必要があります。ここで、0.0 はログが報告されないことを意味し、1.0 は、サンプリングされたすべてのパケットについて接続がログに記録されることを意味します。ロギングを有効にしても、サンプリング レートが 0.0 であれば、ロギングが無効の場合と同じ結果になります。デフォルト値は 1.0 です。

• LOGGING_OPTIONAL: ログに含めるオプション アノテーション。

  • INCLUDE_ALL_OPTIONAL: すべてのアノテーションを含める場合。

  • EXCLUDE_ALL_OPTIONAL（デフォルト）: すべてのオプション アノテーションを除外します。

  • CUSTOM: OPTIONAL_FIELDS で指定するオプション フィールドのカスタムリストを含める場合。

• OPTIONAL_FIELDS: ログに含めるオプション フィールドのカンマ区切りのリスト。

  たとえば serverInstance.vm, serverGkeDetails です。LOGGING_OPTIONAL が CUSTOM に設定されている場合のみ設定できます。

API

regionBackendServices.insert メソッドに POST リクエストを送信します。

 POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/backendServices
 

すべてのオプション フィールドを除外する

 {
 "name": "BACKEND_SERVICE",
  "loadBalancingScheme": "INTERNAL",
  "logConfig": {
   "enable": true,
   "sampleRate": SAMPLE_RATE,
   "optionalMode": "EXCLUDE_ALL_OPTIONAL"
  }
 }

すべてのオプションのフィールドを含める

{
 "name": "BACKEND_SERVICE",
 "loadBalancingScheme": "INTERNAL",
 "logConfig": {
   "enable": true,
   "sampleRate": SAMPLE_RATE,
   "optionalMode": "INCLUDE_ALL_OPTIONAL"
  }
}

オプションのフィールドのカスタムリストを含める

{
 "name": "BACKEND_SERVICE",
 "loadBalancingScheme": "INTERNAL",
 "logConfig": {
   "enable": true,
   "sampleRate": SAMPLE_RATE,
   "optionalMode": "CUSTOM",
   "optionalFields": ["field1","field2",...]
  }
}

コンソール

1. Google Cloud コンソールで、[ロード バランシング] ページに移動します。

   [ロード バランシング] に移動

2. ロードバランサの名前をクリックします。

3. [edit 編集] をクリックしてから、[バックエンドの構成] をクリックします。

4. バックエンド サービスの横にある [edit編集] をクリックします。

5. [ロギングを有効にする] をクリックします。

6. [サンプルレート] の値を選択します。レートは 0.0～1.0（デフォルト）に設定できます。

7. 省略可: ログにすべてのオプション フィールドをすべて含めるには、[任意項目] セクションで [すべてのオプションのフィールドを含める] をクリックします。

8. バックエンド サービスの編集を終了するには、[更新] をクリックします。

9. ロードバランサの編集を終了するには、[更新] をクリックします。

gcloud

gcloud compute backend-services update コマンドを使用して、既存のバックエンド サービスでロギングを有効にします。

gcloud compute backend-services update BACKEND_SERVICE \
--region=REGION \
--enable-logging \
--logging-sample-rate=SAMPLE_RATE \
--logging-optional=LOGGING_OPTIONAL \
--logging-optional-fields=OPTIONAL_FIELDS

次のように置き換えます。

• BACKEND_SERVICE: バックエンド サービスの名前。
• REGION: 作成するバックエンド サービスのリージョン。

• SAMPLE_RATE: このフィールドは、このバックエンド サービスでロギングが有効になっている場合にのみ指定できます。

  フィールドの値は 0.0 から 1.0 の間にする必要があります。ここで、0.0 はログが報告されないことを意味し、1.0 は、サンプリングされたすべてのパケットについて接続がログに記録されることを意味します。ロギングを有効にしても、サンプリング レートが 0.0 であれば、ロギングが無効の場合と同じ結果になります。デフォルト値は 1.0 です。

• LOGGING_OPTIONAL: ログに含めるオプション アノテーション。

  • INCLUDE_ALL_OPTIONAL: すべてのアノテーションを含める場合。

  • EXCLUDE_ALL_OPTIONAL（デフォルト）: すべてのオプション アノテーションを除外します。

  • CUSTOM: OPTIONAL_FIELDS で指定するオプション フィールドのカスタムリストを含める場合。

• OPTIONAL_FIELDS: ログに含めるオプション フィールドのカンマ区切りのリスト。

  たとえば serverInstance.vm,serverGkeDetails です。LOGGING_OPTIONAL が CUSTOM に設定されている場合のみ設定できます。

API

regionBackendServices/patch メソッドに PATCH リクエストを送信します。

 PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/backendServices/BACKEND_SERVICE
 

すべてのオプション フィールドを除外する

 "logConfig": {
   "enable": true,
   "sampleRate": SAMPLE_RATE,
   "optionalMode": "EXCLUDE_ALL_OPTIONAL"
  }
 

すべてのオプションのフィールドを含める

 "logConfig": {
   "enable": true,
   "sampleRate": SAMPLE_RATE,
   "optionalMode": "INCLUDE_ALL_OPTIONAL"
  }
 

オプションのフィールドのカスタムリストを含める

 "logConfig": {
   "enable": true,
   "sampleRate": SAMPLE_RATE,
   "optionalMode": "CUSTOM",
   "optionalFields": ["field1","field2",...]
  }

コンソール

1. Google Cloud コンソールで、[ロード バランシング] ページに移動します。

   [ロード バランシング] に移動

2. ロードバランサの名前をクリックします。

3. [edit 編集] をクリックしてから、[バックエンドの構成] をクリックします。

4. ロギングを完全に無効にするには、[ロギングを有効にする] をクリアします。

5. ロギングを有効にした場合、[サンプルレート] に異なる値を設定できます。レートは 0.0～1.0（デフォルト）に設定できます。サンプリングされたパケットの 20% に対してのみログを生成するには、値を 0.2 に設定します。

6. バックエンド サービスの編集を終了するには、[更新] をクリックします。

7. ロードバランサの編集を終了するには、[更新] をクリックします。

gcloud

gcloud compute backend-services update コマンドを使用して、バックエンド サービスのロギングを無効にします。

gcloud compute backend-services update BACKEND_SERVICE \
  --region=REGION \
  --no-enable-logging

次のように置き換えます。

• BACKEND_SERVICE: バックエンド サービスの名前。
• REGION: 作成するバックエンド サービスのリージョン。

API

regionBackendServices/patch メソッドに PATCH リクエストを送信します。

 PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/backendServices/BACKEND_SERVICE

 {
 "logConfig": {
   "enable": false
  }
 }
 

コンソール

1. Google Cloud Console で、[ログ エクスプローラ] ページに移動します。

   [ログ エクスプローラ] に移動

2. [内部パススルー ネットワーク ロードバランサ ルール] リソースタイプを選択します。

3. loadbalancing.googleapis.com/flows ログ名を選択します。

コンソールのクエリ

1. Google Cloud コンソールで、[ログ エクスプローラ] ページに移動します。

   [ログ エクスプローラ] に移動

2. [クエリを表示] をクリックします。

3. または、[クエリ] フィールドに次の内容を貼り付けます。ここで、PROJECT_ID は実際のプロジェクト ID に置き換えます。

   resource.type="loadbalancing.googleapis.com/InternalNetworkLoadBalancerRule"
   logName="projects/PROJECT_ID/logs/loadbalancing.googleapis.com%2Fflows"
   

4. [クエリを実行] をクリックします。

コンソール クエリ

1. Google Cloud コンソールで、[ログ エクスプローラ] ページに移動します。

   [ログ エクスプローラ] に移動

2. [クエリを表示] をクリックします。

3. または、[クエリ] フィールドに次の内容を貼り付けます。PROJECT_ID はプロジェクト ID、BACKEND_SERVICE_NAME はバックエンド サービスの名前に置き換えます。

   resource.type="loadbalancing.googleapis.com/InternalNetworkLoadBalancerRule"
   logName="projects/PROJECT_ID/logs/loadbalancing.googleapis.com%2Fflows"
   resource.labels.backend_service_name="BACKEND_SERVICE_NAME"
   

4. [クエリを実行] をクリックします。

コンソール クエリ

1. Google Cloud コンソールで、[ログ エクスプローラ] ページに移動します。

   [ログ エクスプローラ] に移動

2. [クエリを表示] をクリックします。

3. または、[クエリ] フィールドに次の内容を貼り付けます。PROJECT_ID はプロジェクト ID に置き換え、BACKEND_GROUP_NAME はインスタンス グループまたは NEG の名前に置き換えます。

   resource.type="loadbalancing.googleapis.com/InternalNetworkLoadBalancerRule"
   logName="projects/PROJECT_ID/logs/loadbalancing.googleapis.com%2Fflows"
   resource.labels.backend_group_name="BACKEND_GROUP_NAME"
   

4. [クエリを実行] をクリックします。

コンソール

1. Google Cloud Console で、[Monitoring] ページに移動します。

   [Monitoring] に移動

2. ナビゲーション パネルに [リソース] が表示されている場合は [リソース] を選択し、[Google Cloud ロードバランサ] を選択します。それ以外の場合は、[ダッシュボード] を選択し、[Google Cloud ロードバランサ] という名前のダッシュボードを選択します。

3. ロードバランサの名前をクリックします。

左側のペインで、選択したロードバランサの詳細を確認できます。右側のペインでは時系列のグラフを表示できます。[Breakdowns] リンクをクリックすると、特定の内訳が表示されます。左側のペインには現在構成されているデータが表示され、右側のペインには、左側のペインに現在反映されていない、過去の構成で配信されたデータを表示できます。

コンソール

1. Google Cloud Console で、[Monitoring] ページに移動します。

   [モニタリング] に移動

2. [ダッシュボード] > [CREATE DASHBOARD] を選択します。

3. [Add Chart] をクリックします。

4. グラフにタイトルを付けます。

5. 指標とフィルタを選択します。指標におけるリソースタイプは内部パススルー TCP ネットワーク ロードバランサ ルール（internal_tcp_lb_rule）または内部パススルー UDP ネットワーク ロードバランサ ルールです。} （internal_udp_lb_rule）

6. [保存] をクリックします。

コンソール

アラート ポリシーを作成して指標の値をモニタリングすると、指標が条件に違反した場合に通知できます。

1. Google Cloud コンソールで、[notificationsアラート] ページに移動します。

   [アラート] に移動

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

2. 通知チャンネルを作成せずに通知を受け取る場合は、[EDIT NOTIFICATION CHANNELS] をクリックして、通知チャンネルを追加します。チャンネルを追加したら、[アラート] ページに戻ります。
3. [アラート] ページで、[CREATE POLICY] をクリックします。
4. 指標を選択するには、[指標を選択] メニューを開き、次の操作を行います。
   1. メニューを関連するエントリに限定するには、フィルタバーに「Google Cloud TCP Load Balancer」または「Google Cloud UDP Load Balancer」と入力します。メニューをフィルタしても結果が表示されない場合は、[有効なリソースと指標のみを表示] をオフに切り替えます。
   2. [Resource type] に [Google Cloud TCP Load Balancer] または [Google Cloud UDP Load Balancer] を選択します。
   3. 指標カテゴリと指標を選択して、[適用] を選択します。
5. [次へ] をクリックします。
6. [Configure alert trigger] ページの設定によって、アラートがトリガーされるタイミングが決まります。条件タイプを選択し、必要に応じてしきい値を指定します。詳細については、指標しきい値のアラート ポリシーを作成するをご覧ください。
7. [次へ] をクリックします。
8. （省略可）アラート ポリシーに通知を追加するには、[通知チャネル] をクリックします。ダイアログで、メニューから 1 つ以上の通知チャンネルを選択し、[OK] をクリックします。
9. （省略可）インシデントの自動クローズ期間を更新します。このフィールドは、指標データがない場合に Monitoring がインシデントを閉じるタイミングを決定します。
10. （省略可）[Documentation] をクリックして、通知メッセージに追加する情報を入力します。
11. [アラート名] をクリックして、アラート ポリシーの名前を入力します。
12. [Create Policy] をクリックします。