オートスケーラーログの表示

自動スケーリングを有効にすると、指定されたオプションに基づいてオートスケーラーがスケーリングに関する判断を下します。スケーリングに関するそれぞれの判断は Cloud Logging によって記録されます。ログエクスプローラでこれらのログを読み込み、オートスケーラーのスケーリングに関する決定について理解を深めます。

ログエクスプローラを使用すると、以下に関連するイベントを表示できます。

マネージドインスタンスグループ（MIG）のサイズ変更に関するオートスケーラーの推奨事項オートスケーラーが MIG の新しい推奨サイズを計算する場合は、推奨サイズの変更はオートスケーラーログに記述されます。ログエントリのサイズを変更するをご覧ください。
オートスケーラーのステータスの変更。たとえば、想定どおりに動作していたオートスケーラーに問題が発生した場合、ステータスの変更がオートスケーラーログに記述されます。ステータス変更のログエントリをご覧ください。

始める前に

自動スケーリングのドキュメントを読みます。
ログを表示する対象となるアクティブなオートスケーラーを用意します。
ログエクスプローラの使用方法を確認します。
まだ設定していない場合は、認証を設定します。認証とは、Google Cloud サービスと API にアクセスするために ID を確認するプロセスです。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。

Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

オートスケーラーログを表示する

オートスケーラーログを表示するには、Google Cloud コンソール、gcloud CLI、または REST を使用します。

コンソール

自動スケーリングをオンにしている場合は、Google Cloud コンソールで自動スケーリングのログを表示できます。

[ログエクスプローラ] ページに移動
[ログエクスプローラ] に移動
リソース プルダウンメニューをプルダウンし、[GCE オートスケーラー] を選択します。

次の手順で、MIG から [ログエクスプローラ] ページに移動することもできます。

Google Cloud コンソールの [インスタンスグループ] ページに移動します。

[インスタンスグループ] に移動
ログを表示する MIG の名前をクリックします。
[モニタリング] タブをクリックします。
[モニタリング] タブで、[ログ] パネルはページの下部にあります。このパネルの最後にあるアイコンをクリックしてパネルを開きます。
[ログエクスプローラ] ページを開くには、このパネルの [ログエクスプローラで表示] アイコンをクリックします。デフォルトのクエリでログエクスプローラが開き、MIG のすべてのオートスケーラーログを取得します。

gcloud

自動スケーリングに関連するすべてのログを検索するには、logging read コマンドを使用します。次に例を示します。

gcloud logging read "resource.type=autoscaler" --limit 10 \
    --format json

特定の MIG のオートスケーラーログを表示するには、次のように instance_group_manager_name を指定します。

gcloud logging read "resource.type=autoscaler AND \
    resource.labels.instance_group_manager_name=example-igm" \
    --limit 10 --format json

オートスケーラーのサイズ変更アクションに関連するログエントリを表示するには、compute.autoscalers.resize メソッド名を指定します。

gcloud logging read "resource.type=autoscaler AND \
    resource.labels.instance_group_manager_name=example-igm AND \
    protoPayload.methodName=compute.autoscalers.resize" \
    --limit 10 --format json

オートスケーラーのステータスの変更に関連するログエントリを表示するには、compute.autoscalers.changeStatus メソッド名を指定します。

gcloud logging read "resource.type=autoscaler AND \
    resource.labels.instance_group_manager_name=example-igm AND \
    protoPayload.methodName=compute.autoscalers.changeStatus" \
    --limit 10 --format json

REST

Logging V2 API へのリクエストを発行します。リクエスト本文には、ログ検索で使用する filter パラメータと、ログ表示の対象となる project が含まれている必要があります。たとえば、特定の MIG のサイズ変更アクションのリストを取得するには次の要求を行います。

POST https://logging.googleapis.com/v2/entries:list

{
  "filter": "resource.type=autoscaler AND
    resource.labels.instance_group_manager_name=example-igm AND
    protoPayload.methodName=compute.autoscalers.resize",
  "pageSize": 10,
  "resourceNames": [
    "projects/example-project"
  ]
}

特定の MIG のステータス変更のリストを取得するために次の要求を行います。

POST https://logging.googleapis.com/v2/entries:list

{
  "filter": "resource.type=autoscaler AND
    resource.labels.instance_group_manager_name=example-igm AND
    protoPayload.methodName=compute.autoscalers.changeStatus",
  "pageSize": 10,
  "resourceNames": [
    "projects/example-project"
  ]
}

ログエントリのサイズを変更する

オートスケーラーで MIG の推奨サイズが計算されると、Compute Engine では新しい推奨サイズと古い推奨サイズをキャプチャするログエントリが作成されます。ゾーン MIG の場合、ログエントリには推奨サイズの変更理由もキャプチャされます。

以下は、ゾーン MIG のログエントリの例です。この例でオートスケーラーは、予測自動スケーリングに基づいて、目標の CPU 使用率 35% を達成するには 3 個の VM が最適であると計算しています。ただし、自動スケーリングポリシーで構成されるインスタンスの最大数は 2 です。そのため、オートスケーラーは推奨サイズを 2 に制限します。

    {
    insertId: "1l68z7sg4jw7kzo"
    logName: "projects/example-project/logs/cloudaudit.googleapis.com%2Fsystem_event"
    protoPayload: {
      @type: "type.googleapis.com/google.cloud.audit.AuditLog"
      metadata: {
        @type: "type.googleapis.com/autoscaler.AutoscalerSizeChangeExplanation"
        autoscalingMode: "ON"
        autoscalingReason: {
          scalingLimit: {
            limitPolicy: {
              maxNumReplicas: 2
            }
            limitSize: 2
            name: "MAX_INSTANCES"
          }
          scalingSignal: {
            calculatedSize: 3
            calculationDetails: {
              servingSize: 1
              signalTarget: 0.35
              signalValue: 1.03533
            }
            name: "PREDICTED_CPU_UTILIZATION"
            signalPolicy: {
              coolDownPeriodSec: 15
              cpuUtilization: {
                predictiveMethod: "OPTIMIZE_AVAILABILITY"
                utilizationTarget: 0.35
              }
            }
          }
          summary: "The autoscaler's recommended size changed from 1 to 2
          because the autoscaler predicted that in 15 seconds the average CPU
          utilization across 1 serving instance will be 103.533%, which is above
          the utilization target of 35%. The calculated size was 3 to achieve
          the target CPU utilization but the size was limited by the maximum
          number of instances set in the autoscaling policy."
        }
        newSize: 2
        oldSize: 1
      }
      methodName: "compute.autoscalers.resize"
      resourceName: "projects/example-project/zones/us-east1-d/autoscalers/example-autoscaler"
      serviceName: "compute.googleapis.com"
    }
    receiveTimestamp: "2022-06-13T22:34:43.045973046Z"
    resource: {
      labels: {
        autoscaler_id: "1234567890123456789"
        autoscaler_name: "example-autoscaler"
        instance_group_manager_id: "1357908642148074125"
        instance_group_manager_name: "example-igm"
        location: "us-east1-d"
        project_id: "example-project"
      }
      type: "autoscaler"
    }
    severity: "INFO"
    timestamp: "2022-06-13T22:34:42.810216614Z"
    }

次の表に、ログエントリのフィールドの説明を示します。

プロパティ	値
`autoscalingMode`	エントリがログに記録された時点の自動スケーリングモード。モードに関係なく、オートスケーラーは、ログで `newSize` で表される推奨サイズを計算します。自動スケーリングモードに応じて、オートスケーラーは MIG を次のように変更します。 `ON`: オートスケーラーは MIG のサイズを `newSize` に変更します。 `OFF`: オートスケーラーは MIG のサイズを変更しません。 `ONLY_SCALE_OUT`: オートスケーラーは、`newSize` が MIG の目標サイズより大きい場合にのみ MIG のサイズを変更します。
`autoscalingReason`	自動スケーリングの理由の詳細。このフィールドは、ゾーン MIG の場合のみ表示されます。
`autoscalingReason.scalingLimit`	`calculatedSize` を制限した自動スケーリング機能の詳細。これは、自動スケーリングシグナルに基づいてオートスケーラーが計算したサイズです。`calculatedSize` を制限できる自動スケーリング機能は、インスタンスの最大数または最小数、スケールインの制御、または安定化期間です。`calculatedSize` に適用される制限がない場合、`scalingLimit` フィールドはログに表示されません。
`autoscalingReason.scalingLimit.limitPolicy`	`calculatedSize` を制限した自動スケーリング機能の構成。安定化は自動スケーリングのデフォルトの機能であるため、安定化が `calculatedSize` を制限する場合、`limitPolicy` フィールドは設定されません。
`autoscalingReason.scalingLimit.limitSize`	`calculatedSize` を制限した自動スケーリング機能に基づく VM の数。
`autoscalingReason.scalingLimit.name`	`calculatedSize` を制限した自動スケーリング機能の名前。
`autoscalingReason.scalingSignal`	MIG が持つべき VM 数の計算に使用される自動スケーリングシグナルの詳細。自動スケーリングポリシーに複数のシグナルがある場合、オートスケーラーは、最大数の VM を必要とするシグナルを考慮します。
`autoscalingReason.scalingSignal.calculatedSize`	MIG が持つべき VM の数は、自動スケーリングシグナルに基づきます。`scalingLimit` が適用される場合、オートスケーラーは `calculatedSize` を `scalingLimit.limitSize` に制限します。
`autoscalingReason.scalingSignal.calculationDetails`	`calculatedSize` の決定に使用される詳細。 `servingSize`: 初期化期間中の VM を除く MIG の VM の数。 `signalTarget`: オートスケーラーが CPU 使用率（リアルタイム）、予測 CPU 使用率、ロードバランシング使用率、または使用率のターゲットで構成された指標に対して維持するターゲット値。 `singleInstanceAssignment`: スケーリングが行われる作業量の合計を表す指標の値に基づいている場合、 `singleInstanceAssignment` は各 VM が処理できる作業量です。 `signalValue`: 自動スケーリングシグナルの値。`signalTarget` が設定されている場合、オートスケーラーは `signalValue` を `signalTarget` と比較し、必要な VM の数を計算します。これは、`calculatedSize` によって表されます。
`autoscalingReason.scalingSignal.name`	オートスケーラーが（ログ内で `calculatedSize` として表示される）VM の数を計算するために使用した自動スケーリングシグナルの名前。
`autoscalingReason.scalingSignal.signalPolicy`	オートスケーラーが `calculatedSize` を判断するために使用した自動スケーリングシグナルの構成。
`autoscalingReason.summary`	自動スケーリングの理由の説明。
`newSize`	MIG の現在の推奨サイズ。`autoscalingMode` に応じて、オートスケーラーは次のように MIG のサイズを `newSize` に変更します。 `ON`: オートスケーラーは MIG のサイズを `newSize` に変更します。 `OFF`: オートスケーラーは MIG のサイズを変更しません。 `ONLY_SCALE_OUT`: オートスケーラーは、`newSize` が MIG の目標サイズより大きい場合にのみ MIG のサイズを変更します。
`oldSize`	MIG の以前の推奨サイズ。

ログエントリのその他のフィールドについては、監査ログエントリの形式をご覧ください。

ステータス変更のログエントリ

オートスケーラーのステータスが変わると、Compute Engine は新旧のステータスメッセージをキャプチャするログエントリを作成します。このステータスメッセージは、オートスケーラーが予期したとおりに動作しない理由を調べたり、過去に発生していた問題をデバッグしたりするために使用できます。一般的なステータスメッセージについては、よく返されるステータスメッセージをご覧ください。

protoPayload の次のフィールドでは、新旧のステータスについて説明します。

metadata.newStatus.details: オートスケーラーの新しいステータス。
metadata.oldStatus.details: オートスケーラーの以前のステータス。

以下に、ステータスの変更を示すログエントリの例を示します。この例では、ロードバランシング構成に問題があることを示す新しいステータスメッセージが表示されます。

    {
      insertId: "ivho6kg4icqfio"
      logName: "projects/example-project/logs/cloudaudit.googleapis.com%2Fsystem_event"
      protoPayload: {
        metadata: {
          @type: "type.googleapis.com/autoscaler.AutoscalerStatusChange"
          newStatus: {
            details: "The autoscaler is configured to scale based on a load
            balancing signal but the instance group has not received any
            utilization data from the load balancer or the utilization is
            constantly 0. Check that the load balancing configuration is
            working"
          }
          oldStatus: {
            details: "OK"
          },
          methodName: "compute.autoscalers.changeStatus"
          resourceName: "projects/example-project/zones/us-east1-b/autoscalers/example-autoscaler"
          serviceName: "compute.googleapis.com"
        }
        receiveTimestamp: "2022-06-08T03:54:12.332329320Z"
        resource: {
          labels: {
            autoscaler_id: "1234567890123456789"
            autoscaler_name: "example-autoscaler"
            instance_group_manager_id: "1357908642148074125"
            instance_group_manager_name: "example-igm"
            location: "us-east1-b"
            project_id: "example-project"
          }
          type: "autoscaler"
        }
        severity: "INFO"
        timestamp: "2022-06-08T03:54:10.675416812Z"
      }
    }

ログエントリのその他のフィールドについては、監査ログエントリの形式をご覧ください。

次のステップ

ログから受け取った情報を使用してオートスケーラーを更新する。
オートスケーラーの決定方法について確認する。
自動スケーリングのオプションを確認する。

オートスケーラー ログの表示

始める前に

Console

gcloud

REST

オートスケーラー ログを表示する

コンソール

gcloud

REST

ログエントリのサイズを変更する

ステータス変更のログエントリ

次のステップ

オートスケーラーログの表示

オートスケーラーログを表示する