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)。上の記録を踏まえ、席は次の順で数えます。
- 時刻の窓を決める:deploy の時刻から先を窓にし、比べる対照(前の revision など)も同じ幅の窓で取る。
- 広く取る:resource.type・service_name・timestamp だけで取り、要求・5xx・ERROR は手元で選ぶ(社の実測 2026-10-09)。
- ロガーの出し方に合わせて数える:severity が付かない文字の行なら、文字の検索で数える。
- 陽性対照を入れる:わざと起こした警告や、当たるはずの info の行が拾えるかを先に見る。拾えなければその数は使わない。
- 直列に撃つ:本番のプロジェクトの読み取りは並列にしない(社の実測 2026-10-14)。
- 落ちたら止める: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)。
出典
- Google Cloud「Cloud Logging overview」https://docs.cloud.google.com/logging/docs/overview (2026-11-12 に確認)
- Google Cloud「gcloud logging read」https://docs.cloud.google.com/sdk/gcloud/reference/logging/read (2026-11-12 に確認)
- Google Cloud「Logging query language」https://docs.cloud.google.com/logging/docs/view/logging-query-language (2026-11-12 に確認)
- Google Cloud「LogEntry」https://docs.cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry (2026-11-12 に確認)
- Google Cloud「Quotas and limits(Cloud Logging)」https://docs.cloud.google.com/logging/quotas (2026-11-12 に確認)
- Google Cloud「Logging and viewing logs in Cloud Run」https://docs.cloud.google.com/run/docs/logging (2026-11-12 に確認)
- 社の実測 2026-09-25・2026-10-08・2026-10-09・2026-10-14・2026-10-20・2026-10-22