Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Cloud Scheduler の問題をトラブルシューティングする

このページでは、Cloud Scheduler の問題を解決する方法について説明します。

Cloud Scheduler は、各ジョブ実行の開始時と終了時にログを公開します。Cloud Scheduler で使用可能な監査ログなど、特定のジョブのログを取得、表示、分析できます。詳細については、ログの表示をご覧ください。

デフォルトでは、Cloud Scheduler ジョブがターゲットサービス（ジョブリクエストハンドラ）から確認応答を受信しない場合、ジョブは失敗したと見なされます。Cloud Scheduler は、構成した指数バックオフに従ってジョブを再試行します。

Google Cloud サービスに影響するインシデントについては、Google Cloud Service Health ダッシュボードと Cloud Scheduler に関して報告されているすべてのインシデントをご覧ください。

ダウンストリームサービスの問題によりジョブが失敗する

ジョブの失敗は、Cloud Scheduler 自体ではなく、Cloud Scheduler がターゲットとしているダウンストリームサービス（Cloud Run など）の問題が原因である可能性があります。次の条件が当てはまる場合は、ダウンストリームサービスの問題が疑われます。

Cloud Scheduler の権限が正しく設定されている。
Cloud Scheduler がターゲットサービスに正常にアクセスできる。
Cloud Scheduler の実行ログのエラーメッセージは、ダウンストリームサービスから送信されます。

この問題を解決するには、次の操作を行います。

ダウンストリームサービスを直接呼び出す: Cloud Scheduler を使用せずにダウンストリームサービスを正常に呼び出せることを確認します。呼び出しが成功した場合は、Cloud Scheduler が問題の原因となっている可能性があります。失敗した場合は、ダウンストリームサービスをさらにデバッグする必要があります。
宛先サービスのサービスログを調べる: 宛先サービスのサービスログを調べて、出力されているエラーを特定し、それに応じてトリアージします。
長時間実行オペレーションを探す: Cloud Scheduler が長時間実行オペレーション（30 分以上）に対して HTTP 504 エラーを返す場合は、宛先サービスログを調べて、実行が成功したか失敗したかを確認します。宛先サービスのリクエストタイムアウトが長い可能性があります。このようなシナリオでは、Cloud Scheduler はタイムアウトしますが、宛先サービスはタイムアウトしません。

ジョブが権限エラーで失敗する

権限は、リソースにアクセスできるプリンシパルと、許可されるオペレーションを制御します。権限が正しく構成されていないと、ジョブの実行が中断され、権限拒否エラーが発生する可能性があります。監査ログには、すべての権限変更の詳細な記録が保存されるため、これらの問題の原因を特定できます。

Cloud Scheduler ジョブが権限エラーで失敗すると、実行ログに "debugInfo":"URL_ERROR-ERROR_OTHER. Original HTTP response code number = 403" のようなメッセージが表示されることがあります。

この問題を解決するには、次のいずれかの確認を完了してください。

サービスエージェントに付与されている IAM ロールを確認する: Cloud Scheduler サービスエージェントには、Cloud Scheduler サービスエージェント（roles/cloudscheduler.serviceAgent）ロールが必要です。このロールがないと、Cloud Scheduler ジョブは失敗します。このロールは、Cloud Scheduler サービスエージェントに手動で付与できます。手動での付与は、2019 年 3 月 19 日より前に Cloud Scheduler API を有効にした場合、または Cloud Scheduler サービスエージェントのロールを削除した場合にのみ必要です。詳細については、Cloud Scheduler サービスエージェントのロールを付与するをご覧ください。
サービスアカウントの権限を確認する: ジョブに接続されているサービスアカウントに、宛先サービスを呼び出すための正しい権限とスコープがあることを確認します。これには、ターゲットが別のプロジェクトにある場合や、仲介サービスの最終ターゲットである場合も含まれます。ターゲットが Google Cloud内にある場合は、サービスアカウントに必要なロールが付与されていることを確認します。 Google Cloud 内の各サービスには特定のロールが必要です。生成されたトークンは受信側のサービスによって自動的に検証されます。たとえば、Cloud Run と Cloud Run functions の場合は、Cloud Run Invoker ロールを付与する必要があります。ターゲットが Google Cloudの外部にある場合、受信サービスはトークンを手動で確認する必要があります。詳細については、Cloud Scheduler の認証と HTTP ターゲットで認証を使用するをご覧ください。
VPC Service Controls の違反を確認する: VPC Service Controls は、データの引き出しを防ぐセキュアな境界を設定できる Google Cloudの機能です。VPC Service Controls に起因するエラーかどうかを特定するには、VPC Service Controls が有効で、使用するプロジェクトとサービスに適用されているかどうかを確認します。プロジェクトとサービスが VPC Service Controls で保護されているかどうかを確認するには、そのリソース階層レベルで VPC Service Controls ポリシーを確認します。

問題の範囲を把握するには、監査ログから VPC Service Controls のエラーを取得します。
1. Google Cloud コンソールで、 [ログエクスプローラ] ページに移動します。
  [ログエクスプローラ] に移動
  
  検索バーを使用してこのページを検索する場合は、小見出しが [Logging] の結果を選択します。
2. 次の条件で監査ログをクエリします。
```
severity="ERROR" AND protoPayload.status.details.violations.type="VPC_SERVICE_CONTROLS"
```
  具体的には、エラーメッセージに次のテキストが含まれる場合があります。
  - Request is prohibited by organization's policy
  - Request violates VPC Service Controls
VPC Service Controls の構成時に発生する可能性のある問題の詳細については、一般的な問題のトラブルシューティングをご覧ください。
プライベートエンドポイントを確認する: Cloud Scheduler は、Cloud Run、Cloud Run functions、 Google Cloud API などの特定のプライベートエンドポイントのみを VPC Service Controls の境界内で呼び出すことができます。宛先サービスの上り（内向き）設定（Cloud Run のネットワーク上り（内向き）を制限するを参照）と、接続されているサービスアカウントの権限を確認します。URL_ERROR-ERROR_DNS エラーメッセージが表示されることがあります。詳細については、このドキュメントの宛先ターゲットに到達できないためジョブが失敗するをご覧ください。

宛先ターゲットに到達できないためジョブが失敗する

この問題は、宛先ターゲットに到達できないために Cloud Scheduler ジョブが失敗した場合に発生します。実行ログに、URL_ERROR または URL_UNREACHABLE で始まるエラーが表示される。

この問題を解決するには、受信したエラーメッセージに応じて、次のいずれかのチェックを行います。

URL_ERROR-ERROR_AUTHENTICATION: HTTP 401 (Unauthorized) または HTTP 407 (Proxy Authentication Required) エラーが返されます。宛先ターゲットには認証が必要ですが、Cloud Scheduler リクエストに有効な認証トークンが含まれていません。たとえば、リクエストに認証ヘッダーがないか、認証情報が無効です。ジョブの認証設定を確認します。ターゲットエンドポイントのリクエストヘッダーに API キーが必要な場合は、ヘッダー名が api_key ではなく、ターゲットサービスが想定している名前（x-api-key や X-Goog-Api-Key など）と一致していることを確認します。詳細については、Cloud Scheduler に対する認証と HTTP ターゲットで認証を使用するをご覧ください。
URL_ERROR-ERROR_DNS: ドメインネームシステム（DNS）を使用してホスト名を解決できなかったため、URL の取得に失敗したことを示します。たとえば、ホスト名が存在しないか、関連付けられた IP アドレスがない場合です。エラーメッセージに、Original HTTP response code number = 0 というテキストが含まれる場合があります。ホスト名の有効性を確認します。プライベートエンドポイントを呼び出す場合は、Cloud Scheduler でサポートされていることを確認し、上り（内向き）設定を確認します。
URL_ERROR-ERROR_NOT_FOUND: ウェブサーバーが HTTP 404 Not Found エラーを返します。ターゲット URL が正しく、リソースが存在することを確認します。
URL_ERROR-ERROR_OTHER: これまでに説明されていない一般的な HTTP 4xx エラーを指します。ログを確認して、元の HTTP レスポンスコードを取得します。HTTP 403 エラーが発生した場合は、このドキュメントの権限エラーでジョブが失敗するをご覧ください。
URL_UNREACHABLE-UNREACHABLE_5xx: 宛先ターゲットが HTTP 5xx または 429 エラーを返します。これは、サーバーの過負荷など、一時的な状態である可能性があります。宛先ターゲットのログを確認して、問題をデバッグします。
URL_UNREACHABLE-UNREACHABLE_CONNECTION_RESET: 接続がピアによってリセットされました。外部サーバー側で問題がないか確認します。
URL_UNREACHABLE-UNREACHABLE_ERROR: ネットワークエラーを示します。ターゲット URL が正しいかどうか、アクセスをブロックするファイアウォールルールがあるかどうかを確認します。

セキュアな境界を使用する場合にサポートされないターゲット

Cloud Scheduler が VPC Service Controls 境界の制限付きサービスである場合、サポートされていないターゲットを含むジョブを作成または更新しようとすると、TARGET_TYPE_NOT_PERMITTED_FOR_VPC エラーコードで失敗します。詳細については、VPC Service Controls で cron ジョブを保護するをご覧ください。

ジョブの実行に関する問題

Cloud Scheduler ジョブは、指定した時刻または一定間隔で実行されます。ジョブの実行中に次の問題が発生することがあります。

以前に動作していたジョブが実行を停止する

この問題は、Cloud Scheduler API が無効になっているために、以前に正常に実行された Cloud Scheduler ジョブの実行が停止した場合に発生します。API が無効になった時刻を確認するには、次の条件で監査ログをクエリします。

resource.type="audited_resource" AND
protoPayload.serviceName="cloudscheduler.googleapis.com" AND
operation.producer="serviceusage.googleapis.com" AND
protoPayload.authorizationInfo.permission="serviceusage.services.disable"

この問題を解決するには、Cloud Scheduler API を有効にします。

後続のジョブ実行が開始されない

この問題は、ジョブがまだ実行中であるか、ターゲットからのレスポンスを待機している場合に発生します。ジョブの他のスケジュールされた実行は、現在の実行が終了するかタイムアウトするまでスキップされます。

ロギングエントリで、最新の type.googleapis.com/google.cloud.scheduler.logging.AttemptStarted エントリと、対応する type.googleapis.com/google.cloud.scheduler.logging.AttemptFinished エントリを見つけます。AttemptFinished エントリがない場合、またはジョブの次のスケジュールされた実行後に表示される場合、他の保留中の実行はブロックされ、開始されません。ジョブのスケジュールによっては、複数のジョブ実行が開始されないことがあります。さらに調査するには、ジョブの宛先ターゲットのタイムアウトを確認し、このターゲットで問題が発生していないかどうかを確認します。

どの時点をとっても同じジョブの複数インスタンスが同時に実行されないようにしてください。まれに、同じジョブの複数のインスタンスがリクエストされる可能性があります。このためリクエストハンドラはべき等である必要があります。またコードを記述する際は、このような状態が発生した場合に有害な副作用が発生しないようにする必要があります。

夏時間が原因でジョブの実行が不規則になる

Google Cloud コンソールを使用して Cloud Scheduler ジョブを作成する場合は、タイムゾーンを指定する必要があります。Google Cloud CLI を使用する場合は、必要に応じて --time-zone フラグを使用してタイムゾーンを指定できます。指定しない場合、デフォルトのタイムゾーンとして協定世界時（UTC）が使用されます。

この問題は、ジョブが UTC 以外のタイムゾーンで構成され、夏時間（DST）の変更により実行が不規則になる場合に発生します。これは想定された挙動です。

ジョブで非常に正確な周期が必要な場合は、DST を使用しないタイムゾーンを選択する必要があります。特に、この問題を完全に回避するには、UTC タイムゾーンを使用するようにジョブスケジュールを構成します。

詳細については、cron ジョブの形式とタイムゾーンをご覧ください。

次のステップ

Cloud Scheduler のドキュメントで問題の解決策が見つからない場合は、次のオプションを検討してください。

Stack Overflow で質問してコミュニティからサポートを受けるか、google-cloud-scheduler タグを使用して類似の問題を検索する。
Google Cloud カスタマーケアに問い合わせて、サポートケースを登録する。
公開 Issue Trackerを使用して、バグの報告や機能リクエストを行う。

詳細については、Cloud Scheduler のサポートをご覧ください。

Cloud Scheduler の問題をトラブルシューティングする コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

ダウンストリーム サービスの問題によりジョブが失敗する