このページでは、Cloud Logging を取得して使用し、Looker（Google Cloud Core）インスタンスのログを表示してクエリを実行する方法について説明します。
Looker（Google Cloud コア）は Cloud Logging を使用します。詳細については、Cloud Logging のドキュメントをご覧ください。
必要なロール
Cloud Logging に必要なロールを理解するには、Cloud Logging のドキュメントの IAM によるアクセス制御ページをご覧ください。
ログを表示
Looker（Google Cloud コア）インスタンスのログエントリのログを表示するには、次のいずれかのオプションを選択します。
Console
- Google Cloud コンソールで、[ロギング] > [ログ エクスプローラ] に移動します。
- ページの上部にある既存の Looker（Google Cloud コア）プロジェクトを選択します。
- クエリビルダーに以下のクエリを追加します。
- リソース: [Looker インスタンス] を選択します。ダイアログで、Looker（Google Cloud Core）インスタンス ID を選択します。
- ログ名: [Looker] セクションまでスクロールし、インスタンスに適したログファイルを選択します。たとえば、次のように設定します。
- looker.googleapis.com%2FContentAccess
- looker.googleapis.com%2FUserLogin
- 重大度: ログレベルを選択します。
- 時間範囲: プリセットを選択するか、カスタム範囲を作成します。
gcloud
gcloud logging コマンドを使用して、ログエントリを表示します。
gcloud logging read "resource.type=looker.googleapis.com/Instance" \ --project=PROJECT_ID \ --limit=10 \ --format=json
次のように置き換えます。
- PROJECT_ID: Looker（Google Cloud コア）インスタンスが存在する Google Cloud プロジェクトの ID。
また、次のフラグを含めることもできます。
limitフラグは、返されるエントリの最大数を示すオプションのパラメータです。
トラブルシューティング
| 問題 | トラブルシューティング |
|---|---|
| ログファイルが不完全です。 | ロギングが構成されている重大度を確認します。構成したレベルより低いログメッセージは破棄されます。 |
| ログにオペレーション情報が見つからない。 | オペレーションの詳細を確認したい場合があります。
たとえば、ユーザーが削除され、誰がその操作を行ったのかを確認できない場合があります。ログでは、オペレーションが開始したことは確認できますが、それ以上の情報は記録されません。このような詳細な個人情報（PII）を記録するには、監査ログを有効にする必要があります。 |
| ログファイルが読みにくい。 | ログを JSON またはテキストで表示することもできます。gcloud logging read コマンドを Linux の後処理コマンドと一緒に使用して、ログをダウンロードできます。ログを JSON 形式でダウンロードするには、次のコードを使用します。
gcloud logging read \
"resource.type=looker.googleapis.com/Instance \
AND logName=projects/PROJECT_ID \
/logs/looker.googleapis.com%2FLOG_NAME" \
--format json \
--project=PROJECT_ID \
--freshness="1d" \
> downloaded-log.json
次のように置き換えます。
ログをテキストとしてダウンロードするには、次のコードを使用します。 gcloud logging read \ "resource.type=looker.googleapis.com/Instance \ AND logName=projects/PROJECT_ID \ /logs/looker.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 次のように置き換えます。
|