已集成懒猫 oidc 登录。 Traceway 是一个基于 OpenTelemetry 的可观测平台，用来收集和查看应用的链路追踪、日志、指标、异常、接口性能、后台任务、会话以及 AI 调用追踪。部署到懒猫微服后，Traceway 通过懒猫账号授权登录，数据保存在应用私有目录中。 ## 适合用来做什么 - 查看应用接口请求、耗时、错误率和慢请求。 - 收集后端服务的 traces、metrics 和 logs。 - 聚合异常，定位报错发生的接口、任务或用户会话。 - 观察后台任务执行情况。 - 追踪 AI 应用中的模型调用、耗时和上下文。 - 给个人项目、小团队服务或内网应用增加基础可观测能力。 ## 首次打开 1. 打开 Traceway 应用地址。 2. 点击 `Continue with Lazycat`，使用懒猫账号授权登录。 3. 首次进入会要求完成初始化： - `Organization Name`：填写团队或个人名称，例如 `个人`、`lanmao`、`idocker1688`。 - `Timezone`：国内用户建议选择 `Asia/Shanghai`。 - `Project Name`：填写要接入监控的项目名，例如 `traceway`、`blog-api`、`my-app`。 - `Framework`：选择你的应用框架；如果只是通用 OpenTelemetry 接入，优先选择 `OpenTelemetry`，没有该选项时可选实际语言或框架。 4. 点击 `Finish setup` 完成初始化。 ## 接入应用 初始化后，Traceway 会在首页显示 `Connect Your Application` 引导。接入时最重要的是两项： - `OTLP Endpoint` - `Authorization Header` 示例： ```text OTLP Endpoint: https://traceway.<你的懒猫域名>/api/otel Authorization Header: Bearer <你的项目 Token> ``` 注意：项目 Token 等同于写入凭据，不要公开到前端页面、公开仓库或日志中。 ### 推荐接入流程 1. 在 Traceway 左侧进入 `Connection` 页面。 2. 复制 `OTLP Endpoint`，格式通常是： ```text https://traceway.<你的懒猫域名>/api/otel ``` 3. 复制 `Authorization Header`，格式是： ```text Bearer <你的项目 Token> ``` 4. 在业务应用的后端服务中配置 OpenTelemetry OTLP/HTTP exporter。 5. 重启业务应用，然后主动访问几个接口、触发一次错误或执行一个后台任务。 6. 回到 Traceway，刷新 Dashboard 或点击 `Check Again`。 不要把 Traceway 的项目 Token 放进浏览器前端代码。它应该只存在于后端服务、Collector 或服务端环境变量中。