Build and run agents you can see, understand and trust.
Python agentchatbotlarge-language-modelsllmllm-agentmcpmulti-agentmulti-modalreact-agentrealtime-agentvoice-agentvoice-assistant
docs(tracing): add Alibaba Cloud CloudMonitor integration (#978)
sipercai654921ffe201
diff --git a/README.md b/README.mdindex adf4f1a1f..0d9c7d98e 100644--- a/README.md+++ b/README.md@@ -108,7 +108,7 @@ Quick overview of important features in **AgentScope 1.0**:| | Support agent-controlled long-term memory | || | Support agent hooks | || tracing | Support OpenTelemetry-based tracing in LLM, tools, agent and formatter | [Tracing](https://doc.agentscope.io/tutorial/task_tracing.html) |-| | Support connecting to third-party tracing platforms (e.g. Arize-Phoenix, Langfuse) | |+| | Support connecting to third-party tracing platforms (e.g. Alibaba Cloud CloudMonitor, Arize-Phoenix, Langfuse) | || memory | Support long-term memory | [Memory](https://doc.agentscope.io/tutorial/task_long_term_memory.html) || session | Provide session/application-level automatic state management | [Session](https://doc.agentscope.io/tutorial/task_state.html) || evaluation | Provide distributed and parallel evaluation | [Evaluation](https://doc.agentscope.io/tutorial/task_eval.html) |diff --git a/README_zh.md b/README_zh.mdindex bd5be58d4..2377827fb 100644--- a/README_zh.md+++ b/README_zh.md@@ -109,7 +109,7 @@ AgentScope v1.0 新功能概览:| | 允许智能体自主控制长期记忆 | || | 支持智能体钩子函数 | || tracing | 支持基于 OpenTelemetry 的 LLM、工具、智能体和格式化器追踪 | [Tracing](https://doc.agentscope.io/zh_CN/tutorial/task_tracing.html) |-| | 支持连接到第三方追踪平台(如Arize-Phoenix、Langfuse) | |+| | 支持连接到第三方追踪平台(如阿里云云监控、Arize-Phoenix、Langfuse) | || memory | 支持长期记忆 | [Memory](https://doc.agentscope.io/zh_CN/tutorial/task_long_term_memory.html) || session | 提供会话/应用级状态管理 | [Session](https://doc.agentscope.io/zh_CN/tutorial/task_state.html) || evaluation | 提供分布式和并行评估 | [Evaluation](https://doc.agentscope.io/zh_CN/tutorial/task_eval.html) |diff --git a/docs/tutorial/en/src/task_tracing.py b/docs/tutorial/en/src/task_tracing.pyindex ca4e4e1bf..1281190bc 100644--- a/docs/tutorial/en/src/task_tracing.py+++ b/docs/tutorial/en/src/task_tracing.py@@ -11,7 +11,7 @@ execution of agent applications, which features- Provide built-in tracing for LLM, tool, agent, formatter, etc.- Support error and exception tracking- Provide native tracing **visualization** in AgentScope Studio-- Support connecting to **third-party platforms** like `Arize-Phoenix <https://github.com/Arize-ai/phoenix>`_, `Langfuse <https://langfuse.com/>`_, etc.+- Support connecting to **third-party platforms** like Alibaba Cloud CloudMonitor, `Arize-Phoenix <https://github.com/Arize-ai/phoenix>`_, `Langfuse <https://langfuse.com/>`_, etc.Setting Up~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~@@ -51,7 +51,20 @@ The ``tracing_url`` is the URL of your OpenTelemetry collector or any compatible# Connect to OpenTelemetry-compatible backendsagentscope.init(tracing_url="https://your-tracing-backend:port/traces")-Taking Arize-Phoenix and Langfuse as examples:+Taking Alibaba Cloud CloudMonitor, Arize-Phoenix, and Langfuse as examples:++**Alibaba Cloud CloudMonitor**: A fully-managed observability platform.++.. code-block:: python+ :caption: Connect to Alibaba Cloud CloudMonitor++ agentscope.init(tracing_url="https://tracing-cn-hangzhou.arms.aliyuncs.com/adapt_xxx/api/otlp/traces")++.. tip::+ **Get your Endpoint:** In the `ARMS Console <https://arms.console.aliyun.com/>`_ under **Access Center** > **OpenTelemetry**,+ select the **Public Endpoint** matching your deployment region. Customize your app name via the ``OTEL_SERVICE_NAME`` environment variable.+ Alibaba Cloud CloudMonitor provides zero-code instrumentation through `LoongSuite <https://github.com/alibaba/loongsuite-python-agent>`_ agent.+ Learn more in the `CloudMonitor Documentation <https://www.alibabacloud.com/help/en/cms/cloudmonitor-2-0/user-guide/model-application>`_.**Arize-Phoenix**: You need to set the ``PHOENIX_API_KEY`` in your environment variables.diff --git a/docs/tutorial/zh_CN/src/task_tracing.py b/docs/tutorial/zh_CN/src/task_tracing.pyindex 57036da5d..c532a8b0c 100644--- a/docs/tutorial/zh_CN/src/task_tracing.py+++ b/docs/tutorial/zh_CN/src/task_tracing.py@@ -11,7 +11,7 @@ AgentScope 实现了基于 OpenTelemetry 的追踪来监控和调试- 为 LLM、工具、智能体、格式化器等提供内置追踪- 支持错误和异常追踪- 在 AgentScope Studio 中提供原生追踪 **可视化**-- 支持连接到 **第三方平台**,如 `Arize-Phoenix <https://github.com/Arize-ai/phoenix>`_、`Langfuse <https://langfuse.com/>`_ 等+- 支持连接到 **第三方平台**,如阿里云云监控、`Arize-Phoenix <https://github.com/Arize-ai/phoenix>`_、`Langfuse <https://langfuse.com/>`_ 等设置~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~@@ -52,7 +52,20 @@ AgentScope Studio# 连接到 OpenTelemetry 兼容的后端agentscope.init(tracing_url="https://your-tracing-backend:port/traces")-以 Arize-Phoenix 和 Langfuse 为例:+以阿里云云监控、Arize-Phoenix 和 Langfuse 为例:++**阿里云云监控(Alibaba Cloud CloudMonitor)**:全托管可观测平台。++.. code-block:: python+ :caption: 连接到阿里云云监控++ agentscope.init(tracing_url="https://tracing-cn-hangzhou.arms.aliyuncs.com/adapt_xxx/api/otlp/traces")++.. tip::+ **获取 Endpoint:** 在 `ARMS 控制台 <https://arms.console.aliyun.com/>`_ 的 **接入中心** > **OpenTelemetry** 中,+ 根据实际部署地域选择对应的 **公网接入点**。可通过环境变量 ``OTEL_SERVICE_NAME`` 自定义应用名称。+ 阿里云云监控可通过 `LoongSuite <https://github.com/alibaba/loongsuite-python-agent>`_ 探针提供零侵入的自动化接入。+ 更多信息请参考 `云监控文档 <https://help.aliyun.com/zh/cms/cloudmonitor-2-0/user-guide/model-application>`_。**Arize-Phoenix**:需要在环境变量中设置 ``PHOENIX_API_KEY``。