AI导哈

Honeycomb MCP可观测性工具

该工具提供OpenTelemetry演示的完整设置，集成Honeycomb可观测性和MCP协议，支持本地KIND Kubernetes集群开发，用于收集跟踪、指标和日志数据。

  • by rushi2828
  • Shell
  • 本地部署
  • 更新于
在 GitHub 查看 rushi2828/ai-observability-honeycomb-mcp-kind

使用说明

基于KIND的蜂窝MCP人工智能可观测性

此存储库提供了一个完整的设置，用于运行OpenTetry演示 蜂窝可观测性, 模型上下文协议（MCP） 整合，以及 KIND Kubernetes集群 为了地方发展。

该项目是模块化的，使用Helm charts、Kubernetes清单和KIND集群配置脚本。

📁 项目文件夹结构

.
+--- helm
|   +--- otel-demo
|   |   +--- values-honeycomb.yaml
+--- k8s
|   +--- namespaces.yaml
|   +--- secrets
|   |   +--- honeycomb-credentials-example.yaml
+--- kind
|   +--- create-cluster.sh
|   +--- kind-config.yaml
+--- README.md

🚀 概述

此项目部署：

  • OpenTetry演示应用程序 （通过Helm）
  • 蜂窝观测后端
  • 蜂窝MCP服务器 在VS代码内部使用
  • KIND Kubernetes集群 用于本地测试

它可以帮助您：

  • 从演示中收集跟踪、指标和日志
  • 使用安全的API密钥将它们发送到Honeycomb
  • 在VS Code中使用MCP兼容的提示查询Honeycomb数据集

🧱 先决条件

确保已安装以下内容：

  • 码头工人
  • kubectl 的
  • 亲切的
  • 头盔3+
  • 带有MCP代理扩展的VS代码
  • 蜂窝账户+API密钥

🏗️ 步骤1：创建KIND集群

cd kind/
chmod +x create-cluster.sh
./create-cluster.sh

这使用 kind-config.yaml 启动本地集群。

🔐 步骤2：添加Honeycomb API凭据

更新示例文件：

k8s/secrets/honeycomb-credentials-example.yaml

替换占位符值：

stringData:
  HONEYCOMB_API_KEY: "YOUR_API_KEY"
  HONEYCOMB_DATASET: "otel-demo"

应用密码：

kubectl apply -f k8s/secrets/honeycomb-credentials-example.yaml

🏷️ 步骤3：创建所需的命名空间

kubectl apply -f k8s/namespaces.yaml

🎛️ 步骤4：使用蜂窝配置部署OpenTetry演示

helm upgrade --install otel-demo ./helm/otel-demo \
  -n otel-demo \
  -f helm/otel-demo/values-honeycomb.yaml

这将部署配置为导出到Honeycomb的OTel收集器。

🌐 步骤5：在VS代码中配置MCP服务器

你的 mcp.json 必须引用Honeycomb API而不直接公开API密钥。例子：

{
  "mcpServers": {
    "honeycomb": {
      "command": "npx",
      "args": ["@honeycombio/mcp-server-honeycomb"],
      "env": {
        "HONEYCOMB_API_KEY": "${localEnv:HONEYCOMB_API_KEY}"
      }
    }
  }
}

将Honeycomb密钥添加到系统环境中：

export HONEYCOMB_API_KEY="YOUR_KEY"

💬 MCP兼容蜂窝提示

在VS Code MCP代理中使用这些：

  • “列出所有数据集”
  • “显示数据集otel demo的模式”
  • “运行查询：计数按service.name分组的跟踪”
  • “在数据集otel demo中查找最慢的跨度”

🧪 验证部署

检查Pod

kubectl get pods -n otel-demo

检查收集器日志

kubectl -n otel-demo logs deploy/otel-collector --tail=50

预期输出

你应该 不 请参阅API密钥错误。数据应该出现在数据集下的Honeycomb UI中。

🛠️ 故障排除

❌ MCP提示不工作

确保MCP工具出现在VS代码中：

  • 首选 设置→ MCP工具
  • 验证 蜂窝工具 已列出

如果不→ 检查环境变量加载。

❌ 收集器错误：无法生成memory_limiter

运行：

kubectl -n otel-demo logs deploy/otel-collector --tail=100

修复：确保 values-honeycomb.yaml 包含适当的处理器块。

📌 未来的增强功能

  • 添加指标仪表板
  • 添加本地Jaeger查看器
  • 添加OpenTetry操作员
  • 添加ArgoCD GitOps部署

📝 许可证

开源-麻省理工学院

相关 MCP