skywalking-java/README.md

Sky Walking

SkyWalking: Large-Scale Distributed Systems Tracing Infrastructure, also known Distributed Tracer。

Abstract

• An open source Large-Scale Distributed Systems Tracing Infrastructure, also known a ditributed tracer.
• Based on Google Dapper Paper: Dapper, a Large-Scale Distributed Systems Tracing Infrastructure, Simplified Chines
• Supports popular rpc frameworks, such as dubbo, dubbox, motan etc., supports email-alert when application occurs unexpected exception。
• Execution time of creating span than 100μs.
• Easy to deploy, even in product mode ( since 2.x ) . No need of Hadoop, HBase, or Cassandra Cluster.

Supported components

• web container
  • Tomcat7
  • Tomcat8
• database
  • mysql
  • oracle
  • h2
  • easily extend to support sybase, sqlserver, jtds, db2, informix
• rpc framework
  • dubbo (tested 2.5.3)
  • dubbox (tested 2.8.4-dubbo protocol, 2.8.4-rest protocol)
  • httpClient 4.x
  • motan (tested 0.1.2)
• cache
  • jedix 2.x

Contributors

• 吴晟 wusheng   wu.sheng@foxmail.com
• 张鑫 zhangxin   

---

In October 2016, Sky Walking won OneAPM Open Source Achievement Award. The award appreciates sky walking for its "contribution to popularization of APM technology".
OneAPM will provide financial support for the project in 2016-2017.

Thanks all users of sky walking project.

---

Discussion

* Mail to：wu.sheng@foxmail.com * QQ Group：392443393 * If you are using SkyWalking，[Report to us](https://github.com/wu-sheng/sky-walking/issues/34) please. * **Developer Org of sky-walking** is https://github.com/skywalking-developer

整体架构图

典型页面展现 / Typical UI show

• 支持浏览器：Firefox/Chrome

实时调用链路

• 实时链路追踪展现
• 实时链路追踪详细信息查看
• 实时链路追踪日志查看
• 实时链路异常告警邮件
• 添加应用
• 应用列表展现

分析汇总

• 分析结果查询，根据viewpoint模糊匹配查询。查询方式为viewpoint: + 关键字
• 分析结果展现，通过分析结果查询页面点击进入
• 分析典型调用链展现

v2.0-2016 Quick Start

Required of third party softwares

• JDK 1.8
• zookeeper 3.4.6
• mysql
• redis-3.0.5

instrument javaagent jdk version

• support 1.6+ , instruments applications can run in jdk6

Download and deploy servers

• Download Server release version. Download (.tar.gz)

run all servers in a Docker

• Docker version is good quick-test.

deploy your own cluster

Download agent

start application with -javaagent

java -jar ...  -javaagent:/..ospath../skywalking-agent-x.x.jar

Recent RoadMap

• [In the schedule] v2.1-2017

  • release a version following OpenTracing.io
  • provide bridge mode lib to integrate data of system and tracer
  • provide English doc as default. Also provide Chinese version on Gitbook or Wiki
  • support log framework(log4j, log4j2, logback) to output traceid in system log.

• [Dev] v2.0-2016

  • not dependency on Hadoop or HBase, easy to deploy or maintenance
  • support simple-cluster mode
  • support docker mode in single-server-instance
  • support more plugins
    • motan rpc framework (provided)