Cloud Logging 完全ガイド｜ログクエリ・Log Router・Audit Logs・保持期間 (GCP)

Cloud Logging は GCP の統合ログ管理サービスで、全 GCP サービスのログを自動収集 + 検索 + 分析できます。Logging Query Language (LQL) によるパワフルな検索、Log Router による柔軟なルーティング、Audit Logs によるコンプライアンス対応が中核機能です。

主要コンポーネント

Log Entry: 1 件のログレコード
Log Bucket: ログの保管先 (_Default / _Required / Custom)
Log Sink (Log Router): ログのルーティングルール
Log View: Bucket 内のフィルタ済みビュー (RBAC)
Log-based Metric: ログから生成するメトリクス

Log Bucket 種別

Bucket	保持期間	用途
_Default	30 日 (変更可、最大 10 年)	標準ログ受け皿
_Required	400 日 (固定)	Admin Activity / System Event / Policy Denied
Custom	1 日〜10 年	長期保管、Log Analytics 用

Logging Query Language (LQL) 例

# 特定サービスのエラー
resource.type="cloud_run_revision"
resource.labels.service_name="my-api"
severity>=ERROR

# 特定 JSON フィールド
jsonPayload.user_id="user-123"
jsonPayload.duration_ms>1000

# 時間範囲
timestamp>="2026-05-01T00:00:00Z"
timestamp<="2026-05-31T23:59:59Z"

# 否定 + AND/OR
severity=(ERROR OR CRITICAL)
NOT textPayload:"health check"

# Audit log で特定操作
protoPayload.methodName="storage.buckets.delete"
protoPayload.authenticationInfo.principalEmail="[email protected]"

Audit Logs 種別

種別	内容	料金
Admin Activity	リソース変更 (常時、無効化不可)	無料
Data Access	データ読み書き (要有効化)	$0.50/GiB
System Event	Google 起因のシステム操作	無料
Policy Denied	IAM / VPC SC 拒否	無料

Log Router (Sink) パターン

BigQuery Sink: ログを BigQuery にエクスポート、SQL で分析
Cloud Storage Sink: 長期アーカイブ (Archive class で安価)
Pub/Sub Sink: リアルタイム連携 → Dataflow / SIEM
Log Bucket Sink: 別 Project / Region の Bucket に転送
Exclude Filter: 不要ログを取り込み前に除外 (コスト削減)

Log-based Metric 例

# Counter: ERROR ログ件数
filter: 'resource.type="cloud_run_revision" severity>=ERROR'
metric_kind: DELTA
value_type: INT64

# Distribution: API レスポンス時間
filter: 'jsonPayload.event="api_request"'
value_extractor: 'EXTRACT(jsonPayload.duration_ms)'

料金

項目	料金
取り込み	$0.50/GiB
保管 (30 日超)	$0.01/GiB/月
無料枠	月 50 GiB 取り込み
Log Router	無料 (BigQuery 等の宛先料金は別途)
Log Analytics	無料 (Storage は別途)

Log Analytics

2022 リリース、ログを BigQuery エンジンでクエリ
標準 SQL で複雑分析 + JOIN 可能
Custom Bucket を Log Analytics 対応で作成
無料 (Storage は標準料金)

他クラウド比較

項目	Cloud Logging	CloudWatch Logs	Azure Monitor Logs
クエリ言語	LQL	CloudWatch Logs Insights	KQL
保持	30 日〜10 年	1 日〜永久	4 日〜2 年 (+ Archive)
取り込み料金	$0.50/GiB	$0.50/GiB	$2.30/GB
長期分析	Log Analytics (BQ)	S3 export	Workspace

ベストプラクティス

Exclude Filter で health check 等の無駄ログを除外
長期保管は BigQuery Sink (安価で SQL 分析可能)
SIEM 連携は Pub/Sub Sink → 任意 Destination
Structured Logging (jsonPayload) を徹底
severity を正しく設定 (INFO / WARNING / ERROR / CRITICAL)
Sensitive Data Protection と組み合わせて PII 検知

Cloud Logging のログ保持期間は？

_Default Bucket = 30 日、_Required Bucket = 400 日 (Audit Logs)。Custom Bucket で最大 10 年保管可能。

ログクエリ言語は？

Logging Query Language (LQL)。SQL ライクな構文で resource.type / severity / jsonPayload 等の絞り込みが可能。

Log-based Metric とは？

ログから Counter / Distribution メトリクスを自動生成。例: ERROR ログ件数を時系列メトリクス化 → アラート連携。

Log Router (Sink) で何ができる？

ログを BigQuery / Cloud Storage / Pub/Sub / 別 Log Bucket にルーティング。長期分析・SIEM 連携・コスト最適化に必須。

Audit Logs は何種類？

Admin Activity (常時)、Data Access (要有効化)、System Event (常時)、Policy Denied (常時)。Data Access が最も大量。

料金体系は？

取り込み $0.50/GiB、保管 $0.01/GiB/月 (30 日超過後)。月 50 GiB 取り込み無料。Audit Admin Activity と System Event は無料。

AWS CloudWatch Logs / Azure Monitor Logs 比較は？

GCP は LQL が強力、AWS は CloudWatch Logs Insights、Azure は KQL。GCP は GKE / Cloud Run の自動収集と LQL の組み合わせが優位。

OpenTelemetry でログ送信できる？

可能。OpenTelemetry Collector 経由で Cloud Logging に送信。アプリ側の Vendor lock-in 回避。

この記事で学んだ内容を問題で確認しましょう

16,000問以上の問題で実力チェック

GCP 試験対策ページを見る

この記事の著者

NicheeLab編集部

データエンジニアリング・クラウド資格の専門家。Databricks・Snowflake等の認定資格を保有し、実務経験に基づいた問題作成・解説を行っています。NicheeLab運営。

Cloud Logging 完全ガイド｜ログクエリ・Log Router・Audit Logs・保持期間