🚀 阿里云可观测性数据处理工具

该工具主要用于阿里云可观测性数据的采集、处理与分析，能助力用户实时掌握应用性能、管理日志、追踪调用链路、检测异常并可视化数据。

🚀 快速开始

本工具可用于阿里云可观测性数据的采集、处理与分析，支持性能监控、日志管理等多种功能。安装完成后，按相应命令运行即可开始使用。

✨ 主要特性

• 性能监控：实时采集和分析应用的性能指标。
• 日志管理：收集和查询应用程序的日志信息。
• 追踪系统：实现分布式系统的调用链路追踪。
• 异常检测：自动识别系统中的异常行为。
• 数据可视化：提供丰富的数据展示界面。

📦 安装指南

使用 pip 安装

需要 Python 3.10 及以上版本。直接使用 pip 安装即可，安装命令如下：

pip install mcp-server-aliyun-observability

安装完成后，可以直接运行，运行命令如下：

python -m mcp_server_aliyun_observability --transport sse --access-key-id <your_access_key_id> --access-key-secret <your_access_key_secret>

可通过命令行传递以下参数:

• --transport 指定传输方式，可选值为 sse 或 stdio，默认值为 stdio。
• --access-key-id 指定阿里云 AccessKeyId，不指定时会使用环境变量中的 ALIBABA_CLOUD_ACCESS_KEY_ID。
• --access-key-secret 指定阿里云 AccessKeySecret，不指定时会使用环境变量中的 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
• --log-level 指定日志级别，可选值为 DEBUG、INFO、WARNING、ERROR，默认值为 INFO。
• --transport-port 指定传输端口，默认值为 8000，仅当 --transport 为 sse 时有效。

使用 uv 命令启动

可以指定版本号，会自动拉取对应依赖，默认是 studio 方式启动：

uvx --from 'mcp-server-aliyun-observability==0.2.1' mcp-server-aliyun-observability

从源码安装

# 克隆源码
git clone git@github.com:aliyun/alibabacloud-observability-mcp-server.git
# 进入源码目录
cd alibabacloud-observability-mcp-server
# 安装
pip install -e .
# 运行
python -m mcp_server_aliyun_observability --transport sse --access-key-id <your_access_key_id> --access-key-secret <your_access_key_secret>

📚 详细文档

AI 工具集成

配置说明

以下是一些常用 AI 工具的配置示例：

• Cursor 配置示例

# 示例命令行参数
python -m mcp_server_aliyun_observability --transport sse --access-key-id <your_access_key_id> --access-key-secret <your_access_key_secret>

• Codelens 配置示例

uvx --from 'mcp-server-aliyun-observability==0.2.1' mcp-server-aliyun-observability

可视化界面截图说明

• 示例截图 1 | 参数 | 描述 | |------|------| | transport | 指定传输方式，可选值为 sse 或 stdio | | access-key-id | 阿里云 AccessKeyId | | access-key-secret | 阿里云 AccessKeySecret |

• 示例截图 2 | 参数 | 描述 | |------|------| | log-level | 指定日志级别，可选值为 DEBUG、INFO、WARNING、ERROR | | transport-port | 指定传输端口，默认值为 8000 |

⚠️ 重要提示

• 确保安装 Python 3.10 及以上版本。
• 安装完成后检查环境变量是否配置正确。
• 使用前请确保已获取有效的阿里云访问密钥。