如何使用 docker desktop logs 命令查看 Docker Desktop 日志

简介

在本实验中，你将学习如何高效使用 docker desktop logs 命令来查看和分析 Docker 容器生成的日志。理解容器日志对于调试应用程序和监控其行为至关重要。

这个动手实验将引导你查看基础容器日志，并演示如何根据优先级、时间范围以及生成日志的特定单元（容器或服务）来过滤这些日志。完成本实验后，你将熟练掌握使用 docker desktop logs 命令从容器化应用中获取有价值的信息。

Skills Graph

查看基础 Docker Desktop 日志

在这一步中，你将学习如何查看 Docker 容器的基础日志。日志对于调试和监控运行在容器中的应用程序至关重要。

首先，让我们运行一个简单的容器来生成一些输出。我们将使用 hello-world 镜像，这是一个非常小的镜像，它会打印一条消息然后退出。

docker run hello-world

你应该会看到类似以下的输出，表明 Docker 守护进程已成功拉取镜像并运行容器：

Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
2db29710123e: Pull complete
Digest: sha256:f52335ce493178fc15f729218f180e9988e31c374a6ce98da40cbb890f97f10e
Status: Downloaded newer image for hello-world:latest

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
    (Assuming it was not already locally available.)
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.

To learn more, try the following commands:
 docker run -it ubuntu bash
 docker images
 docker ps
 docker stop <containerid>
 docker rm <containerid>
To get started with Docker Desktop, visit:
 https://www.docker.com/products/docker-desktop

你看到的输出是容器的标准输出（stdout）和标准错误（stderr）流。Docker 会捕获这些流并将其作为日志提供。

现在，让我们运行一个持续运行并随时间生成日志的容器。我们将使用 alpine 镜像，并运行一个简单的命令，每 5 秒打印一条消息。

首先，拉取 alpine 镜像：

docker pull alpine

你应该会看到表明镜像正在被拉取的输出：

Using default tag: latest
latest: Pulling from library/alpine
... (output showing download progress)
Digest: sha256:...
Status: Downloaded newer image for alpine:latest
docker.io/library/alpine:latest

现在，以分离模式（-d）运行 alpine 容器，使其在后台运行，并为其指定一个名称（--name mylogger）以便于引用。命令 while true; do echo "Hello from mylogger at $(date)"; sleep 5; done 会每 5 秒打印一条带有当前日期的消息。

docker run -d --name mylogger alpine sh -c 'while true; do echo "Hello from mylogger at $(date)"; sleep 5; done'

该命令会输出容器的 ID。

要查看运行中容器的日志，使用 docker logs 命令后跟容器名称或 ID。

docker logs mylogger

你将看到容器命令生成的输出，大约每 5 秒会出现一行新日志。你可以按 Ctrl+C 停止查看日志。

要实时跟踪日志，使用 -f（follow）选项：

docker logs -f mylogger

这将持续显示新生成的日志条目。按 Ctrl+C 停止跟踪日志。

最后，让我们停止并移除创建的容器：

docker stop mylogger
docker rm mylogger

这将清理容器资源。

按优先级过滤日志

在这一步中，你将学习如何根据优先级级别过滤 Docker 容器日志。虽然标准的 docker logs 命令不像 systemd-journald 那样内置优先级过滤功能，但你可以使用 grep 等工具在日志输出中搜索特定关键词或模式来实现类似的过滤效果。

让我们使用上一步中的 alpine 容器。如果你已经停止并移除了它，请重新运行：

docker run -d --name mylogger alpine sh -c 'while true; do echo "INFO: Hello from mylogger at $(date)"; sleep 5; echo "WARNING: Something is happening at $(date)"; sleep 5; echo "ERROR: An error occurred at $(date)"; sleep 5; done'

该命令以分离模式运行容器，并每 5 秒打印带有不同"优先级"前缀（INFO、WARNING、ERROR）的消息。

现在，让我们查看日志并过滤只显示包含"ERROR"的行。我们可以将 docker logs 的输出通过管道传递给 grep。

docker logs mylogger | grep "ERROR"

你将只看到容器日志中包含"ERROR"的行。

同样地，查看只包含"WARNING"的行：

docker logs mylogger | grep "WARNING"

查看包含"INFO"的行：

docker logs mylogger | grep "INFO"

你还可以组合过滤器。例如，要查看包含"WARNING"或"ERROR"的行，可以使用 grep 的 -E 选项（扩展正则表达式）和 | 操作符：

docker logs mylogger | grep -E "WARNING|ERROR"

这将显示所有警告或错误的日志条目。

请注意，这种方法依赖于容器应用程序使用特定关键词写入日志。如需更结构化的日志记录和高级过滤功能，建议使用专用的日志驱动或 Docker 外部的日志解决方案。

最后，停止并移除容器：

docker stop mylogger
docker rm mylogger

按时间范围过滤日志

在这一步中，你将学习如何根据特定时间范围过滤 Docker 容器日志。这对于检查特定时间段（例如事件发生期间或特定部署时）的日志非常有用。

docker logs 命令提供了按时间过滤日志的选项。我们将再次使用 alpine 容器。如果容器未运行，请使用之前的命令启动它：

docker run -d --name mylogger alpine sh -c 'while true; do echo "INFO: Hello from mylogger at $(date)"; sleep 5; echo "WARNING: Something is happening at $(date)"; sleep 5; echo "ERROR: An error occurred at $(date)"; sleep 5; done'

让容器运行一两分钟以生成一些日志。

要查看自特定时间以来生成的日志，请使用 --since 选项。时间可以指定为多种格式，包括时间戳（自纪元以来的秒数）、相对时间（例如 10m 表示 10 分钟，1h 表示 1 小时）或日期/时间字符串。

查看过去 2 分钟内生成的日志：

docker logs --since 2m mylogger

此命令将显示 mylogger 容器在过去 2 分钟内生成的所有日志条目。

你还可以使用 --since 和 --until 指定开始和结束时间。--until 选项与 --since 类似，允许你指定要查看日志的截止时间。

查看 5 分钟前到 1 分钟前之间生成的日志：

docker logs --since 5m --until 1m mylogger

此命令将显示指定时间窗口内的日志。请注意，具体输出取决于你运行命令的时间以及容器运行了多长时间。

你也可以使用特定的时间戳。要获取当前时间戳，可以使用 date +%s 命令。

获取 1 分钟前的时间戳：

date -d "1 minute ago" +%s

现在，将此时间戳与 --until 一起使用，查看截至 1 分钟前的日志：

docker logs --until $(date -d "1 minute ago" +%s) mylogger

此命令将显示从容器启动到 1 分钟前的日志。

按时间范围过滤是缩小日志分析范围并专注于相关事件的有效方法。

最后，停止并移除容器：

docker stop mylogger
docker rm mylogger

按单元过滤日志

在本步骤中，你将学习如何按生成日志的"单元"来过滤 Docker 容器日志。在 Docker 日志的上下文中，"单元"通常指的是容器本身。虽然 docker logs 命令本质上就是针对单个容器（或单元）操作的，但理解这个概念对于使用更高级的日志系统或需要区分不同容器日志的场景非常重要。

在 Docker 中按单元过滤日志的主要方式是在使用 docker logs 命令时指定容器名称或 ID。我们在之前的步骤中已经这样操作过。

让我们运行两个不同的容器，观察它们的日志是如何区分的。我们将使用相同的 alpine 镜像，但使用不同的名称和略有差异的命令。

首先，确保之前步骤中的 mylogger 容器已停止并移除：

docker stop mylogger || true
docker rm mylogger || true

现在运行第一个容器，命名为 container1：

docker run -d --name container1 alpine sh -c 'while true; do echo "Container 1 log at $(date)"; sleep 3; done'

该容器每 3 秒会打印一条日志消息。

接着运行第二个容器，命名为 container2：

docker run -d --name container2 alpine sh -c 'while true; do echo "Container 2 log at $(date)"; sleep 5; done'

该容器每 5 秒会打印一条日志消息。

现在，要查看 container1 的专属日志，使用：

docker logs container1

你将只看到 container1 生成的日志消息。

要查看 container2 的专属日志，使用：

docker logs container2

你将只看到 container2 生成的日志消息。

这展示了 docker logs 如何通过指定容器（"单元"）进行固有过滤。如果你使用的是从多个容器收集日志的集中式日志系统，通常会使用与每个日志条目关联的元数据（如容器名称或 ID）来按单元过滤。

虽然 docker logs 本身没有像某些系统日志工具那样的独立 --unit 标志，但通过指定容器名称或 ID，就实现了按日志来源（容器）过滤的基本概念。

最后，停止并移除这两个容器：

docker stop container1 container2
docker rm container1 container2

总结

在本实验中，你掌握了使用 docker logs 命令查看 Docker 容器日志的基础技能。你首先运行了 hello-world 和 alpine 等简单容器，理解了 Docker 如何将标准输出和错误流捕获为日志。这一初始步骤展示了访问容器输出的基本流程，这对于监控和调试容器内运行的应用程序至关重要。

在基础日志查看的基础上，你探索了高级过滤选项来有效管理和分析日志数据。你学会了如何按优先级级别过滤日志，从而专注于关键信息。此外，你还实践了按特定时间范围过滤日志以隔离特定时间段内的事件，以及按单元查看特定服务或组件的日志。这些过滤技术对于处理大量日志数据并快速识别故障排除和分析所需的相关信息至关重要。