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

前提条件

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

请斟酌：

过程

  1. 以 root 身份直接或通过 SSH 客户端登录到 VMware Cloud Director 控制台。
  2. 在文本编辑器中打开 /opt/vmware/vcloud-director/etc/log4j.properties 文件。
  3. 找到 Default vCloud loggers 部分，然后修改日志记录器的日志级别。
    以下示例显示了日志级别设置为最详细级别。 
    log4j.logger.com.vmware.vcloud=TRACE 
log4j.logger.com.vmware.ssdc=TRACE
  4. 找到要更新的日志文件定义。 
    log4j.appender.Feature.File=logs/File_Name
    例如，您可能希望更改 # Component appender for container debug 部分的日志记录级别。该部分的最后一行用于配置此文件捕获的日志记录级别。
  5. 将日志记录级别设置为所需的值。
    重要说明： 在没有 VMware 全球支持团队指导的情况下更改日志配置时，请确认您了解这样做会对 VMware Cloud Director 服务器组产生什么样的后果。
    以下示例会更改该行以匹配最详细级别。 
    log4j.appender.vcloud.system.debug.threshold=TRACE
  6. 如果将录制更改为更详细级别，您可能需要增加日志备份的数量和日志文件的大小。
    1. 找到 MaxFileSize 和 MaxBackupIndex 行。 
      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 环境可能会耗尽磁盘空间。
  7. 保存 /opt/vmware/vcloud-director/etc/log4j.properties 文件。
    VMware Cloud Director 会立即应用所做更改。 Log4J.properties 文件中没有明确用于更改 VMware Cloud Director 保留的日志大小和数量的行。

控制 VMware Cloud Director 中的 API 请求日志记录

可以控制在 VMware Cloud Director 中捕获和存储入站请求相关信息的过程。

VMware Cloud Director 将 VMware Cloud Director 单元的入站请求记录在请求日志中。这些日志的名称格式为 YYYY_MM_DD.request.log。可以在 /opt/vmware/vcloud-director/logs/ 目录中找到 VMware Cloud Director request.log 文件，但无法通过 log4j.properties 文件配置日志。

可以使用命令行工具的 manage-config 子命令控制 API 请求日志记录。manage-config 子命令会更改整个服务器组的设置。有关 manage-config 子命令选项和参数的详细信息，请参见在 VMware Cloud Director 中更新应用程序配置设置。

日志轮换最多每天进行一次，且无关各个日志文件的大小或所有日志文件的总大小。可以通过更改 VMware Cloud Director 保留日志的天数来控制轮换策略。

过程

  1. 以 root 身份直接或通过 SSH 客户端登录到 VMware Cloud Director 单元的操作系统。
  2. 如果要更改请求日志的保留策略，请使用单元管理工具的 manage-config 子命令。
    保留策略值表示 VMware Cloud Director 保留符合美国国家超级计算技术应用中心 (NCSA) 要求的请求日志的天数。默认值为 0，其中 0 表示永久。删除该值也会永久保留日志。保留日志的最短时间为 1 天。 
    /opt/vmware/vcloud-director/bin/cell-management-tool manage-config --name "vcloud.http.log.retainDays" --value New_Value
  3. 要使更改生效，必须重新启动单元。
    重新启动单元后，它将开始使用更新的值。可以一次重新启动部分或全部单元。