You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@skywalking.apache.org by GitBox <gi...@apache.org> on 2018/12/20 04:17:41 UTC

[GitHub] JaredTan95 closed pull request #13: add md & pictures for a new blog item "Apache SkyWalking 5.0 Chinese …

JaredTan95 closed pull request #13: add md & pictures for a new blog item "Apache SkyWalking 5.0 Chinese …
URL: https://github.com/apache/incubator-skywalking-website/pull/13
 
 
   

This is a PR merged from a forked repository.
As GitHub hides the original diff on merge, it is displayed below for
the sake of provenance:

As this is a foreign pull request (from a fork), the diff is supplied
below (as it won't show otherwise due to GitHub magic):

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: 刘浩扬


 

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services