Cloud Logging を使用して、Looker（Google Cloud コア）インスタンスのログを表示してクエリできます。これらのログをモニタリングすることで、問題のトラブルシューティング、使用状況の追跡、Looker 環境の健全性とセキュリティの確保に役立ち、オペレーションに信頼できるデータを提供できます。Cloud Logging の詳細については、Cloud Logging のドキュメントをご覧ください。
必要なロール
Cloud Logging に必要なロールを理解するには、Cloud Logging のドキュメントの IAM によるアクセス制御ページをご覧ください。
ログを表示
Looker（Google Cloud コア）インスタンスのログエントリを表示するには、次のいずれかのオプションを選択します。
Console
- コンソール Google Cloud で、[ロギング] > [ログ エクスプローラ] に移動します。
- ページの上部にある既存の Looker（Google Cloud コア）プロジェクトを選択します。
- クエリビルダーに以下のクエリを追加します。
- リソース: [Looker インスタンス] を選択します。ダイアログで、 Looker（Google Cloud コア）インスタンス 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 またはテキストで表示しています。ログは、Linux 後処理コマンドとともに
gcloud logging read
コマンドを使用してダウンロードできます。
ログを 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 次のように置き換えます。
|