[新版解密] 活字格8.0 update1新功能解密：三十一、活字格服务端日志增强

注：日志文件中的时间为标准格林尼治时间（GMT），加上 8 小时就是北京时间（GMT+8）。

2.3. 日志文件管理策略

在日志文件的存放位置 ForguncyWebServerLogs 这层目录下，不同应用的日志文件会以应用名分开存放，如下所示：

图中的 log-example 就是发布的应用名称，而 Forguncy.UserService2 文件夹下存放的是活字格服务器管理控制台的运行日志。

每天都会滚动生成新的日志文件，并以 [应用名称][日期].log 的格式进行命名。

• 如果当日单个日志文件大小超过了单个文件大小限制（FileSizeLimitMBytes），会滚动生成多个日志文件，并以下面规则命名：
  

        [APPLICATION NAME][YYYYMMDD]_001.log
        [APPLICATION NAME][YYYYMMDD]_002.log
        …

• 如果总的日志文件数量超过了最大保留日志文件个数限制（RetainedFileCountLimit），会删除最旧的日志文件。
• 如果日志文件的创建时间超过了最长保留天数限制（RetainedFileDaysLimit），其也会被删除。
  

单个文件大小限制（FileSizeLimitMBytes）、最大保留日志文件个数限制（RetainedFileCountLimit）、最长保留天数限制（RetainedFileDaysLimit） 这三个日志管理策略参数都可以通过修改本地日志配置文件或在服务器管理控制台进行配置。

2.4. 日志配置文件

对于上述提到的日志策略可以在日志配置文件中进行配置。

• 发布应用的配置文件在：C:\Users\Public\Documents\ForguncyServer\[ApplicationName]\logConfig.json；
• 活字格服务器管理控制台的配置文件在：[活字格服务器安装根目录]\Forguncy.UserService2\logConfig.json。
  

配置文件部分内容如下所示：

用户可以修改日志配置文件的内容来控制日志记录行为，这里只列出部分配置内容，关于日志模块的配置项会在下篇日志模块进行介绍。

三、日志在线配置和查看

3.1. 在线配置

服务端日志的配置配置除了在配置文件上修改外，还可以在服务器管理控制台通过图形界面修改。

用户登录活字格服务器管理控制台后，在控制台的设置/日志/日志设置模块进行日志配置，如下图所示：

• 选择要进行日志配置的应用；
• 修改最大保留日志文件个数；
• 修改最长保留天数；
• 修改单个日志文件大小限制；
• 选择要配置的日志模块，不同的模块会有不同的配置项；
• 可以选择开启或者关闭某个模块日志；
• 可以开启或关闭模块日志的属性；
• 配置要排除或包含的关键字。
  

修改完配置后记得点击保存按钮，保存日志配置，单击保存后，新配置将立即生效，无需重新启动应用程序或服务器。

3.2. 在线查看

除了在控制台配置日志记录策略外，还可以在控制台的设置/日志/历史日志模块在线查看日志：

• 选择要查看日志的日期；
• 选择要查看日志在选择日期当天的时间段；
• 选择查看日志的应用（可多选）；
• 可以按照日志生成时间进行排序；
• 过滤要查看的日志模块；
• 过滤要查看的日志级别；
• 查看日志详情。
  

好了，这里介绍了 8.0 update1 版本中活字格服务端的配置（本地和在线配置）和在线查看，下篇会对每个日志模块和模块一些属性进行介绍。