mcloud-logs

Cloud CLI：Logs コマンド

mcloud logs を実行すると、Cloud 環境のバックエンドまたはストアフロントのランタイムログを取得できます。

制約

• --follow と --json は併用できません。プログラムによるログ分析では、--from／--to で時間範囲を指定し、--json を使用してください。
• --follow は中断されるまでログをストリーミングします（Ctrl+C）。スクリプトやパイプラインでは使用しないでください。
• デフォルトでは、過去 15 分間のログのうち最後の 500 行を取得します。

コマンド

mcloud logs \
  --organization <org-id> \
  --project <project-id-or-handle> \
  --environment <environment-handle> \
  [options]

オプション

オプション	説明	デフォルト
-o/--organization <id>	Organization ID	アクティブなコンテキスト
-p/--project <id-or-handle>	プロジェクト ID またはハンドル	アクティブなコンテキスト
-e/--environment <handle>	環境のハンドル	アクティブなコンテキスト
-f/--follow	ログを継続的にストリーミングします（--json と併用不可）	false
--limit <1-5000>	ログの最大行数（--follow を使用しない場合のみ）	500
--from <ISO8601>	時間範囲の開始（例：2026-04-22T10:00:00Z）	15 分前
--to <ISO8601>	時間範囲の終了。15 分より前の時刻を指定する場合は、--from も指定する必要があります	現在
--search <string>	部分文字列で絞り込みます（ダッシュボードの検索バーと同じ）	—
--deployment <id>	デプロイ ID またはビルド ID で絞り込みます	—
--source <string>	ソースで絞り込みます（繰り返し指定可能）	—
--metadata <key=value>	メタデータフィールドで絞り込みます（繰り返し指定可能。同じキーの値は結合されます）	—
--type <backend|storefront>	クエリするログストリーム	backend
--json	JSON 形式で出力します（--follow と併用不可）	false

例

# Basic log fetch (last 500 lines, last 15 min)
mcloud logs --json

# Search for errors
mcloud logs --search error --limit 1000 --json

# Filter for HTTP 500 errors via metadata
mcloud logs --metadata status=500 --limit 1000 --json

# Logs for a specific deployment (build or deployment ID)
mcloud logs --deployment bld_01ABC123 --json

# Structured output for agent analysis
mcloud logs --search error --json | jq '.[] | {timestamp, source, message}'

# Storefront logs
mcloud logs --type storefront --json

# Stream live logs (human-readable, not for scripts)
mcloud logs --follow

# Logs within a specific time range
mcloud logs --from 2026-04-22T10:00:00Z --to 2026-04-22T11:00:00Z --limit 1000 --json

# Logs from a time until now
mcloud logs --from 2026-04-22T10:00:00Z --json

# Multiple source filters
mcloud logs --source api --source worker --json

# Multiple metadata filters (HTTP 4xx and 5xx)
mcloud logs --metadata status=400 --metadata status=500 --limit 500 --json

時間範囲に関する注意

• デフォルトの時間範囲は過去 15 分間です。
• --to を指定せずに --from を指定すると、その時刻から現在までのログを取得します。
• --from を指定せずに --to を指定できるのは、--to が過去 15 分以内の場合のみです。それより前の時刻を指定する場合は、--from も指定してください。
• --from と --to では、どちらも ISO 8601 形式のタイムスタンプを指定できます。