Skywalking部署+NetCore客户端

一、介绍

应用官方的说法：Apache SkyWalking是观察性分析平台和应用性能管理系统。提供分布式追踪、服务网格遥测分析、度量聚合和可视化一体化解决方案

GitHub地址：https://github.com/apache/skywalking

二、准备工作

Skywalking的架构分成三大块：

agent：探针，主要与我们的api或者app之类的集成在一起，用于收集上传客户端信息，然后发送到collector。
oap: 主要用于收集agent发送过来的信息，并持久化到相应存储中
ui：展示收集在存储中的信息

这次主要会使用docker去部署oap和ui这2个模块（查看skywalking的github库会发现官方已经为我们准备好了相关的docker部署文件）。

我们需要准备2样东西即可：

skywalking为我们准备的Docker相关文件：打开skywalking的github，下载master分之下的Docker文件夹。
skywalking对应系统的压缩包：【点击这里下载】，下载完成后将压缩包名称改成apache-skywalking-apm-bin，因为在skywaking为我们准备的Docker配置文件中使用的是这个名称ENV DIST_NAME=apache-skywalking-apm-bin \，COPY "$DIST_NAME.tar.gz" /，后面没有带版本号。
将apache-skywalking-apm-bin.tar.gz分别拷贝到docker文件夹的oap、ui中。

三、部署

这里我们使用docker文件夹中的docker-compose.yml文件进行部署。查看其中内容，会看到需要我们先准备好2个docker镜像，一个是skywalking/oap,一个是skywalking/ui。

...

  oap:

    image: skywalking/oap

...

  ui:

    image: skywalking/ui

...

上一步中我们已经准备好了所有的东西，那这里其实只需要使用docker的builder命令来创建这2个镜像即可

这里需要注意下，需要修改一下Dockerfile.oap和Dockerfile.ui文件里的内容

...

RUN set -ex; \

    ...

    mv "$DIST_NAME" skywalking; \

    # 修改时区

    ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \

    echo "Asia/Shanghai" > /etc/timezone

WORKDIR skywalking

...

生成oap和ui镜像

# oap

cd oap文件夹

docker build -t skywalking/oap -f Dockerfile.oap .

# ui

cd ui文件夹

docker build -t skywalking/ui -f Dockerfile.ui .

官方推荐使用elasticsearch作为存储，而且细心的同学可能在查看docker-compose.yml的时候也发现了构建的时候确实使用的是elasticsearch。但是在Dockerfile.oap文件中定义的确实h2作为存储，生成的镜像会不会有问题？其实不会的，在docker-compose.yml中已经将镜像的环境变量申明为使用elasticsearch了。

...

    environment:

      SW_STORAGE: elasticsearch

      SW_STORAGE_ES_CLUSTER_NODES: elasticsearch:9200

...

执行完上面的命令之后，使用docker images会看到已经生成了对应的镜像。

REPOSITORY                    TAG                      IMAGE ID            CREATED             SIZE

skywalking/ui                 latest                   d2a316c65e4b        18 seconds ago      787MB

skywalking/oap                latest                   4a5995eacbe8        49 seconds ago      839MB

接下来就很简单了，直接使用docker-compose将所有容器启动起来就可以了

cd `docker-compose.yml所在文件夹`

docker-compose up -d

# 看到下面内容

Creating elasticsearch ... done

Creating oap           ... done

Creating ui            ... done

# 查看容器运行情况

docker-compose ps

    Name                   Command               State                      Ports

----------------------------------------------------------------------------------------------------

elasticsearch   /usr/local/bin/docker-entr ...   Up      0.0.0.0:9200->9200/tcp,

                                                         0.0.0.0:9300->9300/tcp

oap             bash docker-entrypoint.sh        Up      0.0.0.0:11800->11800/tcp, 1234/tcp,

                                                         0.0.0.0:12800->12800/tcp

ui              bash docker-entrypoint.sh        Up      0.0.0.0:8080->8080/tcp

使用浏览器打开127.0.0.1:8080，默认账号密码都是admin。

到这里，服务端相关的已经部署完毕。接下来就是客户端引入skywalking探针了。

四、客户端引入探针

这里我用NetCore的webapi项目作为测试。

新建webapi项目

dotnet new webapi -n skywalkingdemo --no-https

添加探针程序包：

dotnet add package SkyAPM.Agent.AspNetCore

添加环境变量（直接修改Properties/launchSettings.json）：

{

    ...

    "skywalkingdemo": {

        "commandName": "Project",

        "launchBrowser": true,

        "launchUrl": "api/values",

        "applicationUrl": "http://localhost:10009",

        "environmentVariables": {

            "ASPNETCORE_ENVIRONMENT": "Development",

            // 添加下面2个环境变量

            "ASPNETCORE_HOSTINGSTARTUPASSEMBLIES": "SkyAPM.Agent.AspNetCore",

            "SKYWALKING__SERVICENAME": "hello"

        }

    }

}

添加skywalking的配置文件（skyapm.json），内容如下：

{

  "SkyWalking": {

    "ServiceName": "hello",

    "Namespace": "",

    "HeaderVersions": [

    "sw6"

    ],

    "Sampling": {

    "SamplePer3Secs": -1,

    "Percentage": -1.0

    },

    "Logging": {

    "Level": "Information",

    "FilePath": "logs/skyapm-{Date}.log"

    },

    "Transport": {

        "Interval": 3000,

        "ProtocolVersion": "v6",

        "QueueSize": 30000,

        "BatchSize": 3000,

        "gRPC": {

            "Servers": "localhost:11800",

            "Timeout": 10000,

            "ConnectTimeout": 10000,

            "ReportTimeout": 600000

        }

    }

  }

}

这里需要将文件设置成如果较新则复制（修改项目的.csproj文件）,添加如下配置

<ItemGroup>

    <None Include="skyapm.json" CopyToOutputDirectory="PreserveNewest" />

</ItemGroup>

配置文件也可以通过安装skywalking的客户端工具生成配置文件

# 全局安装工具

dotnet tool install -g SkyAPM.DotNet.CLI

# 生成skyapm配置文件

dotnet skyapm config hello 172.16.102.111:11800

# 这里的地址填的是skywalking的oap所在服务器的地址

# 执行命令之后会自动生成与上面配置文件内容一样的文件

F5或者dotnet run运行项目即可看到在skywalking的管理页面里看到多了一个service
访问localhost:10009/api/values和localhost:10009/api/values/1就会看到相关访问的记录以及统计信息。