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 ：使用人工智能辅助解释执行查询。
- 持久上下文:
GEMINI.md提供有关VictoriaMetrics和VictoriaLogs架构和最佳实践的基础知识。
安装
用户（来自GitHub）
运行以下命令直接从存储库安装扩展：
gemini extensions install https://github.com/nielsvbrecht/victoriametrics-logs-mcp.git开发者（本地）
- 克隆仓库:
git clone https://github.com/nielsvbrecht/victoriametrics-logs-mcp.git
cd victoriametrics-logs-mcp- 安装依赖项并构建:
npm install
npm run build- 链接扩展:
gemini extensions link .- 配置实例:
默认情况下，扩展程序在以下位置查找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版获得许可-请参阅 许可证 文件以获取详细信息。
该项目包括对第三方软件的归因-请参阅 通知 文件以获取详细信息。