このページでは、Cloud Logging を取得して使用し、Cloud SQL インスタンスのログを表示してクエリを実行する方法について説明します。
Cloud SQL は Cloud Logging を使用します。詳細については、Cloud logging のドキュメントをご覧ください。また、Cloud SQL のサンプルクエリもご覧ください。
ログを表示する
Cloud SQL インスタンスのログエントリのログを表示するには:
コンソール
-
Google Cloud コンソールで、[Cloud Logging] ページに移動します。
- ページの上部で既存の Cloud SQL プロジェクトを選択します。
- クエリビルダーに以下のクエリを追加します。
- リソース: [Cloud SQL データベース] を選択します。ダイアログで、Cloud SQL インスタンスを選択します。
- ログ名: Cloud SQL セクションまでスクロールし、インスタンスに適したログファイルを選択します。例:
- cloudsql.googleapis.com/sqlagent.out
- cloudsql.googleapis.com/sqlserver.err
- 重大度: ログレベルを選択します。
- 時間範囲: プリセットを選択するか、カスタム範囲を作成します。
gcloud
gcloud logging コマンドを使用して、ログエントリを表示します。次の例では、PROJECT_ID を置き換えます。
limit フラグは、返されるエントリの最大数を示すオプションのパラメータです。
gcloud logging read "resource.type=cloudsql_database" \ --project=PROJECT-ID \ --limit=10 \ --format=json
インスタンスのオペレーション ログを表示する
[オペレーション] パネルではインスタンスのログを見ることができます。[オペレーション] パネルには、インスタンスで実行されたすべてのオペレーションについてログに記録された、次の情報が表示されます。
- オペレーションの完了時刻（ローカル タイムゾーンで表されます）。
- オペレーションのタイプ。
- オペレーションのステータス。
- オペレーションの結果を説明するメッセージ。
オペレーションが失敗した場合は、メッセージを使用して問題をトラブルシューティングできます。
インスタンスのオペレーション ログを表示するには:
-
Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。
- インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
- [オペレーション] をクリックして、オペレーション ログの表示パネルに切り替えます。
アプリケーション ログを表示する
Cloud SQL に接続するアプリケーションは、ログをさまざまな場所に保存します。
App Engine（フレキシブル環境）
[コンピューティング] > [App Engine] > [サービス] で、次の操作を行います。
- サービスのリストでサービスを探します。
- [ツール] プルダウンをクリックします。
- [ログ] を選択します。
Google Cloud コンソールの [オペレーション] > [ロギング] > [ログ エクスプローラ] セクションで、次のクエリを使用します。
resource.type="gae_app"
resource.labels.module_id="default"
Cloud Run
Google Cloud コンソールの Cloud Run の [ログ エクスプローラ] セクションでログを表示します。Cloud Run は、Cloud SQL Auth Proxy からのエラー メッセージのみを報告します。次のようなクエリを使用します。
resource.type="cloud_run_revision"
resource.labels.service_name="$SERVICE_NAME"
resource.labels.revision_name="$REVISION_NAME"
Cloud SQL Auth Proxy
[オペレーション] > [ロギング] > [ログ エクスプローラ] で、次のクエリを使用します。
log_id("appengine.googleapis.com/cloud-sql-proxy")
監査ログの表示
Cloud SQL インスタンスでは、次のタイプの監査ログを表示できます。
- 管理アクティビティ: メタデータまたは構成情報を書き込む管理者オペレーションが含まれます。これらのログを無効にすることはできません。
- データアクセス: メタデータまたは構成情報を読み取る管理者オペレーションが含まれます。これらのログには、ユーザー提供データの読み取りまたは書き込みを行うオペレーションも含まれます。データアクセス監査ログを受信するには、監査ログを明示的に有効にする必要があります。
- システム イベント: リソースの構成を変更する Google Cloud の自動化されたアクションを特定します。これらのログを無効にすることはできません。
管理アクティビティ、データアクセス、システム イベントの監査ログの表示について詳しくは、ログを表示するをご覧ください。
料金
Cloud Logging の料金の詳細については、Cloud Logging の料金概要をご覧ください。
トラブルシューティング
| 問題 | トラブルシューティング |
|---|---|
| 監査ログが見つからない。 | オペレーションが、ユーザー作成データを作成、変更、または読み取る認証済みのユーザー ドリブン API 呼び出しの場合、またはリソースの構成ファイルまたはメタデータにアクセスした場合にのみ、データアクセス ログに書き込まれます。 |
| ログにオペレーション情報が見つからない。 | オペレーションの詳細を確認したい場合があります。 たとえば、ユーザーが削除され、誰がその操作を行ったのかを確認できない場合があります。ログでは、オペレーションが開始したことは確認できますが、それ以上の情報は記録されません。このような詳細な個人情報（PII）を記録するには、監査ログを有効にする必要があります。 |
一部のログは、Cloud SQL for SQL Server インスタンスの error.log ログからフィルタリングされます。 |
フィルタリングされたログには、タイムスタンプのない AD ログが含まれます。また、Login failed for user 'x'. Reason: Token-based server access
validation failed with an infrastructure error. Login lacks connect endpoint
permission. [CLIENT: 127.0.0.1] も含まれます。これらのログは、混乱を招く可能性があるため、フィルタリングされています。 |
| ログファイルが読みにくい。 | ログを json またはテキストで表示することもできます。gcloud logging read コマンドを Linux の後処理コマンドと一緒に使用して、ログをダウンロードできます。ログを JSON 形式でダウンロードするには: gcloud logging read \ "resource.type=cloudsql_database \ AND logName=projects/PROJECT_ID \ /logs/cloudsql.googleapis.com%2FLOG_NAME" \ --format json \ --project=PROJECT_ID \ --freshness="1d" \ > downloaded-log.json ログをテキスト形式でダウンロードするには: gcloud logging read \ "resource.type=cloudsql_database \ AND logName=projects/PROJECT_ID \ /logs/cloudsql.googleapis.com%2FLOG_NAME" \ --format json \ --project=PROJECT_ID \ --freshness="1d"| jq -rnc --stream 'fromstream(1|truncate_stream(inputs)) \ | .textPayload' \ --order=asc > downloaded-log.txt |