SkyWalking学习笔记(Window环境本地环境)

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

环境要求

JDK8+
Elasticsearch
8080,9200,10800,11800,12800 端口不被占用

Elasticsearch安装

Elasticsearch下载安装参考官方教程.

Elasticsearch下载安装官方教程链接：

https://www.elastic.co/cn/downloads/elasticsearch/

修改配置

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

# 修改
# 如果 cluster.name 不设置为 CollectorDBCluster ，则需要修改 SkyWalking 的配置文件
cluster.name: CollectorDBCluster
# IP端口
http.host: 0.0.0.0
http.port: 9200

更多配置参考官方文档
https://www.elastic.co/guide/en/elasticsearch/reference/7.5/settings.html

Elasticsearch 的端口默认绑定到 127.0.0.1 上，对外开放 http 端口就配置 http.host，对外开放 tcp 端口就配置 network.host
关于网络配置参考官方：
https://www.elastic.co/guide/en/elasticsearch/reference/current/modules-network.html

启动

Elasticsearch的Window版本安装之后再Window服务里面，查看是否启动成功就行

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

http://localhost:9200/

应该会显示如下消息

{"name": "XXXX","cluster_name": "CollectorDBCluster","cluster_uuid": "a6O1e0ptTuW4t2nNTB6JxQ","version": {"number": "7.5.1","build_flavor": "unknown","build_type": "unknown","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/

(window可以下载Binary Distribution for ElasticSearch 7 (Windows))

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

修改配置

文件位于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。

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

查看SkyWalking UI

快速入门地址：

https://github.com/apache/skywalking/blob/5.x/docs/cn/Quick-start-CN.md

配置SkyWalking UI(可选)

文件位于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

SkyAPM-dotnet链接：

https://github.com/apache/skywalking/blob/5.x/docs/cn/Quick-start-CN.md

新建一个 .net core api项目，安装Nuget包

Install-Package SkyAPM.Agent.AspNetCore

添加环境变量(参考)
参考链接：
https://github.com/SkyAPM/SkyAPM-dotnet#examples
```
set ASPNETCORE_HOSTINGSTARTUPASSEMBLIES=SkyAPM.Agent.AspNetCore
```
项目根目录下添加 skyapm.json 文件,添加 SkyWalking 的配置信息(更多默认配置参考)
更多默认配置参考链接：
https://github.com/SkyAPM/SkyAPM-dotnet/blob/master/src/SkyApm.Utilities.Configuration/ConfigurationBuilderExtensions.cs
也可以直接在appsettings.json中添加以及cs代码添加
启动程序，请求的追踪结果就会被记录下来，通过 SkyWalking UI 查看