> ## Documentation Index
> Fetch the complete documentation index at: https://arka-agent-mintlify-f21cea86.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenTelemetry 追踪和 SigNoz 可观测性

> 启用 Arka 的 OpenTelemetry 追踪、指标和日志，并将其发送到 SigNoz，以监控 LLM 提供商调用、故障转移事件、延迟和令牌用量。

启用后可将追踪、指标和日志导出到 [SigNoz](https://signoz.io)。**默认开启**，本地 OTLP 端点为 `http://127.0.0.1:4318`。

## 快速开始

```bash theme={null}
arka signoz status
arka signoz setup -y
arka signoz demo
arka ai trace-status
arka observability doctor
```

## 配置

```env theme={null}
# 默认开启 — 仅在需要时覆盖
SIGNOZ_ENDPOINT=http://localhost:4318
SIGNOZ_UI_URL=http://localhost:8080
OTEL_SERVICE_NAME=arka
# OTEL_SDK_DISABLED=true          # 关闭所有 OTLP 导出
# OTEL_TRACES_ENABLED=0           # 关闭追踪（指标/日志跟随追踪）
# SIGNOZ_API_KEY=               # 用于告警 / MCP
```

## 追踪内容

* LLM 提供商调用（模型、延迟、令牌、故障转移事件）
* 技能调度和路由决策
* MCP 客户端调用
* Supermemory 操作

## SigNoz MCP + Cursor

```bash theme={null}
arka signoz mcp tools
arka signoz cursor-setup
```

捆绑的 SigNoz 资产（仪表板、告警、演示）位于仓库的 `signoz/` 中。

<Note>
  OTLP 导出默认指向 `http://127.0.0.1:4318`。设置 `OTEL_SDK_DISABLED=true` 或 `OTEL_TRACES_ENABLED=0` 可关闭。
</Note>


## Related topics

- [使用 pytest 套件测试 Arka](/cn/guides/testing.md)
- [Arka 与其他智能体的对比](/cn/concepts/comparison.md)
- [Arka 故障排查：LLM、路由、语音与 RAG 修复](/cn/reference/troubleshooting.md)
- [Arka 简介](/cn/index.md)
- [MCP 集成](/cn/guides/mcp.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.