NAME 名称

podman-pod-logs - Display logs for pod with one or more containers
podman-pod-logs - 显示一个或多个容器的 pod 的日志

SYNOPSIS 概要

podman pod logs [options] pod
podman pod logs [选项] pod

DESCRIPTION 描述

The podman pod logs command batch-retrieves whatever logs are present with all the containers of a pod. Pod logs can be filtered by container name or ID using flag -c or --container if needed.
podman pod logs 命令批量检索 pod 的所有容器中存在的日志。如果需要,可以使用 -c 或 --container 标志按容器名称或 ID 进行过滤。

Note: A long-running podman pod log command with a -f or --follow option needs to be reinvoked if a new container is added to the pod dynamically; otherwise, logs of newly added containers are not visible in the log stream.
注意:使用带有 podman pod log-f 选项的长时间运行的命令,如果动态向 pod 添加新容器,则需要重新调用;否则,新添加的容器的日志在日志流中不可见。

OPTIONS 选项

--color

Output the containers with different colors in the log.
在日志中使用不同颜色输出容器。

--container, -c

By default, podman pod logs retrieves logs for all the containers available within the pod, differentiated by the field container. However, there are use cases where the user wants to limit the log stream only to a particular container of a pod. For such cases, -c can be used like podman pod logs -c ctrNameorID podname.
默认情况下, podman pod logs 检索 pod 中所有可用容器的日志,通过字段 container 进行区分。然而,有些情况下用户希望将日志流限制在 pod 的特定容器中。对于这种情况,可以像 podman pod logs -c ctrNameorID podname 这样使用 -c

--follow, -f

Follow log output. Default is false.
跟踪日志输出。默认值为 false。

Note: When following a pod which is removed by podman pod rm or removed on exit (podman run --rm ...), there is a chance that the log file is removed before podman pod logs reads the final content.
注意: 当跟踪一个由 podman pod rm 删除或在退出时删除的 pod ( podman run --rm ... ) 时,有可能日志文件在 podman pod logs 读取最终内容之前被删除。

--latest, -l

Instead of providing the pod name or ID, use the last created pod. Note: the last started pod can be from other users of Podman on the host machine. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
而不是提供 Pod 名称或 ID,请使用最后创建的 Pod。注意:最后启动的 Pod 可能来自主机上其他 Podman 用户。(此选项不适用于远程 Podman 客户端,包括 Mac 和 Windows(不包括 WSL2)机器)

--names, -n --名称, -n ¶

Output the container names instead of the container IDs in the log.
在日志中输出容器名称而不是容器 ID。

--since=TIMESTAMP --自指定时间戳开始=时间戳 ¶

Show logs since TIMESTAMP. The --since option can be Unix timestamps, date formatted timestamps, or Go duration strings (e.g. 10m, 1h30m) computed relative to the client machine’s time. Supported formats for date formatted time stamps include RFC3339Nano, RFC3339, 2006-01-02T15:04:05, 2006-01-02T15:04:05.999999999, 2006-01-02Z07:00, and 2006-01-02.
从时间戳开始显示日志。--since 选项可以是 Unix 时间戳、日期格式化的时间戳,或相对于客户端机器时间计算的 Go 时长字符串(例如 10m、1h30m)。支持的日期格式化时间戳格式包括 RFC3339Nano、RFC3339、2006-01-02T15:04:05、2006-01-02T15:04:05.999999999、2006-01-02Z07:00 和 2006-01-02。

--tail=LINES

Output the specified number of LINES at the end of the logs. LINES must be an integer. Defaults to -1, which prints all lines
在日志末尾输出指定数量的行数。LINES 必须是整数。默认为 -1,表示打印所有行。

--timestamps, -t --时间戳, -t ¶

Show timestamps in the log outputs. The default is false
在日志输出中显示时间戳。默认值为 false

--until=TIMESTAMP --直到=时间戳 ¶

Show logs until TIMESTAMP. The --until option can be Unix timestamps, date formatted timestamps, or Go duration strings (e.g. 10m, 1h30m) computed relative to the client machine’s time. Supported formats for date formatted time stamps include RFC3339Nano, RFC3339, 2006-01-02T15:04:05, 2006-01-02T15:04:05.999999999, 2006-01-02Z07:00, and 2006-01-02.
显示日志直到时间戳。--until 选项可以是 Unix 时间戳、日期格式化的时间戳,或相对于客户端机器时间计算的 Go 时长字符串(例如 10m、1h30m)。支持的日期格式化时间戳格式包括 RFC3339Nano、RFC3339、2006-01-02T15:04:05、2006-01-02T15:04:05.999999999、2006-01-02Z07:00 和 2006-01-02。

EXAMPLE 例子 ¶

To view a pod’s logs:
查看 pod 的日志:

podman pod logs -t podIdorName

To view logs of a specific container on the pod:
查看 pod 上特定容器的日志:

podman pod logs -c ctrIdOrName podIdOrName

To view all pod logs:
查看所有 Pod 日志:

podman pod logs -t --since 0 myserver-pod-1

To view a pod’s logs since a certain time:
查看自特定时间以来 Pod 的日志:

podman pod logs -t --since 2017-08-07T10:10:09.055837383-04:00 myserver-pod-1

To view a pod’s logs generated in the last 10 minutes:
查看在过去 10 分钟内生成的 Pod 日志:

podman pod logs --since 10m myserver-pod-1

To view a pod’s logs until 30 minutes ago:
查看 30 分钟前的 pod 日志:

podman pod logs --until 30m myserver-pod-1

SEE ALSO 参见 ¶

podman(1), podman-pod(1), podman-pod-rm(1), podman-logs(1)