VMware Cloud Director 具有不同的日志记录级别。如果环境比较繁忙,或者要在故障排除时捕获事件,默认日志记录配置可能无法满足要求。您可能需要更改日志记录级别,甚至更改保留的文件大小和数量。

重要说明: 在没有 VMware 全球支持团队指导的情况下更改日志配置时,请确认您了解这样做会对 VMware Cloud Director 服务器组产生什么样的后果。如果将日志记录级别更改为更详细的级别,日志可能会开始快速扩展,而 VMware Cloud Director 环境可能会耗尽磁盘空间。

VMware Cloud Director 日志位于 /opt/vmware/vcloud-director/logs/ 目录中。

VMware Cloud Director 日志配置文件位于 /opt/vmware/vcloud-director/etc/ 目录中。日志配置文件的名称为 log4j.properties

如果您要自定义 log4j.properties 日志配置文件,则必须在 VMware Cloud Director 升级之前创建 log4j.properties 的副本,并在升级后手动插入任何缺少的部分。

要改进日志保留设置并确保 VMware Cloud Director 日志保留一段时间,请考虑使用 syslog 服务器。

表 1. 日志记录级别
日志记录级别 描述
FATAL 此级别会记录可能导致应用程序失败的非常严重的错误事件。
ERROR 此级别会记录可能仍允许应用程序继续运行的错误事件。
WARN 此级别会记录可能有害的情况和警告。
INFO 此级别会记录以粗粒度突出显示应用程序进度的信息性消息。
DEBUG 此级别会记录最有助于以细粒度调试应用程序的信息性事件。
TRACE 此级别比 DEBUG 级别日志记录所记录的信息性事件粒度更精细。

前提条件

创建 /opt/vmware/vcloud-director/etc/log4j.properties 文件的备份副本。

请斟酌:

过程

  1. root 身份直接或通过 SSH 客户端登录到 VMware Cloud Director 控制台。
  2. 在文本编辑器中打开 /opt/vmware/vcloud-director/etc/log4j.properties 文件。
  3. 找到要更新的日志文件定义。
    log4j.appender.Feature.File=logs/File_Name
    例如,您可能希望更改 # Component appender for container debug 部分的日志记录级别。该部分的最后一行用于配置此文件捕获的日志记录级别。
  4. 将日志记录级别设置为所需的值。
    重要说明: 在没有 VMware 全球支持团队指导的情况下更改日志配置时,请确认您了解这样做会对 VMware Cloud Director 服务器组产生什么样的后果。
    TRACE 级别的详细程度最高, FATAL 级别的详细程度最低。以下示例会更改该行以匹配最详细级别。
    log4j.appender.vcloud.system.debug.threshold=TRACE
  5. 如果将录制更改为更详细级别,您可能需要增加日志备份的数量和日志文件的大小。
    1. 找到 MaxFileSizeMaxBackupIndex 行。
      log4j.appender.vcloud.system.debug.MaxFileSize=
      log4j.appender.vcloud.system.debug.MaxBackupIndex=
    2. 更改默认设置。
      例如,如果希望日志文件在扩展至 50 MB 之后滚动更新并保留最后 18 个日志,请按如下所示更改这两行。
      log4j.appender.vcloud.system.debug.MaxFileSize=50000KB
      log4j.appender.vcloud.system.debug.MaxBackupIndex=18
      当文件达到所选的 50 MB 大小后, VMware Cloud Director 会继续将数据写入一个新文件中,并保留最多 18 个备份。
    重要说明: 如果将日志记录级别更改为更详细的级别,日志可能会开始快速扩展,而 VMware Cloud Director 环境可能会耗尽磁盘空间。
  6. 保存 /opt/vmware/vcloud-director/etc/log4j.properties 文件。
    VMware Cloud Director 会立即应用所做更改。 Log4J.properties 文件中没有明确用于更改 VMware Cloud Director 保留的日志大小和数量的行。