Swarm 集群  日志管理  集成日志服务

日志服务（Log Service，简称Log）是针对日志场景的平台化服务。无需开发就可以快速完成日志收集、分发、投递与查询， 适用于日志中转、监控、性能诊断、日志分析、审计等场景。容器服务提供了集成日志服务的能力，可以方便地将应用日志发送到日志服务里。
    Note
在集群管理页，只要单击开启日志服务 > 确定，日志服务成功开启之后，通过内置的 RAM 账户，会为每个自动创建的 Logstore 创建日志索引，由于阿里云日志服务已经开始收费，因此启用本功能之后，按照下面的方式进行配置，将会产生计费，收费标准参见计费方式。请务必了解您的日志量，以免产生大量非预期的费用。




开启日志服务

1. 登录 容器服务管理控制台。
2. 在 Swarm 菜单下，单击左侧导航栏中的集群。
3. 选择目标集群并单击管理。
4. 单击页面右上角的开启日志服务。
5. 在弹出的确认对话框中，单击确定。
   开通容器服务的日志服务之前，您需要先开通阿里云访问控制（RAM）和阿里云日志服务。如果您还未开通，请单击 去开通开通访问控制（RAM）和阿里云日志服务。

查看 acslogging 服务安装结果


第一次启用日志服务时，容器服务会在您的机器安装日志服务所需的 Agent。您可以在应用列表中找到该应用。安装成功后，您就可以使用日志服务了。

1. 登录 容器服务管理控制台。
2. 单击左侧导航栏中的应用。
3. 选择目标集群并取消勾选隐藏系统应用。
   可以看到 acslogging 应用已安装成功。

同时，系统会在阿里云日志服务上创建一个对应的 project，您可以在日志服务管理控制台上进行查看。project 的名字里包含了容器服务集群的 ID。



在编排文件里使用日志服务


大多数的 Docker 应用会直接将日志写到 Stdout，现在您依然可以这样做（对于日志写到文件的场景，可以参考下边的 使用文件日志）。在开通日志管理功能后，Stdout 的日志可以自动收集并且发送到阿里云日志服务。下面的例子创建了一个 WordPress 应用。该应用包含 WordPress 和 MySQL 两个服务，日志会收集到阿里云日志服务。
MySQL image: mysql
ports:
    - 80
labels:
    aliyun.scale: "1"
environment:
    - MYSQL_ROOT_PASSWORD=password
WordPress
image: registry.aliyuncs.com/jiangjizhong/wordpress
ports:
   - 80
labels:
   aliyun.routing.port_80: wordpress-with-log
   aliyun.log_store_dbstdout: stdout  # 采集stdout日志到dbstdout日志库中
   aliyun.log_ttl_dbstdout: 30  # 设置dbstdout日志库日志数据保存30天
links:
    - mysql在上边的编排文件中

• aliyun.log_store_dbstdout: stdout 表示将容器的标准写入 logstore acslog-wordpress-dbstdout里。这个标签的格式为 aliyun.log_store_{name}: {logpath}。其中：name 为阿里云日志服务 logstore 的名字，实际创建的 logstore 的名字为acslog-${app}-${name}。
• app 为应用名称。
• logpath为容器中日志的路径。
• stdout 是一个特殊的 logpath，表示标准输出。

aliyun.log_ttl_<logstore_name> 标签用来设置日志库初始日志保存时间，单位为天，有效值为 1~365 天，不配置则默认初始化为 2 天。
  Note 这里设置的是初始配置值，如果后期您需要修改日志保存时间，需要到日志服务控制台进行设置。
用上面的编排文件，您可以在容器服务管理控制台上创建一个名为 wordpress 的应用。在应用启动完成后，可以在阿里云日志管理控制台上找到 logstore acslog-wordpress-dbstdout，其中存储了 wordpress 的日志。



在日志服务管理控制台上查看日志

使用上面的编排文件部署应用之后，您可以在阿里云日志服务控制台查看收集到的日志。登录日志服务管理控制台，找到集群对应的日志服务 project，单击进入。您可以看到编排文件里使用的 logstore acs-wordpress-dbstdout。 在 日志索引列中单击 查询查看日志。


使用文件日志

如果您不希望日志直接写到 stdout 中，而需要将日志直接写到文件中，比如 /var/log/app.log，可以进行如下配置。 aliyun.log_store_name: /var/log/app.log   其中name为 logstore 的名字，/var/log/app.log为容器内日志的路径。
如果您需要输出多个日志文件到日志服务，可以进行如下配置将文件放在多个目录下。 aliyun.log_store_s1: /data/logs/access/access.log
aliyun.log_store_s2: /data/logs/error/error.log
aliyun.log_store_s3: /data/logs/exception/*.log  #支持通配符  
Note 暂不支持多个logstore对应同一个日志目录。上面的例子中有 3 个 logstore s1、s2 和 s3，对应的日志文件必须在 3 个目录下。


开启 timestamp

Docker 在收集日志的时候可以选择是否添加 timestamp。您可以在容器服务中通过aliyun.log.timestamp 标签进行配置。默认会添加 timestamp。

• 添加 timestampaliyun.log.timestamp: "true"
• 去除 timestampaliyun.log.timestamp: "false"