Cortex不是微服务框架，而是多租户时序数据库后端；Go微服务需自行构建业务逻辑，通过动态注入tenant_id标签、携带X-Scope-OrgID请求头等方式对接Cortex实现租户隔离。
Cortex 是一个面向 Prometheus 的多租户、水平可扩展的时序数据库后端，主要用于长期存储和查询指标数据，不是微服务框架或服务运行时。它本身不提供服务注册、RPC 通信、API 网关或租户隔离的业务逻辑能力——它只管「存指标、查指标、按租户分片」。
所以，直接「用 Go 开发基于 Cortex 的微服务」这个说法存在根本性误解：你不会把 Cortex 当作微服务的开发框架来用，而是把它当作一个被你的 Go 微服务写入/读取的远程指标后端。真正的微服务仍需你用 net/http、gin、gRPC 或 go-kit 等自行构建，再通过 Prometheus client（如 prometheus/client_golang）对接 Cortex。
为什么不能把 Cortex 当成微服务运行时？
Cortex 是一个无状态/有状态混合的分布式服务（由 ingester、querier、frontend、ruler 等组件构成），它监听 Prometheus remote_write 和 /api/v1/query 请求，不做业务路由、不暴露业务 HTTP handler、不管理服务生命周期。你无法在 Cortex 里注册一个 /users 接口，也无法让它帮你做 JWT 鉴权或租户上下文注入。
Go 微服务如何真正对接 Cortex 实现多租户？
关键不是「基于 Cortex 开发」，而是「让 Go 微服务支持 Cortex 要求的多租户写入与查询」。核心动作有三：
立即学习“go语言免费学习笔记（深入）”；
- 所有指标打标必须带
tenant_id标签（例如http_requests_total{tenant_id="acme", path="/api/users"}），且该标签值由业务请求上下文提取（如从 JWT claim 或 HTTP header 中解析） - 使用
prometheus/client_golang注册指标时，**不硬编码 tenant_id**，而是在prometheus.Labels中动态注入；更稳妥的做法是用prometheus.NewRegistry()+prometheus.WrapRegistererWithPrefix或prometheus.WrapRegistererWith绑定租户上下文 - remote_write 配置中必须启用
basic_auth或bearer_token，并确保 Cortex 配置了-auth.enabled=true和对应租户映射（如通过-auth.tenant-header=X-Scope-OrgID）
Go 服务里怎么安全传递 tenant_id 到指标采集链路？
常见错误是：在 handler 里解析出 tenant_id，但没透传到 metrics collector，导致所有指标都打到 default tenant。正确做法是利用 context.Context 携带租户信息，并让 metrics registry 或 instrumented client 感知它：
- 在中间件中从 request 提取
X-Scope-OrgID，写入 context：ctx = context.WithValue(r.Context(), tenantKey, orgID) - 定义租户感知的 Counter：用
promauto.With(prometheus.WrapRegistererWith(prometheus.Labels{"tenant_id": orgID}, r)).NewCounter(...)，注意r是 per-tenant registry - 避免全局
prometheus.DefaultRegisterer—— 它无法区分租户，会污染所有指标
查指标时如何保证租户隔离不越界？
Cortex 本身靠 X-Scope-OrgID header 过滤查询范围，但 Go 服务调用 /api/v1/query 时若漏传该 header，就会查到其他租户数据（或 401/403）。实操要点：
- 所有对 Cortex Query API 的 HTTP 请求，必须显式设置 header：
req.Header.Set("X-Scope-OrgID", tenantID) - 不要复用同一 http.Client 实例跨租户请求 —— 可能因连接复用导致 header 被覆盖
- 如果用
prometheus/apiclient，需手动 patchapiclient.Do或封装DoWithContext注入 header
租户隔离的真正复杂点不在代码行数，而在「指标打标时机」和「HTTP header 注入路径」是否全程一致 —— 少一个环节，就可能造成租户数据混杂，且问题难以复现。
