Apache SkyWalking Kong Agent 常见问题解决方案-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00663/article/details/143516539

Apache SkyWalking Kong Agent 常见问题解决方案

skywalking-kong Apache SkyWalking Kong: 这是一个用于监控 Apache SkyWalking 的插件，基于 Kong 插件框架。Apache SkyWalking 是一个开源的分布式系统监控和诊断工具，用于收集和分析系统的性能指标和日志数据。这个插件可以帮助开发者将 SkyWalking 集成到 Kong 网关中，从而实现流量监控和故障排查。这个插件适合所有使用 Apache SkyWalking 和 Kong 的开发者。项目地址: https://gitcode.com/gh_mirrors/sky/skywalking-kong

项目基础介绍

Apache SkyWalking Kong Agent 是一个基于 SkyWalking Nginx Lua 代理的 Kong API 网关追踪插件。该项目的主要目的是为 Apache SkyWalking APM 系统提供对 Kong API 网关的追踪支持。通过该插件，用户可以监控和分析 Kong API 网关的性能和行为，从而优化和改进其服务。

该项目主要使用的编程语言包括：

Lua
Java
Shell
Makefile
Dockerfile

新手使用注意事项及解决方案

1. 插件安装失败

问题描述：新手在尝试使用 luarocks 安装 kong-plugin-skywalking 时，可能会遇到安装失败的情况。

解决步骤：

检查依赖：确保系统中已经安装了 luarocks 和 lua 的相关依赖。
使用本地安装：在安装命令中添加 --local 参数，以确保插件安装在本地环境中。
```
$ luarocks install kong-skywalking --local
```
查看错误日志：如果安装仍然失败，查看终端输出的错误日志，根据错误信息进行相应的修复。

2. Kong 配置文件编辑错误

问题描述：在编辑 kong.conf 文件时，新手可能会因为配置项错误导致 Kong 无法正常启动。

解决步骤：

备份配置文件：在编辑 kong.conf 之前，先备份原始配置文件。
```
$ cp kong.conf kong.conf.bak
```
正确配置插件路径：确保 lua_package_path 配置项正确指向插件的安装路径。
```
lua_package_path = $[user_home]/luarocks/share/lua/5.1/?.lua
```
检查环境变量：确保 KONG_NGINX_HTTP_LUA_SHARED_DICT 环境变量已正确设置。
```
$ export KONG_NGINX_HTTP_LUA_SHARED_DICT="tracing_buffer 128m"
```

3. 插件启用失败

问题描述：在通过 curl 命令启用插件时，可能会遇到插件无法正常启用的问题。

解决步骤：

检查 Kong Admin API：确保 Kong Admin API 已正确启动并监听在 localhost:8001。
```
$ curl http://localhost:8001/
```

正确配置插件：确保在启用插件时，所有配置项都正确无误。

$ curl -X POST --url http://localhost:8001/plugins/ \
  --data 'name=skywalking' \
  --data 'config.backend_http_uri=http://localhost:12800' \
  --data 'config.sample_ratio=100' \
  --data 'config.service_name=kong' \
  --data 'config.service_instance_name=kong-with-skywalking'