This is an automated email from the ASF dual-hosted git repository. tanjian pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/incubator-skywalking-website.git
The following commit(s) were added to refs/heads/master by this push: new 8680def add md & pictures for a new blog item "Apache SkyWalking 5.0 Chinese UserGuide" (#13) 8680def is described below commit 8680defebbead8ec8845e9eeb4ca372188775c30 Author: CharlesMaster <just_love_...@126.com> AuthorDate: Wed Dec 19 22:17:39 2018 -0600 add md & pictures for a new blog item "Apache SkyWalking 5.0 Chinese UserGuide" (#13) --- .../blog/2018-12-18-skywalking-net/alarm.jpg | Bin 0 -> 355705 bytes .../blog/2018-12-18-skywalking-net/analysis.jpg | Bin 0 -> 577737 bytes .../blog/2018-12-18-skywalking-net/app_tip.png | Bin 0 -> 59826 bytes .../blog/2018-12-18-skywalking-net/application.jpg | Bin 0 -> 405967 bytes .../application_findmore.jpg | Bin 0 -> 332872 bytes .../application_heapgc_info.jpg | Bin 0 -> 255638 bytes .../2018-12-18-skywalking-net/applicationdemo.jpg | Bin 0 -> 129040 bytes .../2018-12-18-skywalking-net/charles-weixin.png | Bin 0 -> 365309 bytes .../blog/2018-12-18-skywalking-net/charles.png | Bin 0 -> 313804 bytes .../blog/2018-12-18-skywalking-net/dashboard.jpg | Bin 0 -> 1336079 bytes .../2018-12-18-skywalking-net/dashboarddemo.jpg | Bin 0 -> 227146 bytes .../static/blog/2018-12-18-skywalking-net/demo.jpg | Bin 0 -> 284196 bytes .../blog/2018-12-18-skywalking-net/login.png | Bin 0 -> 86017 bytes .../static/blog/2018-12-18-skywalking-net/menu.png | Bin 0 -> 52174 bytes .../blog/2018-12-18-skywalking-net/planet.png | Bin 0 -> 210753 bytes .../blog/2018-12-18-skywalking-net/service.jpg | Bin 0 -> 351824 bytes .../blog/2018-12-18-skywalking-net/service_tip.png | Bin 0 -> 33945 bytes .../blog/2018-12-18-skywalking-net/slowtrace.jpg | Bin 0 -> 404652 bytes .../blog/2018-12-18-skywalking-net/tags_logs.jpg | Bin 0 -> 261333 bytes .../2018-12-18-skywalking-net/time_chooser.jpg | Bin 0 -> 191141 bytes .../2018-12-18-skywalking-net/top20slowtrace.jpg | Bin 0 -> 305911 bytes .../blog/2018-12-18-skywalking-net/topology.jpg | Bin 0 -> 387310 bytes .../blog/2018-12-18-skywalking-net/topologyMap.jpg | Bin 0 -> 82679 bytes .../2018-12-18-skywalking-net/topology_click.jpg | Bin 0 -> 89441 bytes .../2018-12-18-skywalking-net/topology_search.jpg | Bin 0 -> 338490 bytes .../blog/2018-12-18-skywalking-net/trace1.jpg | Bin 0 -> 272964 bytes .../blog/2018-12-18-skywalking-net/trace2.jpg | Bin 0 -> 266429 bytes .../blog/2018-12-18-skywalking-net/traceLog.jpg | Bin 0 -> 453994 bytes .../2018-12-18-skywalking-net/trace_duration.jpg | Bin 0 -> 325000 bytes .../2018-12-18-skywalking-net/trace_search.jpg | Bin 0 -> 210937 bytes docs/zh/blog/2018-12-18-skywalking-net.md | 181 +++++++++++++++++++++ docs/zh/blog/README.md | 5 + 32 files changed, 186 insertions(+) diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/alarm.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/alarm.jpg new file mode 100644 index 0000000..ad5c4ad Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/alarm.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/analysis.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/analysis.jpg new file mode 100644 index 0000000..8ae35b2 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/analysis.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/app_tip.png b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/app_tip.png new file mode 100644 index 0000000..cdc7e4b Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/app_tip.png differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/application.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/application.jpg new file mode 100644 index 0000000..3f72db0 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/application.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/application_findmore.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/application_findmore.jpg new file mode 100644 index 0000000..7a41171 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/application_findmore.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/application_heapgc_info.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/application_heapgc_info.jpg new file mode 100644 index 0000000..6882245 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/application_heapgc_info.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/applicationdemo.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/applicationdemo.jpg new file mode 100644 index 0000000..61d9167 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/applicationdemo.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/charles-weixin.png b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/charles-weixin.png new file mode 100644 index 0000000..18f25d4 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/charles-weixin.png differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/charles.png b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/charles.png new file mode 100644 index 0000000..a367412 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/charles.png differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/dashboard.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/dashboard.jpg new file mode 100644 index 0000000..23ae534 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/dashboard.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/dashboarddemo.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/dashboarddemo.jpg new file mode 100644 index 0000000..4f944bf Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/dashboarddemo.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/demo.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/demo.jpg new file mode 100644 index 0000000..638d935 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/demo.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/login.png b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/login.png new file mode 100644 index 0000000..a3e08e0 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/login.png differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/menu.png b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/menu.png new file mode 100644 index 0000000..7b2891e Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/menu.png differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/planet.png b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/planet.png new file mode 100644 index 0000000..82ddab0 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/planet.png differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/service.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/service.jpg new file mode 100644 index 0000000..a19728f Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/service.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/service_tip.png b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/service_tip.png new file mode 100644 index 0000000..e25f591 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/service_tip.png differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/slowtrace.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/slowtrace.jpg new file mode 100644 index 0000000..f5a9f83 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/slowtrace.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/tags_logs.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/tags_logs.jpg new file mode 100644 index 0000000..4ed953b Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/tags_logs.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/time_chooser.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/time_chooser.jpg new file mode 100644 index 0000000..9d71064 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/time_chooser.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/top20slowtrace.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/top20slowtrace.jpg new file mode 100644 index 0000000..4c1e7dd Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/top20slowtrace.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/topology.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/topology.jpg new file mode 100644 index 0000000..99c9213 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/topology.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/topologyMap.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/topologyMap.jpg new file mode 100644 index 0000000..df90c32 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/topologyMap.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/topology_click.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/topology_click.jpg new file mode 100644 index 0000000..4ad2710 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/topology_click.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/topology_search.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/topology_search.jpg new file mode 100644 index 0000000..9cd2457 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/topology_search.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/trace1.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/trace1.jpg new file mode 100644 index 0000000..8b32d8b Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/trace1.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/trace2.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/trace2.jpg new file mode 100644 index 0000000..0991a33 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/trace2.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/traceLog.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/traceLog.jpg new file mode 100644 index 0000000..2cd7e4e Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/traceLog.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/trace_duration.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/trace_duration.jpg new file mode 100644 index 0000000..aeb7af9 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/trace_duration.jpg differ diff --git a/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/trace_search.jpg b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/trace_search.jpg new file mode 100644 index 0000000..38e3983 Binary files /dev/null and b/docs/.vuepress/public/static/blog/2018-12-18-skywalking-net/trace_search.jpg differ diff --git a/docs/zh/blog/2018-12-18-skywalking-net.md b/docs/zh/blog/2018-12-18-skywalking-net.md new file mode 100755 index 0000000..4122b5d --- /dev/null +++ b/docs/zh/blog/2018-12-18-skywalking-net.md @@ -0,0 +1,181 @@ +# Apache SkyWalking 5.0中文版图文详解使用手册 + +作者: 公众号【工匠小猪猪的技术世界】原创 + + + +> 本文纯粹介绍Apache SkyWalking如何使用,面对的群体包括了解和不了解SkyWalking原理的使用者和打算使用者。 + + +# 版本选择 + +我们采用的是5.0.0-RC2的版本,SkyWalking的版本信息可以参考 https://github.com/apache/incubator-skywalking/blob/5.x/CHANGES.md + +那么为什么我们没有采用5.1.0版本呢,这是因为我们公司内部需要支持es x-pack,但是在官方发布里面,没有支持xpack的版本。 + +在Apache SkyWalking官方文档https://github.com/CharlesMaster/incubator-skywalking/tree/master/docs/others/cn中有提到,SkyWalking 5.x 仍受社区支持。 + + +对于用户计划从5.x升级到6.x,您应该知道关于有一些概念的定义的变更。最重要的两个改变了的概念是: + +1. Application(在5.x中)更改为**Service**(在6.x中),Application Instance也更改为**Service Instance**。 +2. Service(在5.x中)更改为Endpoint(在6.x中)。 + + +# 图文详解 +Apache SkyWalking的监控界面由Monitor和Trace两者构成,Monitor菜单又包括Dashbord、Topology、Application、Service、Alarm五个子菜单构成。本文就是围绕这些菜单分别逐一进行介绍。 + +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/menu.png) + + +# Monitor +当用户通过SkyWalking登陆界面使用用户名、密码登陆以后,就会默认进入到SkyWalking的Monitor下的Dashboard界面 + +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/login.png) + + +## Dashboard + +下图就是用户登陆之后都会看到的关键Dashboard页面,在这个页面的下方的关键指标,图中都做了详细的解释。 +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/dashboard.jpg) + + +上图中app需要强调的是,52个app并不代表52个应用,比如paycenter有两台paycenter1和paycenter2就算了2个app,当然还有一些应用是3个以上的。在我们公司,paycenter1、paycenter2这些运维都和我们跳板机管理平台上的名称设置的一样,约定大于配置,开发人员可以更加便捷的排查问题。 +> 再次修正一下,关于dashboard页面的app数,语言类探针,是探针的app_code来决定的。比如我们公司的线上配置就是agent.application_code=auth-center-1 + + +上图中需要解释两个概念: +* cpm代表每分钟请求次数 +* SLA=(TRANSACTION_CALLS- TRANSACTION_ERROR_CALLS ) * 10000 ) / TRANSACTION_CALLS + +该页面主要支持四个跳转: + +一、在上图中,App板块上的帮助选项是可以直接跳转到Application监控页面的。 +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/app_tip.png) + + +二、 Service板块上的帮助选项是可以直接跳转到Service监控页面的。 +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/service_tip.png) + + +三、 Slow Service列表中的每一个慢服务点击以后都会进入到其专项的Service监控页面。 + +四、 Application Throughput列表中的每一个Application点击以后也都是可以进入到其专项的Application监控页面。 + +> 关于Application和Service的详细介绍我们后续会展开 + +在Dashboard的页面上部分,还有一个选择功能模块: +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/time_chooser.jpg) + + +左侧部分可以定期refresh Dashboard的数据,右侧则可以调整整体的查询区间。 + +## Topology + +点击Monitor菜单下的Topology你会看到下面这张拓扑图 + +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/topology.jpg) + + + +当然这张图太过于夸张了,如果接入SkyWalking的应用并不是很多,会如下图所示: +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/topologyMap.jpg) + + + +左侧的三个小按钮可以调整你的视图,支持拖拽。右侧可以输入你所关心的应用名。比如我们输入一个支付和订单两个应用,左侧的拓扑图会变得更加清晰: + +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/topology_search.jpg) + + +另外,上图中的绿色圆圈都是可以点击的,如果你点击以后,还会出现节点信息: +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/topology_click.jpg) + + +## Application + +点击Monitor菜单下的Application你会看到下面这张图,这张图里你可以看到的东西都做了注解。 + +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/application.jpg) + + +这张图里有一个惊喜,就是如果你点开More Server Details,你可以看到更多的信息 + +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/application_findmore.jpg) +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/application_heapgc_info.jpg) + + +是的,除了Host、IPv4、Pid、OS以外,你还可以看到CPU、Heap、Non-Heap、GC(Young GC、Old GC)等详细监控信息。 + + +## Service +点击Monitor菜单下的Service你会看到下面这张图,这张图里你可以看到的同样都做了注解。 +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/service.jpg) + + +关于Dependency Map这张图我们再补充一下,鼠标悬停可以看到每个阶段的执行时间,这是Service下的功能 +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/demo.jpg) + + + +我们点开图中该图中Top 20 Slow Traces下面的被我马赛克掉的trace的按钮框,可以看到如下更加详细的信息: +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/analysis.jpg) + +这些信息可以帮助我们知道每一个方法在哪个阶段那个具体实现耗时了多久。 +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/tags_logs.jpg) + + +如上图所示,每一行基本都是可以打开的,每一行都包含了Tags、Logs等监控内容 + +## Alarm +点击Monitor菜单下的Alarm你会看到告警菜单。目前5.X版本的还没有接入邮件、短信等告警方式,后续6支持webhook,用户可以自己去接短信和邮件。 + +告警内容中你可以看到Applicaion、Server和Service三个层面的告警内容 + +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/alarm.jpg) + + +# Trace +Trace是一个非常实用的功能,用户可以根据精确的TraceId去查找 + +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/trace_search.jpg) + + +也可以设定时间段去查找 + +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/trace_duration.jpg) + + +我在写使用手册时候,非常巧的是,看到了上图三起异常,于是我们往下拉列表看到了具体的数据 + +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/trace2.jpg) + + +点击进去,我们可以看到具体的失败原因 +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/traceLog.jpg) + + +当然用户也可以直接将Trace State调整为Error级别进行查询 + +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/trace1.jpg) + + +# 再回顾一遍 +一、首先我们进入首页: +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/dashboarddemo.jpg) + +二、点击一下首页的Slow Service的projectC,可以看到如下信息: +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/top20slowtrace.jpg) + +三、如果点击首页的Appliation Throughput中的projectD,可以看到如下信息: +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/applicationdemo.jpg) + +四、继续点进去右下角的这个slow service里的Consumer,我们可以看到下图: +![](../../.vuepress/public/static/blog/2018-12-18-skywalking-net/slowtrace.jpg) + + + +# 参考资料 + +https://twitter.com/AsfSkyWalking/status/1013616673218179072 +https://twitter.com/AsfSkyWalking/status/1013617100143800320 \ No newline at end of file diff --git a/docs/zh/blog/README.md b/docs/zh/blog/README.md index c4d16d4..f1efd53 100755 --- a/docs/zh/blog/README.md +++ b/docs/zh/blog/README.md @@ -3,6 +3,11 @@ layout: LayoutBlog blog: +- title: Apache SkyWalking 5.0中文版图文详解使用手册 + name: 2018-12-18-skywalking-net + time: 公众号【工匠小猪猪的技术世界】原创 + short: Apache SkyWalking 5.0 UserGuide + - title: Apache SkyWalking 为.NET Core带来开箱即用的分布式追踪和应用性能监控 name: 2018-05-24-skywalking-net time: 刘浩扬