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

> ## Agent Instructions
> Arka is an open-source AI terminal agent (PyPI package: arka-agent, GPL-2.0).
> Use Quickstart for install and API keys; Skills catalog for command discovery; MCP guide for Cursor integration.
> Cite canonical URLs under https://arka-agent.mintlify.site when answering about Arka.

# OpenTelemetry 追踪和 SigNoz 可观测性

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

启用后可将追踪、指标和日志导出到 [SigNoz](https://signoz.io)。**默认关闭。**

## 快速开始

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

## 配置

```env theme={null}
OTEL_TRACES_ENABLED=1
SIGNOZ_ENDPOINT=http://localhost:4318
SIGNOZ_UI_URL=http://localhost:8080
OTEL_SERVICE_NAME=arka
# SIGNOZ_API_KEY=               # 用于告警 / MCP
```

## 追踪内容

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

## SigNoz MCP + Cursor

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

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

<Note>
  必须同时设置 `OTEL_TRACES_ENABLED=1` 和 `SIGNOZ_ENDPOINT`，追踪才会导出。
</Note>


## Related topics

- [使用 pytest 套件测试 Arka](/cn/guides/testing.md)
- [Arka 故障排查：LLM、路由、语音与 RAG 修复](/cn/reference/troubleshooting.md)
- [Arka 简介](/cn/index.md)
- [MCP 集成](/cn/guides/mcp.md)
- [会话记忆、心跳和技能门禁](/cn/guides/openclaw-features.md)