java API接口如何监控

在 Java 里“API 接口监控”通常包含 接口可用性、性能、异常、调用量、业务指标 等维度。下面从 常见方案 → 技术实现 → 生产建议 给你一个系统性的说明。

一、监控什么（监控指标）

对 Java API 接口，一般关注：

1. 接口可用性

   • 是否 200 / 非 2xx 比例
   • 超时率

2. 性能

   • QPS / TPS
   • RT（响应时间）：平均、P95、P99
   • 慢接口（如 > 1s）

3. 异常

   • 异常数
   • 错误码分布
   • 堆栈信息

4. 业务指标

   • 登录数、下单数等
   • 自定义业务埋点

二、常见监控方案（由浅入深）

1️⃣ 日志监控（最基础）

方式

• 在 Controller 打印日志
• 使用 AOP 统一记录

示例（AOP）

@Aspect
@Component
public class ApiMonitorAspect {

    private static final Logger log =
        LoggerFactory.getLogger(ApiMonitorAspect.class);

    @Around("execution(* com.xxx.controller..*(..))")
    public Object monitor(ProceedingJoinPoint pjp) throws Throwable {
        long start = System.currentTimeMillis();
        try {
            return pjp.proceed();
        } finally {
            long cost = System.currentTimeMillis() - start;
            log.info("API={}, cost={}ms",
                pjp.getSignature().getName(), cost);
        }
    }
}

✅ 优点：简单
❌ 缺点：不适合实时告警、聚合分析

2️⃣ Spring Boot Actuator（内置）

依赖

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

常用端点

• /actuator/health
• /actuator/metrics
• /actuator/prometheus

✅ 适合：基础健康检查
❌ 不够细

3️⃣ Micrometer + Prometheus + Grafana（⭐推荐）

架构

Java App → Micrometer → Prometheus → Grafana

依赖

<dependency>
  <groupId>io.micrometer</groupId>
  <artifactId>micrometer-registry-prometheus</artifactId>
</dependency>

配置

management:
  endpoints:
    web:
      exposure:
        include: prometheus
  metrics:
    tags:
      application: api-service

监控内容

• HTTP 请求数
• 响应时间
• JVM
• 线程池

✅ 生产级方案
✅ 支持告警

4️⃣ APM 全链路监控（最强大）

适合中大型系统：

✅ 自动采集接口调用链
✅ 定位慢接口、依赖问题

三、接口级监控示例（Prometheus）

自定义指标

@Autowired
MeterRegistry registry;

public void order() {
    Timer.builder("api.request")
         .tag("api", "order")
         .register(registry)
         .record(() -> {
             // 业务逻辑
         });
}

Grafana 面板指标

• http_server_requests_seconds_count
• http_server_requests_seconds_max
• jvm_memory_used_bytes

四、生产建议（很重要）

✅ 统一入口监控

• Controller 层统一 AOP
• 不要散落在业务代码中

✅ 区分技术监控 & 业务监控

• 技术：RT、错误率
• 业务：下单失败率

✅ 设置告警

• P99 > 1s
• 错误率 > 1%
• 接口 5xx 突增

✅ 避免监控本身影响性能

• 采样
• 异步上报

五、总结选型

如果你愿意，可以告诉我：

• 用的是 Spring Boot / Spring Cloud / 普通 Java
• 是否 微服务
• 是否已有 Prometheus / ELK

我可以直接给你 可落地的配置方案。