Monitoring and inspection

grid follow

Re-attach to a deploy trace and stream progress until it finishes.

grid follow <trace_id>

Argument	Description
trace_id	The deploy trace id (printed by grid plug).

Option	Description
--json	Output the final trace as JSON only (no progress UI).
--verbose	Include technical error details.

grid follow d_abc123def456

grid logs

Stream logs from the entity’s running pods.

grid logs [name]

Argument	Description
name	Entity slug or UUID. Defaults to the linked entity.

Option	Description
--tail <n>	Number of recent lines to show (default: 100).
--follow	Continuously stream logs.
--since <duration>	Show logs since a relative duration (e.g. 5m, 1h, 24h).
--deploy <id>	Show the captured build log for a specific (usually failed) deploy.

grid logs                        # last 100 lines of the linked entity
grid logs my-app --follow        # live tail
grid logs my-app --since 30m     # last 30 minutes
grid logs --deploy d_abc123      # build log for a specific deploy

grid open

Open the entity’s public URL (outlet) in the default browser.

grid open [name]

Option	Description
--print	Print the URL to stdout instead of opening a browser.

grid open my-app
grid open --print

grid info

Show detailed entity metadata: display name, kind, grid, space, owner, created/updated timestamps, last deploy info, and outlet URL.

grid info [name]

Option	Description
--json	Machine-readable JSON output.
-o, --output <format>	Output format: json, yaml, table, csv.

grid versions

List the immutable version snapshots minted on each successful plug.

grid versions [id]

Option	Description
--limit <n>	Maximum number of versions to show.
--json	Machine-readable JSON output.
-o, --output <format>	Output format: table, json, yaml, wide.

Subcommands:

grid versions tag <id> <version_id> <tag>   # set a human label on a version
grid versions pin <id> <version_id>         # pin a version (retention never reclaims it)
grid versions unpin <id> <version_id>       # unpin (normal retention applies)

grid rollback

Roll back to a previous successful deploy. Re-points the running image; env and secrets are unchanged.

grid rollback [name]

Option	Description
--revision <n>	Roll back to a specific revision number. Negative values count backwards (-1 = previous).
--to <version_id>	Roll back to a specific version id.
--yes	Skip the confirmation prompt.

grid rollback my-app --revision -1
grid rollback my-app --to v_abc123 --yes

grid ssh

Open an interactive shell in a running pod (via the API — no local kubectl needed).

grid ssh [name]

Option	Description
--service <name>	Target a specific service (defaults to the first running pod).