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部署

______________________________________________________________________

📝 许可证

开源-麻省理工学院

______________________________________________________________________