驽马十驾 驽马十驾

驽马十驾,功在不舍

目录
SkyWalking 8.1 快速上手教程
/    

SkyWalking 8.1 快速上手教程

前言

SkyWalking5.0 和6.0都写过安装记录,但是存储用的都是 Elasticsearch

这次随着 8.1版本的更新,同时项目也会用到,所以经过一番实践后,行文如下。本篇文章仅仅是入门,更多信息,请查看官方文档!

正文

Skywalking整体分为 3 个部分:agent,backend,UI

  • agent 代理,应用启动的时候后,通过该agent收集数据并上报backend
  • backend 数据收集器,agent收集的数据会发送给backend,然后数据处理后入库。
  • ui也就是提供可视化服务的界面。

在安装前,请在官方网址进行下载:下载地址,下载的时候,请一定注意了不是第一行的 Source Code而是第二行的 Binary Distribution

backend

如上所述:backend的目的是收集 agent的上报的数据,然后持久化到存储中,起到承上启下的功能,所以首先安装 backend

启动步骤

与之先关的目录和文件主要是如下几个:

  • bin目录下的oapService.sh,它就是backend 的启动脚本
  • config目录下的application.yml,它是backend的配置信息
  • oap-libsbackend启动需要的所有jar
  • logs目录下的skywalking-oap-server.log是启动后的日志文件。

以下内容是 基于 MySQL作为存储来讲解的。

第一步:修改配置文件 application.yml

  • storage.selector修改为mysql,默认是用于演示的h2,你也可以选择自己的存储介质。
  • 然后找到store下的mysql节点
  • 修改mysql.properties中基本信息:jdbcUrl/dataSource.user/dataSource.password

第二步:将 mysql的驱动包,拷贝到 opa-libs目录中。官方可没有自带 mysql的驱动包,所以请自行下载后拷贝到这个目录。

  • mysql8一定要找对应的mysql8jar 包,不要找mysql5.7的驱动包,MySql8驱动
  • mysql5.7的数据库,最好也是5.7的(理论上 8 的也是兼容),MySQL5.7驱动

如果上述流程完成后,尝试运行 bin目录下的 oapService.sh

sh oapService.sh

然后查看 logs/skywalking-oap-server.log的日志,如果失败会有日志,接下来你就见招拆招吧。

启动后,你可以通过如下几种方式观察是否成功。

第一就是可以通过查看端口运行情况判定:

lsof -i:12800 #数据上报端口,很重要的端口
lsof -i:11800

如果端口被占用,日志又没有错误保存,那么基本启动成功了。

第二就是查看 jdbcUrl对应的数据库是否已经默认创建好了数据表。

Bug1

我在写本文的查看日志发现报错了一个错误: Data too long for column 'statement' at row 1

简单查了下应该是 Segment表的字段 statement,原本是 200的长度,我将其改为 2000,该问题目前为止没有再输出。

还有就是 top_n_database_staement有这个字段,我暂时也将其修改到了 2000

同时提了 issue官方也很快做出了响应,建议修改为 2000直达地址

Bug2

提示:Specified key was too long; max key length is 767 bytes

最简单的方法就是将参数:innodb_large_prefix修改为 ON,其他方法请自行百度了解

ui

该组件将数据可视化出来,供大家更直观的查看数据。

与之关联的目录和文件大体如下:

  • bin下的webappService.shUI的启动脚本
  • webapp目录,其中包括了 2 个重要的东西
    • webapp.yml,包括UI启动的端口和上报地址
    • skywalking-webapp.jar,启动 jar包
  • logs下的文件webapp.log

第一步:修改 webapp.yml,其默认的端口是经典的 8080,所以还是修改为一个特殊点的端口,避免启动出错。

第二部:修改 collecotr.ribbon.listofServersip实际运行的 ip

第三步:通过 bin 下的 webappService.sh启动

sh webappService.sh

不要看到控制台输出 SkyWalking Web Application started successfully!就认为 OK 了。

还是要自己错看看日志 webapp.log有没有报错内容。

agent

agent 的作用是同应用一起启动,将应用的指标数据上传。agent 我记得是可以共享的,就是所有的应用都用同一个 agent,但是为了安全,还是建议每个应用一个 agent。

与之相关的目录为 agent,其中最关键的就是 agent/config/agent.config这个配置文件

以下是使用步骤:

  1. 拷贝一份agent到任意一个你喜欢的地方,我喜欢放在 jar包的同级目录。
  2. 修改agent.config中的参数
    1. agent.service_name修改实际的,同一个应用多个实例,其service_name相同
    2. agent.instance_name每个实例都应该是唯一的,建议自行修改,这样UI上可视化后,更有意义。
    3. collector.backend_service修改为实际的backend所在主机的ip和端口。
  3. 在 jar包启动脚本中添加如下命令-javaagent:/xxx/agent/skywalking-agent.jar

结语

按照上面的步骤后,启动应用,你可以通过 UI的界面去看看是否 OK

以上是 skywalking 8.1在使用 MySQL时的最基础的配置,更多的信息请参考:官方文档

当然你有问题,也可以留言讨论。

骐骥一跃,不能十步。驽马十驾,功在不舍。