> ## Documentation Index
> Fetch the complete documentation index at: https://docs.molesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 跨信号关联

> 在 RUM、链路、日志、指标、性能剖析、服务与主机之间跳转，同时保留时间上下文。

跨信号关联将稳定标识、组织边界与共享时间窗口组合起来。MoleSignal 在服务器生成目标过滤条件，因此无需在页面之间复制 `trace_id`、服务、主机或会话 ID。

## 关联 API

```http theme={null}
GET /api/v1/web/correlation/{from_kind}/{to_kind}
Authorization: Bearer <jwt>
```

给定起始信号（`from_kind`）与目标信号（`to_kind`），该端点返回带**预填过滤条件**的相关信号 ——
跨信号 join 已自动完成，并限定在所在组织与时间窗口内。

## 可用工作流

* **服务图 + RED 指标**，从追踪派生，可直接渲染为拓扑视图
  （`GET /api/v1/traces/service_graph`）。
* **时间锚点** —— 一次点击即缩放并把时间范围传播到所有面板。
* **调查栈（Investigation stack）** —— 在 `RUM → 链路 → 日志 → 指标 → 性能剖析` 间来回下钻，边走边压栈，
  从不丢失上下文。

## 相关端点

| 端点                                                  | 用途                 |
| --------------------------------------------------- | ------------------ |
| `GET /api/v1/web/correlation/{from_kind}/{to_kind}` | 带预填过滤的服务端跨信号 join  |
| `GET /api/v1/web/trace/{trace_id}`                  | 完整追踪与所有 span       |
| `GET /api/v1/web/topology`                          | 服务拓扑视图             |
| `GET /api/v1/traces/service_graph`                  | 从追踪派生的服务图 + RED 指标 |
| `POST /api/v1/web/investigation/blob`               | 持久化一个调查栈           |

## Web 界面中的调查栈

Web shell 把关联变成一套工作流：

* **⌘K 命令面板** —— 每个流、仪表盘、告警、保存的视图都触手可及。
* **调查栈**（最多 6 帧）—— 每次下钻压一帧；用 `⌘[` 与 `⌘]` 导航；钉住某帧以在探索时保留当前上下文。
* 每个可点击操作都可用键盘到达。

调查栈可以序列化为短期服务器调查 Blob，用于生成可共享 URL。打开该 URL 时，每个引用资源仍需通过正常授权。