「Allen 谈 Docker 系列」之 docker logs 实现剖析

【Allen 谈 Docker 系列】DaoCloud 正在启动 Docker 技术系列文章,每周都会为大家推送一期真材实料的精选 Docker 文章。主讲人为 DaoCloud 核心开发团队成员 Allen 孙宏亮,他是 InfoQ《Docker源码分析》专栏作者,即将出版《Docker源码分析》一书。Allen 接触 Docker 近两年,爱钻研系统实现原理,及 Linux 操作系统。

Docker完全可以轻易构建用户的应用,即为 build;

Docker还可以将应用快速分发,即为 ship;

最后,Docker依然有能力秒级启动应用,即为 run。

Build,Ship,Run,简单的3步,分分钟为 DevOps 创建了管理应用生命周期的捷径。

应用是运行起来了,应用运行后,运行状态相信是工程师最关心的点。这一点,Docker如何帮工程师排忧解难呢?

想知道应用是否仍在运行?「docker ps」会告诉您。

想获知应用的资源使用情况如何?「docker stats」为您呈现。

想了解应用的运行日志?「docker logs」绝对是您最好的选择。

如今,Docker 容器应用的日志分析,已经是一个获悉应用运行逻辑的状态,以及分析应用运行性能的不二法宝。

基于 Docker 容器的日志,已然有很多人在做;那大家是否了解 Docker 容器的日志是怎么来的呢?如果大家还不清楚 Docker 日志的实现原理,那么本文可以带您窥探 docker logs 的究竟。

1. Docker容器应用如何产生日志?

大家可以试想一下,如果没有 Docker,您的应用如何打印日志?普遍情况有以下两种:

第一,向标准输出(stdout)中打印日志;第二,设置日志文件 app.log(或其它文件名),向此文件中打印日志。

Docker 从诞生伊始,就从未对用户应用做出标准性规范,日志也不例外,从未有过限制。既然如此,Docker容器应用的日志也不外乎以上两种。第二种很好理解,依然往容器中某个日志文件打印;然而第一种,应用通过标准输出(stdout)的方式打印日志,该如何呈现给用户?

2. Docker容器应用的日志实现

对于日志文件,Docker 不可能也不应该深入应用内部逻辑,截获并接管日志文件内容,这只会破坏 Docker 的通用性。但是对于 Docker 容器内应用的标准输出,Docker 则是做了工作的。具体实现,可以参考下图:


假设 application 是 Docker 容器内部运行的应用,那么对于应用的第一部分标准输出(stdout)日志,Docker Daemon 在运行这个容器时就会创建一个协程(goroutine),负责标准输出日志。

由于此 goroutine 绑定了整个容器内所有进程的标准输出文件描述符,因此容器内应用的所有标准输出日志,都会被 goroutine 接收。goroutine 接收到容器的标准输出内容时,立即将这部分内容,写入与此容器—对应的日志文件中,日志文件位于/var/lib/docker/containers/<container_id>,文件名为<container_id>-json.log。至此,关于容器内应用的所有标准输出日志信息,已经全部被 Docker Daemon 接管,并重定向到与容器—对应的日志文件中。

3. 用户如何查看容器日志?

日志总是需要被用户查看的,Docker 则通过 docker logs 命令向用户提供日志接口。docker logs 实现原理的本质均基于与容器一一对应的 <container-id>-json.log,除了 docker logs -f 命令。

以下简要介绍 docker logs 命令下各参数的含义:

  • 无参数:直接显示容器的所有日志信息
  • tail:从尾部开始按需显示容器日志
  • since:从某个时间开始显示容器日志
  • timestamp:显示容器日志时显示日志时间戳
  • f:将当前时间点,容器日志文件<container-id>-json.log中的日志信息全部打印;此时间点之后所有的日志信息与日志文件无关,直接接收goroutine往日志文件中写的文件描述符,并显示

总而言之,Docker 容器日志的处理并不会很复杂。此文阅完,日志的来龙去脉,一清二楚。

当然,您也可以做两个实验检验以上内容:

  • Experiement 1:通过Docker运行一个应用,日志会从标准输出打印日志,然后通过docker logs查看日志
  • Experiement 2:运行一个Docker容器,随后docker exec命令进入这个容器,接着通过echo、cat等命令向容器的标准输出中打印内容,最后通过docker logs查看日志

实验是检验真理的唯一标准。您会发现,Experiement 1 中,查看日志会有日志;而Experiement 2 中却找不到 echo、cat 等命令标准输出的日志内容。

Experiement 2 做完,瞬间毁三观,难道以上内容有差错?可以明确告诉您没有,那矛盾如何会存在?

欲知后事如何,且听下回分解。

 

Leave a Reply

Your email address will not be published. Required fields are marked *