查看构建代理日志

为了分析特定于代理的情况，TeamCity 代理进程将内部日志文件保存在代理机器的 <TeamCity 代理安装目录>/logs 目录中。

当代理连接到 TeamCity 服务器时，您可以在 TeamCity 网页用户界面的 代理日志 标签页中，浏览并下载 代理日志。

如果您需要自定义日志记录，请参见下文。

日志文件

TeamCity 使用 Log4j 2.x 来进行内部事件的记录。默认的构建代理 Log4j 配置文件是 <agent home>/conf/teamcity-agent-log4j2.xml。

请查看 Log4j 配置文件中的注释，以启用 DEBUG 模式。构建代理日志被放置在 <代理主目录>/logs 目录中。通常，您无需重启代理以应用更新的日志配置。

文件名	描述
`teamcity-agent.log`	一般构建代理日志
`teamcity-build.log`	`stdout` 和 `stderr` 是由代理运行的构建的输出
`teamcity-vcs.log`	与 VCS 相关的记录（用于 "自动在代理上" 的签出模式）
`upgrade.log`	构建代理升级的日志（由升级过程记录）
`launcher.log`	代理的监控/启动进程日志
`wrapper.log`	（仅当代理作为Windows服务或通过Java Service Wrapper运行时存在）进程构建代理启动过程的输出

要在代理上启用常规调试日志记录，请更改 jetbrains.buildServer 类别在 <agent home>/conf/teamcity-agent-log4j2.xml 文件中的日志记录优先级：

<Logger name="jetbrains.buildServer" level="DEBUG">
    <AppenderRef ref="ROLL"/>
</Logger>

如果您正在使用的是 TeamCity 版本 < 2022.04，那么应在 <agent home>/conf/teamcity-agent-log4j.xml 文件中进行以下替换：

<category name="jetbrains.buildServer">
    <priority value="DEBUG"/>
    <appender-ref ref="ROLL"/>
</category>

然后，查看 teamcity-agent.log* 文件。

要在代理上启用详细的 VCS 记录功能，需要在 <agent home>/conf/teamcity-agent-log4j2.xml 文件中改变 VCS 类别记录的优先级：

<Logger name="jetbrains.buildServer.VCS" level="DEBUG">
    <AppenderRef ref="ROLL.VCS"/>
</Logger>

如果您正在使用的是 TeamCity 版本 < 2022.04，那么应在 <agent home>/conf/teamcity-agent-log4j.xml 文件中进行以下替换：

<category name="jetbrains.buildServer.VCS">
    <priority value="DEBUG"/>
    <appender-ref ref="ROLL.VCS"/>
</category>

然后，查看 teamcity-vcs.log* 文件。

要获取代理向服务器发送的数据的转储，请启用代理 XML-RPC 日志，即通过取消下面的 <agent home>/conf/teamcity-agent-log4j2.xml 文件中的注释行。

<Logger name="jetbrains.buildServer.XMLRPC" level="DEBUG">
    <AppenderRef ref="ROLL.XMLRPC"/>
</Logger>

如果您正在使用的是 TeamCity 版本 < 2022.04，那么应在 <agent home>/conf/teamcity-agent-log4j.xml 文件中进行以下替换。

<category name="jetbrains.buildServer.XMLRPC">
    <priority value="DEBUG"/>
    <appender-ref ref="ROLL.XMLRPC"/>
</category>

然后，查看 teamcity-xmlrpc.log。

您可以通过更改 teamcity_logs 属性的值（通过 -D 选项传递给 JVM）来配置日志的位置。您也可以通过更改 log4j2.configuration 属性的值来更改 Log4j 配置文件的位置。参见相应的文档部分，了解如何传递选项。

要获取更多关于调整日志记录的选项，请参考 TeamCity 服务器日志页面。

最后修改日期： 16日 7月 2024年