AI导哈

VictoriaMetrics日志扩展

VictoriaMetrics & VictoriaLogs Gemini扩展是一款用于与VictoriaMetrics和VictoriaLogs实例交互的CLI工具，提供MetricsQL和LogsQL支持、健康监控和故障排除功能。

  • by nielsvbrecht
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 nielsvbrecht/vm-mcp

使用说明

VictoriaMetrics&VictoriaLogs双子座扩展（VictoriaMetrics-logs mcp）

用于与VictoriaMetrics和VictoriaLogs实例交互的专用Gemini CLI扩展。此扩展提供专家级MetricsQL和LogsQL支持、运行状况监视和故障排除工具。

特性

  • MCP集成：无缝连接到社区和自定义MCP服务器进行监控和记录。
  • 自定义技能:
    • metrics-expert：专门从事PromQL/MetricsQL和查询优化。
    • logs-expert：专门从事LogsQL、日志过滤和全文搜索。
    • troubleshooter：专注于指标和日志的健康、摄入和存储诊断。
  • VictoriaLogs支持：用于日志检索、统计和分析的完整LogsQL集成。
  • 斜杠命令:
    • /vm-status：快速健康报告和状态摘要。
    • /vm-query <query>：使用人工智能辅助解释执行查询。
  • 持久上下文: GEMINI.md 提供有关VictoriaMetrics和VictoriaLogs架构和最佳实践的基础知识。

安装

用户（来自GitHub）

运行以下命令直接从存储库安装扩展：

gemini extensions install https://github.com/nielsvbrecht/victoriametrics-logs-mcp.git

开发者（本地）

  1. 克隆仓库:

    git clone https://github.com/nielsvbrecht/victoriametrics-logs-mcp.git
cd victoriametrics-logs-mcp

  2. 安装依赖项并构建:

    npm install
npm run build

  3. 链接扩展:

    gemini extensions link .

  4. 配置实例: 默认情况下，扩展程序在以下位置查找VictoriaMetrics http://localhost:8428 VictoriaLogs http://localhost:9428。您可以通过编辑进行自定义 gemini-extension.json 或设置环境变量：

    • VM_INSTANCE_ENTRYPOINT：您的VictoriaMetrics实例的URL。
    • VL_INSTANCE_ENTRYPOINT：您的VictoriaLogs实例的URL。
    • VM_INSTANCE_TYPE: single 或 cluster.

用法

链接后，启动新的Gemini CLI会话。您可以使用以下命令和工具：

命令

  • /vm-status：“检查我的VictoriaMetrics实例的运行状况。”
  • /vm-query "sum(rate(node_cpu_seconds_total[5m]))"：运行查询并获取分析。

工具

  • victoriametrics__query：执行原始MetricsQL。
  • vmMcpInfo__logs_query：执行LogsQL查询以检索日志条目。
  • vmMcpInfo__logs_hits：获取日志统计数据和随时间变化的频率。
  • vmMcpInfo__logs_list_field_names：发现可用的日志字段。
  • vmMcpInfo__logs_list_field_values：探索特定日志字段的唯一值（例如。， level, app).
  • vmMcpInfo__logs_status：检查您的VictoriaLogs实例的运行状况。
  • vmMcpInfo__check_config：验证您的本地配置。

例子

  • 日志查询: vmMcpInfo__logs_query(query='error AND app="api"', limit=20)
  • 日志点击数（统计数据）: vmMcpInfo__logs_hits(query='level="error"', step='1h')
  • 列出日志字段: vmMcpInfo__logs_list_field_names()
  • 列出字段值: vmMcpInfo__logs_list_field_values(field='host')

技能

扩展的技能是自动可用的。您还可以显式激活它们：

  • activate_skill(name="metrics-expert")

发展

运行测试

npm test

项目结构

  • gemini-extension.json：扩展清单。
  • index.js：用于扩展元数据的本地MCP服务器。
  • skills/：专业代理专业知识。
  • commands/：自定义斜线命令定义。
  • GEMINI.md：核心指令集。

许可证

此项目根据Apache许可证2.0版获得许可-请参阅 许可证 文件以获取详细信息。

该项目包括对第三方软件的归因-请参阅 通知 文件以获取详细信息。

相关 MCP