TeamCity On-Premises 2024.03 Help

TeamCity 监控与诊断

TeamCity 提供了各种诊断工具和指示器,用于监视和排查服务器。 这些工具使得识别和调查问题变得更容易,如果需要,您可以在您的服务器上报告问题

这篇文章描述了在 Administration | Diagnostics 中可用的诊断工具。 您还可以在本节的嵌套文章中找到更多细节。

故障排查

这个标签页提供了许多指标,帮助您检测和解决 TeamCity 服务器性能的问题。

CPU & 内存使用情况

这个部分显示由 TeamCity 内存监视器 提供的数据,它定期检查可用内存并在 内存消耗 过高时发出警告。 另请参阅有关为 TeamCity 服务器配置 内存设置 的信息。

根据您的操作系统和 Java 设置,下面显示的属性列表可能会有所不同。

CPU 使用率

  • TeamCity 进程的 CPU 使用率显示了主 TeamCity 进程在一段时间内平均使用的 CPU 时间。 占用 CPU 资源的其他进程(数据库,Maven 服务器,VCS)未被包括在内。

  • 垃圾收集显示了在一段时间内平均用于清理服务器内存的时间。 长时间的高数值通常表明服务器内存不足。

  • 系统负载显示根据一段时间内CPU队列长度平均值计算的CPU负载信息,即排队至可用处理器的可运行实体数量与在可用处理器上运行的实体数量的总和,这个总和是基于一段时间(1分钟)的平均值。

  • 总体 CPU 使用率 显示了整个系统最近的 CPU 使用率,值在 [0.0,1.0] 区间内。 0.0 的值意味着在近期的一段时间内,所有 CPU 都处于空闲状态,而 1.0 的值则意味着在近期的一段时间内,所有 CPU 的运行时间都达到了 100%。

内存使用情况

  • 总堆积 显示了 TeamCity 用于存储所有数据(包括即将被收集的临时数据)所使用的总内存量。 代表所有的 Java 堆内存池(新生代和老年代)。 垃圾回收运行迅速且频繁。

  • Data 显示 TeamCity 用于存储持久数据的内存量。 仅在 java 术语中代表旧的生成。 垃圾回收运行缓慢且频率较低。

故障排查

调试日志记录

这允许更改内部 TeamCity 服务器的 日志设置

挂起和线程转储

服务器线程转储可以在浏览器中查看或保存到文件中。

如果您遇到内存问题,此部分提供了一个选项来转储内存快照。

服务器重启

这一部分允许您从用户界面重新启动服务器。

Java 配置

这一部分将告诉您关于安装在您的服务器上的 Java 安装非捆绑版本的 Java 以及已配置的JVM 选项

版本控制系统状态

这个选项卡显示了被监视的 VCS 根的信息,包括它们的更改检查状态和时长。

您可以通过检查更改持续时间来筛选可用的 VCS 根。

指标

TeamCity 提供了可用于监控 TeamCity 服务器健康状况的服务器负载指标。

Metrics选项卡显示所有支持的度量标准,其 tag 参数,以及当前值。

<TeamCity_server_URL>/app/metrics 端点以 Prometheus 格式提供指标,可直接导入到支持 Prometheus 的监控解决方案中(例如,至 Grafana)。 请注意,只有具有 "查看使用统计信息" 权限的用户才能获取服务器指标。

从 TeamCity 2023.05 开始,不再报告 实验性 标签的度量值。 在 Prometheus 格式中,用于度量的 ?experimental=true URL 参数仍然有效,而且一些度量仍然处于实验状态。 如果您发现任何实验性指标有用,并希望它们能升级为受支持的指标,请通过我们的 支持频道 告诉我们。

服务器日志

这个标签页允许您查看和下载可用的 TeamCity 服务器日志,以及保存的线程转储和内存转储。

内部属性

这个标签页显示 TeamCity 服务器内部属性 ,并允许修改它们。

日志预设

TeamCity 使用 log4j 库进行 日志记录 内部服务器活动。 在此部分,您可以查看并下载现有的预设,也可以上传新的预设,然后可以在 Diagnostics | Troubleshooting | Debug Logging 上启用。

也可以更改日志配置 手动

缓存

此选项卡向您展示存储在 <TeamCity 数据目录>/system/caches 中的 TeamCity 进程的缓存。 在清理过程中,服务器会自动进行一些缓存的重置,但有时您可能需要使用重置链接手动清除缓存。

  • vcsContentCache — TeamCity 维护 vcsContentCache 缓存,以优化与 VCS 服务器的通信。 在清理时间期间,缓存会被重置。 为解决源更新问题,可能需要手动重置缓存。

  • 搜索 — 当启用 按构建日志搜索时,需要重置此缓存。

  • git — 包含了 TeamCity 使用的远程 Git 仓库的裸克隆。

  • buildsMetadata — 重置此缓存是必需的,以便 重新索引 TeamCity NuGet 订阅源

版本设置缓存

当您在版本控制系统中保留 TeamCity 项目的设置时,将利用以下缓存。 请查看此文章以获取更多信息:将项目设置存储在版本控制中

  • dslDependenciesMaven 包含了用户在 pom.xml 文件中指定的已下载 Maven 依赖项,该文件是 Kotlin DSL 配置 的一部分。

  • 生成的版本设置 将生成的配置缓存进行存储,以防止过度的 DSL 运行。

  • kotlinDslData 存储与 Kotlin DSL 运行的配置和结果相关的内部数据。 此缓存由 TeamCity 使用,用于维护 Kotlin DSL 配置,例如支持 UI 补丁。

  • pluginsDslCache 包含来自插件的 Kotlin DSL 扩展,比如源码、已编译的 JARs,以及文档。 另外,这个缓存储存了提供 Maven 依赖性的 Maven 仓库。

  • 版本设置 包含已下载的 版本设置.teamcity 文件夹的内容)。

  • versionedSettingsIncrementalMode 支持对 Kotlin DSL 进行增量编译。

显示与 search 相关的 TeamCity 数据索引的信息。

浏览数据目录

这个标签页显示了TeamCity Data Directory中的文件,并允许您上传新的文件。

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