SkyWalking学习笔记(CentOS环境)

  • 2020 年 2 月 16 日
  • 筆記

基于 CentOS 环境使用 SkyAPM-dotnet 来介绍一下 SkyWalking, SkyAPM-dotnet 是 SkyWalking 的 .NET Agent

环境要求

  1. JDK8+
  2. Elasticsearch
  3. 8080,9200,10800,11800,12800 端口不被占用
Elasticsearch安装

Elasticsearch下载安装(CentOS为例) 参考官方教程.

  1. 下载并安装公共签名密钥 rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch
  2. yum添加安装源仓库 修改/etc/yum.conf文件,添加源 [elasticsearch] name=Elasticsearch repository for 7.x packages baseurl=https://artifacts.elastic.co/packages/7.x/yum gpgcheck=1 gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch enabled=0 autorefresh=1 type=rpm-md
  3. 安装Elasticsearch sudo yum install --enablerepo=elasticsearch elasticsearch
修改配置

安装完成后需要对 /etc/elasticsearch.yml 做如下修改

# 修改  # 如果 cluster.name 不设置为 CollectorDBCluster ,则需要修改 SkyWalking 的配置文件  cluster.name: CollectorDBCluster  # IP端口  network.host: 0.0.0.0  http.host: 0.0.0.0  http.port: 9200  # 节点  node.name: node-1  cluster.initial_master_nodes: ["node-1"]

更多配置参考官方文档

Elasticsearch 的端口默认绑定到 127.0.0.1 上,对外开放 http 端口就配置 http.host,对外开放 tcp 端口就配置 network.host 关于网络配置参考官方

启动

要将Elasticsearch配置为在系统启动时自动启动

sudo /bin/systemctl daemon-reload  sudo /bin/systemctl enable elasticsearch.service

启动和停止可以使用以下命令

sudo systemctl start elasticsearch.service  sudo systemctl stop elasticsearch.service

你可以通过发送一个HTTP请求到本地主机端口9200来测试你的Elasticsearch节点是否正在运行

 curl "http://localhost:9200/"

应该会显示如下消息

{    "name" : "XXXX",    "cluster_name" : "CollectorDBCluster",    "cluster_uuid" : "JVNBpkf1TjeFJUjiPdD5dQ",    "version" : {      "number" : "7.5.1",      "build_flavor" : "default",      "build_type" : "rpm",      "build_hash" : "3ae9ac9a93c95bd0cdc054951cf95d88e1e18d96",      "build_date" : "2019-12-16T22:57:37.835892Z",      "build_snapshot" : false,      "lucene_version" : "8.3.0",      "minimum_wire_compatibility_version" : "6.8.0",      "minimum_index_compatibility_version" : "6.0.0-beta1"    },    "tagline" : "You Know, for Search"  }
SkyWalking安装

SkyWalking 建议直接下载官方编译好的,下载地址

(http://skywalking.apache.org/downloads/)

(Linux可以下载Binary Distribution for ElasticSearch 7 (Linux))

解压之后重命名为SkyWalking-ES7(看个人爱好)

修改配置

文件位于/home/SkyWalking-ES7/config/application.yml

默认数据存储开启是的 h2,这里我们需要修改数据存储为 Elasticsearch7(在启动 SkyWalking 之前,确保 Elasticsearch 已启动)

启动

SkyWalking (bin目录)的启动包括两部分,一个是 SkyWalking Collector(oapService) ,一个是 SkyWalking UI(webappService).

bat 为 windows 环境使用,sh 为 linux 环境使用,我们可以分别启动 oapService 和 webappService,也可以通过 startup 一次性全部启动,从 startup 中的命令可以知道其实就是分别启动 oapService 和 webappService。

# cd /home/SkyWalking-ES7/bin    --SkyWalking解压的bin目录  # ./startup.sh

出现如下消息 表示成功

SkyWalking OAP started successfully!  SkyWalking Web Application started successfully!

如果启动成功访问(如果失败参考快速入门) 可以打开链接http://localhost:8080 查看SkyWalking UI

配置SkyWalking UI(可选)

文件位于/home/SkyWalking-ES7/webapp/webapp.yml

Config

Description

server.port

默认监听8080端口

collector.ribbon.listOfServers

collector的访问服务名称(与config/application.yml中naming.jetty配置保持相同) 且若是多个 collector 服务名称用’,’分隔

collector.path

Collector 查询uri地址. 默认是/graphql

collector.ribbon.ReadTimeout

查询超时时间,默认是10秒

.NET 项目接入

参考官方链接SkyAPM-dotnet sample目录下的Demo

  1. 新建一个 .net core api项目 ,安装Nuget包
Install-Package SkyAPM.Agent.AspNetCore
  1. 添加环境变量(参考) set ASPNETCORE_HOSTINGSTARTUPASSEMBLIES=SkyAPM.Agent.AspNetCore
  2. 项目根目录下添加 skyapm.json 文件,添加 SkyWalking 的配置信息(更多默认配置参考) 也可以直接在appsettings.json中添加以及cs代码添加
  3. 启动程序,请求的追踪结果就会被记录下来,通过 SkyWalking UI 查看

以上部分配置文件可参考快速入门 https://github.com/apache/skywalking/blob/5.x/docs/cn/Deploy-backend-in-cluster-mode-CN.md

转载是一种动力 分享是一种美德

作者:心莱科技陈浪林

如果喜欢作者的文章,请关注【麦扣聊技术】订阅号以便第一时间获得最新内容。本文版权归作者和湖南心莱信息科技有限公司共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。

文档官网:docs.xin-lai.com