Cloud Loggingとは、Google Cloud のログを集めて保存し、検索・分析できるようにする仕組みです。

  • gcloud logging read の基本の形と、絞り込みの式(Logging query language)の書き方
  • severity・textPayload・logName の扱いで、エラーや要求の数が「無い」と出てしまう所
  • 当社の AI の席が本番の確かめで踏んだ偽の結果と、読み取りの割り当てに当たった時の撃ち方

当社は、本番へ出した後の確かめを AIエージェント の席に任せています。席は deploy の後に Cloud Logging を gcloud logging read で読み、ログの行数・要求の数・5xx・ERROR を数えて合否を決めます(社の実測 2026-10-22)。この頁は、Google Cloud の公式の文書に書いてある使い方と、その数え方で当社が実際に間違えた記録を並べたものです。

gcloud logging read の基本の形

gcloud logging read は、渡した絞り込みの式に合うログを、時刻の新しい順に返します。時刻の条件を式に入れなければ --freshness が効き、既定は 1 日(1d)より新しい物だけです。--limit の既定は無制限、--order の既定は desc です(https://docs.cloud.google.com/sdk/gcloud/reference/logging/read 2026-11-12 に確認)。

# ERROR 以上の段のログを読む(公式の文書の例と同じ形)
gcloud logging read 'severity>=ERROR' --project="$PROJECT"

# Cloud Run のひとつのサービスを、時刻の窓で区切って JSON で読む
gcloud logging read "resource.type=\"cloud_run_revision\"
  AND resource.labels.service_name=\"$SERVICE\"
  AND timestamp>=\"$FROM\" AND timestamp<=\"$TO\"" \
  --project="$PROJECT" --format=json

数を数える時は、時刻の窓を式に書きます。--freshness は時刻の条件を含まない式でだけ効くので(公式の文書)、窓を書いておけば「いつからいつまでを数えたか」が後から読めます。gcloud の認証の通し方は gcloud auth の頁に書いています。

絞り込みの式の書き方

書き方意味(公式の文書)数える時に気をつける所
severity>=ERROR
段が ERROR 以上のログ
severity を付けずに出したログは DEFAULT の段になり、当たらない
textPayload:"文字"
: は「含む」。その欄のどこかに文字が在れば当たる
文字の行(textPayload)で出すロガーには、こちらで数える
resource.labels.service_name="名前"
= は完全に同じ値だけ
サービスを指す条件はこの形で足りる
logName="projects/…/logs/…%2F…"
ログの名前の中の log ID は URL の形で符号化して書く
符号化を誤ると 0 件が返り、式の誤りと見分けにくい
timestamp>="…" AND timestamp<="…"
時刻の窓で区切る
比べる窓(前の revision など)も同じ幅で取る

出典: Google Cloud「Logging query language」https://docs.cloud.google.com/logging/docs/view/logging-query-language (2026-11-12 に確認)。severity の既定の値は Google Cloud「LogEntry」https://docs.cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry (2026-11-12 に確認)。

公式の文書は、LogEntry に定義された欄は、無くても既定の値を持つものとして比べ、payload やラベルの欄が無い時は比べた結果が音も無く外れる、と書いています(https://docs.cloud.google.com/logging/docs/view/logging-query-language 2026-11-12 に確認)。つまり、式が間違っていても、欄が無くても、返ってくるのは同じ「0 件」です。

severity が付くログ、付かないログ

LogEntry の severity は任意の欄で、既定は DEFAULT です。段は DEFAULT(0)・DEBUG(100)・INFO(200)・NOTICE(300)・WARNING(400)・ERROR(500)・CRITICAL(600)・ALERT(700)・EMERGENCY(800)の順に並びます(https://docs.cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry 2026-11-12 に確認)。DEFAULT は ERROR より下なので、severity の無いログは severity>=ERROR に決して当たりません。

Cloud Run では、1 行の JSON で書いたログは jsonPayload に入り、JSON の中の severity はそのログの severity に移されます。ただの文字の行は解釈されず textPayload に入ります(https://docs.cloud.google.com/run/docs/logging 2026-11-12 に確認)。アプリのロガーが色付きの文字の行を出していれば、どれほど error を書いても severity は付きません。Cloud Run の動かし方そのものは Cloud Run の頁にまとめています。

当社が本番のログを数えて間違えた記録

場面出た結果本当は見抜いた対照日付
Node のサービスのエラーを数える
severity>=ERROR で 0 件
ロガーが色付きの文字の行を出し、severity が空だった
severity の内訳と、info の文字が当たること
2026-10-08
別のサービスの deploy の後の確かめ
「ERROR 0」と報告
わざと起こした logger.error が文字の検索では当たった
わざと起こした 1 件(陽性対照)
2026-10-20
Cloud Run の要求ログだけを数える
要求ログを絞る式で 0 件
絞らずに取ると要求は在った
件数が在ると分かっている窓
2026-10-09
秘密の最終アクセスを並列に読む
RESOURCE_EXHAUSTED
読み取りの割り当てはプロジェクト共通
直列に撃ち直して全件取れた
2026-10-14
zsh で 5xx と ERROR を数える
「5xx 0・ERROR 0」
gcloud が引数の誤りで落ちていた
古い revision を同じ式で数える
2026-09-25

出典: 社の実測(日付は各行)。

5 件のうち 4 件は、どれも「0」が返ってきた所から始まっています(社の実測 2026-09-25〜2026-10-20)。0 は「何も起きていない」とも「数え方が壊れている」とも読めるので、当社は 0 を見たら、当たるはずの物が当たるかを先に確かめます。

severity>=ERROR が何も返さなかった

当社の本番の Cloud Run(Node のサービス)で severity>=ERROR を数えると 0 件でした。ロガー(winston)が色付きの文字の行を textPayload に出していて、severity が空だったためです。同じ 6 分の窓で severity の内訳は、空が 685・INFO が 369・WARNING が 13 でした(社の実測 2026-10-08)。

そこで文字で数えました。色付きの error の行は端末の色の印の 31m の後に error が続くので、textPayload:"31merror" で 12 件当たりました。同じ式の形で textPayload:"32minfo" も当たることを確かめ、式そのものが生きていると示しました(社の実測 2026-10-08)。

# severity では当たらない
gcloud logging read "$BASE AND severity>=ERROR" --project="$PROJECT" --format='value(insertId)'

# 文字で数える(色付きの error の行)
gcloud logging read "$BASE AND textPayload:\"31merror\"" --project="$PROJECT" --format='value(insertId)'

# 対照:info の行も同じ形で当たるか
gcloud logging read "$BASE AND textPayload:\"32minfo\"" --project="$PROJECT" --format='value(insertId)'

根から直すなら、ロガーを 1 行の JSON で severity の欄を持たせて出す形に替えます。そうすれば Cloud Run がその値を severity に移します(https://docs.cloud.google.com/run/docs/logging 2026-11-12 に確認)。

わざと起こした警告を陽性対照にする

別のサービスでも、deploy の後の確かめで「ERROR 0」と報告しました。ところが、その確かめの中でわざと起こした警告(logger.error)が、severity>=ERROR では 0 件、文字の検索では 1 件で、偽の 0 だと分かりました(社の実測 2026-10-20)。

以後、数え方を文字の検索に替え、わざと起こした 1 件が拾えることを陽性対照にしています(社の実測 2026-10-20)。対照が拾えない数え方で出した「0」は、合格の材料にしません。

要求ログを絞る式が何も返さない時

Cloud Run の要求ログだけを数えようとして、logName:"requests"、logName="…run.googleapis.com%2Frequests"、httpRequest.latency>"0s" の 3 通りの式を撃ちましたが、件数が在ると分かっている窓でもどれも 0 件でした(社の実測 2026-10-09)。

そこで絞るのをやめ、resource.type・service_name・timestamp だけで取り、手元で httpRequest の有る行を選びました。同じ窓で 1,870 行、うち要求が 482 件取れました(社の実測 2026-10-09)。

# 広く取って、手元で要求の行だけ数える
gcloud logging read "resource.type=\"cloud_run_revision\"
  AND resource.labels.service_name=\"$SERVICE\"
  AND timestamp>=\"$FROM\" AND timestamp<=\"$TO\"" \
  --project="$PROJECT" --format=json \
  | jq '[.[] | select(.httpRequest != null)] | length'

サーバ側で絞れない理由を突き止めるより、広く取って手元で数える方が早く、数え方も読めば分かる形で残ります。ただし広く取るほど読み取りの回数と量は増えるので、窓は必要な幅に留めます。

並列に撃つと RESOURCE_EXHAUSTED

Cloud Logging の読み取り(entries.list)は、Google Cloud のプロジェクトごとに毎分 60 回までで、この上限は引き上げられません(https://docs.cloud.google.com/logging/quotas 2026-11-12 に確認)。人ごとではなくプロジェクトに掛かる上限なので、同じプロジェクトを読む人・席・仕組みが全部で分け合います。

当社は Secret Manager の秘密の最終アクセスを調べるため、gcloud logging read を 8 本並列に撃ちました。1〜2 分で 429 RESOURCE_EXHAUSTED に当たり、2.5 秒おきの直列に撃ち直して全件取れました(社の実測 2026-10-14)。以後、本番のプロジェクトの logging read は並列にしません(社の実測 2026-10-14)。秘密の扱いは Secret Manager の頁にまとめています。

# 1 本ずつ、間を空けて読む
for s in "${SECRETS[@]}"; do
  gcloud logging read "...$s..." --project="$PROJECT" --format=json > "out/$s.json"
  sleep 2.5
done

上の間隔は当社がこの時に使った値です(社の実測 2026-10-14)。同じプロジェクトを別の仕組みが定期に読んでいれば、残りの枠はもっと少なくなります。

zsh の変数で gcloud が落ち、空の結果が返った

zsh で P="--project x"; gcloud logging read … $P と書くと、zsh は変数を語に割らないので --project x が 1 語のまま渡り、gcloud は unrecognized arguments で落ちます。stderr を捨てて | wc -l していたので、落ちた結果の 0 行がそのまま「5xx 0・ERROR 0」に化けました(社の実測 2026-09-25)。古い revision を同じ式で数えても 0 になったことで気づき、bash のスクリプトに移して撃ち直しました(社の実測 2026-09-25)。

#!/usr/bin/env bash
set -euo pipefail
# 引数は配列か、--project="$PROJECT" の形で 1 つずつ渡す
ARGS=(--project="$PROJECT" --format='value(insertId)')
out=$(gcloud logging read "$FILTER" "${ARGS[@]}")   # 落ちたらここで止まる
printf '%s\n' "$out" | grep -c . || true

数える行の前で終了コードを確かめ、stderr は捨てずに残します。「落ちた」と「0 件」を同じ出力にしないためです。

deploy の後にログで確かめる手順

当社の AI の席は、本番へ出した後の数十分〜24 時間の間に、ログの行数・要求の数・5xx・ERROR を数えて合否を決めています。ある回は、作成以降 387 行・要求 152 本で、5xx 0・ERROR 0 でした(社の実測 2026-10-22)。上の記録を踏まえ、席は次の順で数えます。

  1. 時刻の窓を決める:deploy の時刻から先を窓にし、比べる対照(前の revision など)も同じ幅の窓で取る。
  2. 広く取る:resource.type・service_name・timestamp だけで取り、要求・5xx・ERROR は手元で選ぶ(社の実測 2026-10-09)。
  3. ロガーの出し方に合わせて数える:severity が付かない文字の行なら、文字の検索で数える。
  4. 陽性対照を入れる:わざと起こした警告や、当たるはずの info の行が拾えるかを先に見る。拾えなければその数は使わない。
  5. 直列に撃つ:本番のプロジェクトの読み取りは並列にしない(社の実測 2026-10-14)。
  6. 落ちたら止める:bash で終了コードを確かめ、stderr を捨てない。

夜に定期で走る仕事を後から確かめる時も同じ順で数えます。定期の仕事の置き方は Cloud Scheduler の頁に書いています。

よくある質問

gcloud logging read で古いログが出ないのはなぜ?

時刻の条件を式に書かないと --freshness の既定(1 日)が効き、それより古いログは返りません(https://docs.cloud.google.com/sdk/gcloud/reference/logging/read 2026-11-12 に確認)。timestamp>= で窓を書くか、--freshness を広げます。

severity>=ERROR でエラーが出ないのはなぜ?

アプリが文字の行でログを出していると severity は既定の DEFAULT のままで、ERROR 以上の条件に当たりません(https://docs.cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry 2026-11-12 に確認)。textPayload:"…" の文字の検索で数えるか、ロガーを JSON で severity を持たせる形に替えます。

Cloud Logging のログは何日残る?

プロジェクトの _Default のバケットは既定で 30 日(変えられる)、_Required のバケットは 400 日(変えられない)です(https://docs.cloud.google.com/logging/quotas 2026-11-12 に確認)。

RESOURCE_EXHAUSTED が出たらどうする?

読み取りはプロジェクトごとに毎分 60 回までで、引き上げられません(https://docs.cloud.google.com/logging/quotas 2026-11-12 に確認)。並列をやめて間を空けた直列に撃ち直します。当社は 8 本の並列で当たり、2.5 秒おきの直列で全件取れました(社の実測 2026-10-14)。

出典

  1. Google Cloud「Cloud Logging overview」https://docs.cloud.google.com/logging/docs/overview (2026-11-12 に確認)
  2. Google Cloud「gcloud logging read」https://docs.cloud.google.com/sdk/gcloud/reference/logging/read (2026-11-12 に確認)
  3. Google Cloud「Logging query language」https://docs.cloud.google.com/logging/docs/view/logging-query-language (2026-11-12 に確認)
  4. Google Cloud「LogEntry」https://docs.cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry (2026-11-12 に確認)
  5. Google Cloud「Quotas and limits(Cloud Logging)」https://docs.cloud.google.com/logging/quotas (2026-11-12 に確認)
  6. Google Cloud「Logging and viewing logs in Cloud Run」https://docs.cloud.google.com/run/docs/logging (2026-11-12 に確認)
  7. 社の実測 2026-09-25・2026-10-08・2026-10-09・2026-10-14・2026-10-20・2026-10-22