Skillppx logo

Zhihu Aiops

用于知乎智护运维平台的资产管理与监控数据查询，支持SNMP及VictoriaMetrics指标获取。

已扫描
适合谁
企业IT运维工程师、系统监控与资产管理岗位
不适合谁
无权限访问知乎智护平台的用户、非技术背景的普通办公人员
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @luckypig1209/zhihu-aiops
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

Zhihu AIOps 技能

该技能提供智护运维平台 / Zhihu AIOps 平台的工作流和 API 参考文档。

可用于以下操作：

  • 查询平台资产、资产模型、资产类型及已管理设备。
  • 在完成连通性检查后，创建操作系统监控资产。
  • 查询仪表板与告警摘要信息。
  • 处理 CMDB / 资产发现扫描任务及其结果。
  • 查询 VictoriaMetrics 和 Categraf SNMP snmp_* 指标数据。
  • 生成已管理资产的巡检报告。

配置

在调用平台 API 前，请设置以下环境变量：

export ZHIHU_API_URL="http://zhihu-server:48080/admin-api"
export ZHIHU_USER="admin"
export ZHIHU_PASSWORD="your-password"
export VM_URL="http://zhihu-metric:9090"

请勿将客户 IP 地址、测试环境 URL、用户名、密码或 API 密钥硬编码到提示词或生成脚本中。应优先使用环境变量。

核心工作流

  1. 根据用户目标，从 references/ 目录中读取相关参考文件。
  2. 在调用受保护的平台 API 前，先登录 Zhihu 平台。
  3. 向平台请求添加 Authorization: Bearer <accessToken>，除非目标环境要求使用原始 token 格式。
  4. 对于已管理资产，当模型 ID 不明确时，应先查询资产模型，再使用正确的 modelId 和 modelCode 调用 /cqt/asset-info/page 接口。
  5. 对于 SNMP / 网络 / 安全 / 存储类设备指标，应使用由 Categraf 收集的 VictoriaMetrics snmp_* 指标，而非 Zabbix 数据。
  6. 生成巡检报告时，仅在需要实时指标状态的情况下，才将平台已管理资产数据与 VictoriaMetrics/SNMP 数据进行合并。

参考文档映射

  • 资产中心 API：references/api_asset.md
  • CMDB 发现 API：references/api_cmdb.md
  • 仪表板与告警摘要 API：references/api_dashboard.md
  • 监控中心 API：references/api_monitor.md
  • VictoriaMetrics API：references/api_victoriametrics.md
  • Categraf SNMP 指标：references/api_snmp_metrics.md
  • 添加操作系统监控工作流：references/add-os-monitor.md
  • 已管理资产巡检工作流：references/inspection-run.md

常见任务

查询已管理资产

查阅 references/api_asset.md。若用户请求的是具体资产而非模型定义，请使用 /cqt/asset-info/page 接口。对于已知的巡检模型，可参考 references/inspection-run.md 中的模型信息。

生成已管理资产巡检报告

查阅 references/inspection-run.md，根据需要查询以下类别：

  • 安全设备：modelId=254, modelCode=securitydevice
  • 网络设备：modelId=185, modelCode=networkdevice
  • 终端设备：modelId=260, modelCode=terminaldevice
  • 存储设备：modelId=261, modelCode=storagedevice
  • 数据库：modelId=183, modelCode=storagebase
  • 操作系统：modelId=195, modelCode=operatesystem

查询 SNMP 指标

查阅 references/api_snmp_metrics.md。使用 VM_URL 和 VictoriaMetrics API：

  • /api/v1/series：用于指标发现。
  • /api/v1/query：用于即时查询。
  • /api/v1/query_range：用于趋势查询。

建议对网络设备、安全设备、存储设备、交换机、路由器、防火墙及其他支持 SNMP 的设备，优先使用 snmp_* 指标。

添加操作系统监控

查阅 references/add-os-monitor.md。所需用户输入包括目标 IP、端口、用户名、密码和监控名称。需先登录，动态解析操作系统模型与监控项，完成连通性测试后，再创建资产。

当前限制

此版本为 ClawHub 第一个文档先行、注册就绪的包，尚未包含生产级 CLI 封装。在需要确定性执行时，下一阶段将在 scripts/ 目录中实现脚本，例如：

python3 scripts/zhihu_cli.py login
python3 scripts/zhihu_cli.py asset-page --model-code networkdevice
python3 scripts/zhihu_cli.py inspect-managed-assets --scope all
python3 scripts/zhihu_cli.py snmp-discover
python3 scripts/zhihu_cli.py vm-query --query 'up'
L
@luckypig1209

已收录 1 个 Skill

相关推荐