name	12-performance-monitoring
description	性能监控指南，涵盖 Micrometer 指标采集、Prometheus 集成、性能埋点、慢查询监控、JVM 监控。当用户添加性能监控、配置指标采集、分析性能瓶颈或实现可观测性时使用。

性能监控

Name: 12-performance-monitoring
Author: TencentBlueKing

性能监控指南.

触发条件

当用户需要实现方法耗时监控、性能指标采集时，使用此 Skill。

@BkTimed 注解

@Target(AnnotationTarget.FUNCTION)
@Retention(AnnotationRetention.RUNTIME)
annotation class BkTimed(
    val value: String = "",
    val percentiles: DoubleArray = [0.5, 0.9, 0.95, 0.99],
    val histogram: Boolean = false
)

使用示例

@Service
class BuildService {
    
    @BkTimed("build_start_duration")
    fun startBuild(pipelineId: String): BuildId {
        // 自动记录方法执行时间到 Prometheus
        return doBuild(pipelineId)
    }
}

Watcher 耗时监控

class Watcher(
    val id: String,
    private val createTime: Long = System.currentTimeMillis()
) {
    fun start(name: String)
    fun stop()
    fun elapsed(): Long
    fun totalTimeMillis(): Long
}

使用示例

fun processTask(taskId: String) {
    val watcher = Watcher(id = "TASK|Process|$taskId")
    
    try {
        watcher.start("validate")
        validateTask(taskId)
        watcher.stop()
        
        watcher.start("execute")
        executeTask(taskId)
        watcher.stop()
        
        watcher.start("notify")
        notifyResult(taskId)
        watcher.stop()
    } finally {
        watcher.stop()
        LogUtils.printCostTimeWE(watcher = watcher)
    }
}

// 输出: watcher|TASK|Process|xxx|total=150|elapsed=160|validate=20|execute=100|notify=30

日志格式

// 标准格式
watcher|{id}|total={total}|elapsed={elapsed}|{step1}={time1}|{step2}={time2}

// 示例
watcher|ENGINE|BuildStart|b-123|total=150|elapsed=160|init=20|dispatch=100|notify=30

监控指标

指标	说明
`total`	所有步骤耗时总和
`elapsed`	实际经过时间
`{step}`	各步骤耗时

最佳实践

关键路径监控：对核心业务流程添加监控
合理命名：使用 模块|操作|资源ID 格式
finally 释放：确保 watcher 在 finally 中 stop
阈值告警：对超时操作设置告警

12-performance-monitoring

Install Skill

SKILL.md

性能监控

触发条件

@BkTimed 注解

使用示例

Watcher 耗时监控

使用示例

日志格式

监控指标

最佳实践

相关文件