← 返回文章列表
使用指南 2 分钟阅读 炬鲸团队

5 分钟接入:Spring Boot 应用日志接入炬鲸 OBSERVE

从零开始,把 Spring Boot 应用的日志、链路追踪接入炬鲸 OBSERVE,只需改一个配置、加一个依赖。

第一步:创建服务

登录炬鲸 OBSERVE 控制台,在「服务管理」里创建一个服务,记下分配给你的接入 Token。

第二步:加依赖

pom.xml 加入 OpenTelemetry 依赖(也可直接用 Logback 的 HTTP Appender 推日志):

<dependency>
  <groupId>io.opentelemetry</groupId>
  <artifactId>opentelemetry-api</artifactId>
  <version>1.30.0</version>
</dependency>

第三步:配置上报地址

application.yml 里配置采集地址和 Token:

observe:
  endpoint: https://ob.example.com
  token: <你的接入Token>
  service-name: order-service

第四步:验证

启动应用,触发几次请求,回到控制台「日志检索」里用类 SQL 查询:

SELECT * FROM logs WHERE service = 'order-service' ORDER BY ts DESC LIMIT 50

能看到最新日志,就说明接入成功。

常见问题

  • 日志没上来:确认 Token 是否正确、网络是否通
  • 时间对不上:检查应用与服务器的时区是否一致
  • 追踪链断了:确认 HTTP 客户端也注入了 trace 上下文