no message

2016-04-03 10:33:28 +08:00 · 2016-04-03 10:33:28 +08:00 · 243e80b4ac
parent fa80b0f269
commit 243e80b4ac
3 changed files with 38 additions and 86 deletions
--- a/BUILD_DOC.md
+++ b/BUILD_DOC.md
@ -1,27 +1,33 @@
-### 部署第三方软件
+### 部署第三方软件 / Required of third party softwares
 - JDK 1.7
- 安装zookeeper 3.4.6
- 安装apache hbase 1.1.2
- 安装mysql
- 安装tomcat 7
+- zookeeper 3.4.6
+- apache hbase 1.1.2
+- mysql
+- tomcat 7
 - redis-3.0.5

-### 编译安装SkyWalking Server
+### 编译安装SkyWalking Server / Build SkyWalking Server
 - 编译工程
+- build
 ```shell
 $cd github/sky-walking/skywalking-server
 $mvn package -Dmaven.test.skip=true
 $cd github/sky-walking/skywalking-server/target/installer
 ```
 - 拷贝installer到服务器
+- upload installer to server
 - 根据服务器环境修改/config/config.properties
+- config '/config/config.properties'
 ```properties
 #服务器收集数据监听端口
+#server listening port of collecting data
 server.port=34000

 #数据缓存文件目录，请确保此目录有一定的存储容量
+#directory of cache data files. 
 buffer.data_buffer_file_parent_directory=D:/test-data/data/buffer
 #偏移量注册文件的目录，这里为系统绝对路径
+#directory of offset data file
 registerpersistence.register_file_parent_directory=d:/test-data/data/offset

 #hbase zk quorum，hbase的zk地址
@ -30,25 +36,31 @@ hbaseconfig.zk_hostname=10.1.235.197,10.1.235.198,10.1.235.199
 hbaseconfig.client_port=29181

 #告警数据暂存的Redis配置
+#redis ip,port to save alarm data
 alarm.redis_server=10.1.241.18:16379
 ```
 - 启动服务
+- start server
 ```shell
 $cd installer/bin
 $./swserver.sh
 ```
 - 可根据需要部署多个实例
+- Multiple instances can be deployed， according to the needs of processing capacity.
 - 启动服务前，请注意hbase的客户端使用机器名而非ip连接主机，请在server所在机器上正确配置hosts文件，否则会造成数据无法入库

-### 编译安装SkyWalking Alarm
+### 编译安装SkyWalking Alarm / Build SkyWalking Alarm
 - 编译工程
+- build
 ```shell
 $cd github/sky-walking/skywalking-alarm
 $mvn package -Dmaven.test.skip=true
 $cd github/sky-walking/skywalking-alarm/target/installer
 ```
 - 拷贝installer到服务器
+- upload installer to server
 - 根据服务器环境修改/config/config.properties
+- config '/config/config.properties'
 ```properties
 #zookeeper连接地址,用于协调集群，可以和hbase的zookeeper共用
 zkpath.connect_str=10.1.241.18:29181,10.1.241.19:29181,10.1.241.20:29181
@ -65,20 +77,24 @@ db.password=sw_dbusr01
 alarm.redis_server=127.0.0.1:6379
 ```
 - 启动服务
+- start server
 ```shell
 $cd installer/bin
 $./sw-alarm-server.sh
 ```
 - 可根据需要部署多个实例，根据实例启动数量，自动负载均衡
+- Multiple instances can be deployed， according to the needs of processing capacity. Multiple instances will load balance automatically.

-### 编译安装SkyWalking WebUI
+### 编译安装SkyWalking WebUI / Build SkyWalking WebUI
 - 修改配置文件config.properties
+- config 'config.properties'
 ```properties
 #hbase的连接地址
 hbaseconfig.quorum=10.1.235.197,10.1.235.198,10.1.235.199
 hbaseconfig.client_port=29181
 ```
 - 修改配置文件jdbc.properties
+- config 'jdbc.properties'
 ```properties
 #管理数据库的JDBC连接信息
 jdbc.url=jdbc:mysql://10.1.228.202:31316/test
@ -86,29 +102,36 @@ jdbc.username=devrdbusr21
 jdbc.password=devrdbusr21
 ```
 - 编译工程
+- build
 ```shell
 $cd github/sky-walking/skywalking-webui
 $mvn package
 ```
- 初始化管理数据库
-根据[数据库脚本](https://github.com/wu-sheng/sky-walking/blob/master/skywalking-webui/src/main/sql/table.mysql)初始化管理数据库。其中，脚本中如下SQL片段需要修改：
+- 初始化管理数据库，根据[数据库脚本](https://github.com/wu-sheng/sky-walking/blob/master/skywalking-webui/src/main/sql/table.mysql)初始化管理数据库。其中，脚本中如下SQL片段需要修改
+- initialize database using [database-script](https://github.com/wu-sheng/sky-walking/blob/master/skywalking-webui/src/main/sql/table.mysql)
 ```sql
 --配置告警邮件的发送人和SMTP信息
+--set sender and smtp of alarm e-mail
 INSERT INTO `system_config` (`config_id`,`conf_key`,`conf_value`,`val_type`,`val_desc`,`create_time`,`sts`,`modify_time`) VALUES (1000,'mail_info','{\"mail.host\":\"mail.asiainfo.com\",\"mail.transport.protocol\":\"smtp\",\"mail.smtp.auth\":\"true\",\"mail.smtp.starttls.enable\":\"false\",\"mail.username\":\"testA\",\"mail.password\":\"******\",\"mail.account.prefix\":\"@asiainfo.com\"}','json','默认邮件发送人信息','2015-12-10 11:54:06','A','2015-12-10 11:54:06');
 --配置部署页面地址，用于告警邮件内的链接
+--set webui addr of internet
 INSERT INTO `system_config` (`config_id`,`conf_key`,`conf_value`,`val_type`,`val_desc`,`create_time`,`sts`,`modify_time`) VALUES (1001,'portal_addr','http://10.1.235.197:48080/skywalking/','string','默认门户地址','2015-12-10 15:23:53','A','2015-12-10 15:23:53');
 --配置SkyWalking Server的集群地址（内网地址）
+--set LAN addrs of server cluster
 INSERT INTO `system_config` (`config_id`,`conf_key`,`conf_value`,`val_type`,`val_desc`,`create_time`,`sts`,`modify_time`) VALUES (1002,'servers_addr','10.1.235.197:34000;10.1.235.197:35000;','string','日志采集地址','2015-12-10 15:23:53','A','2015-12-10 15:23:53');
 --配置SkyWalking Server的集群地址（外网地址）
+--set internet addrs of server cluster
 INSERT INTO `system_config` (`config_id`,`conf_key`,`conf_value`,`val_type`,`val_desc`,`create_time`,`sts`,`modify_time`) VALUES (1003,'servers_addr_1','60.194.3.183:34000;60.194.3.183:35000;60.194.3.184:34000;60.194.3.184:35000;','string','日志采集地址-外网','2015-12-10 15:23:53','A','2015-12-10 15:23:53');
 ```
 - 上传war包到服务器，启动Tomcat服务器
+- startup tomcat of webui

-### 编译安装SkyWalking Analysis
-暂未提供
+### 编译安装SkyWalking Analysis / Build SkyWalking Analysis
+- 暂未提供
+- next version

-## 使用maven发布各插件工程
- 发布skywalking-sdk-plugin下的各子工程(dubbo-plugin，spring-plugin，web-plugin，jdbc-plugin，httpclient-4.2.x-plugin，httpclient-4.3.x-plugin)
+## 使用maven发布各插件工程 / build and deploy plugins
+- build and deploy skywalking-sdk-plugin(dubbo-plugin，spring-plugin，web-plugin，jdbc-plugin，httpclient-4.2.x-plugin，httpclient-4.3.x-plugin, etc.)
 - 请跳过maven.test环节，避免打包失败
 ```properties
 -Dmaven.test.skip=true
--- a/README.md
+++ b/README.md
@ -64,6 +64,7 @@ SkyWalking: Large-Scale Distributed Systems Tracing Infrastructure, 是一个对
 # Quick Start
 ## 编译与部署 / Build and deploy
 - 参考《[代码编译部署说明](BUILD_DOC.md)》
+- [Code compilation and deployment instructions](BUILD_DOC.md)

 ## 引入核心SDK / Import SDK
 - 无论试用哪种插件，都必须引入
--- a/index.html
+++ b/index.html
@ -1,72 +0,0 @@
-<!DOCTYPE html>
-<html lang="en-us">
-  <head>
-    <meta charset="UTF-8">
-    <title>Sky Walking</title>
-    <meta name="viewport" content="width=device-width, initial-scale=1">
-    <link rel="stylesheet" type="text/css" href="stylesheets/normalize.css" media="screen">
-    <link href='https://fonts.googleapis.com/css?family=Open+Sans:400,700' rel='stylesheet' type='text/css'>
-    <link rel="stylesheet" type="text/css" href="stylesheets/stylesheet.css" media="screen">
-    <link rel="stylesheet" type="text/css" href="stylesheets/github-light.css" media="screen">
-  </head>
-  <body>
-  	  <section class="page-header" style="background-image: url(images/backgroud.png);">
-      <h1 class="project-name">Sky Walking</h1>
-      <h2 class="project-tagline">Distributed Application Tracing System</h2>
-      <a href="https://github.com/wu-sheng/sky-walking" class="btn">View on GitHub</a>
-      <a href="https://github.com/wu-sheng/sky-walking/zipball/master" class="btn">Download .zip</a>
-      <a href="sample-code/uiView.html" class="btn">UI Preview</a>
-      <a href="sample-code/codeView.html" class="btn">How to trace</a>
-    </section>
-
-    <section class="main-content">
-      <h3>
-<a id="什么是sky-walking" class="anchor" href="#%E4%BB%80%E4%B9%88%E6%98%AFsky-walking" aria-hidden="true"><span class="octicon octicon-link"></span></a>什么是Sky Walking?</h3>
-
-<p>他是一个面向分布式系统的全链路监控追踪系统。用于应用集群的分布式调用情况和服务性能监控，负载分布情况的分析系统。</p>
-
-<h3>
-<a id="为什么需要sky-walking" class="anchor" href="#%E4%B8%BA%E4%BB%80%E4%B9%88%E9%9C%80%E8%A6%81sky-walking" aria-hidden="true"><span class="octicon octicon-link"></span></a>为什么需要Sky Walking?</h3>
-<p><img src="images/classicScene.jpeg"/></p>
-<p>目前主流的应用系统或者互联网系统，都是由各种不同职责的系统构成的大规模集群(如上图所示)，通过分布式调用（rest、webservice、dubbo、dubbox、消息等）的模式，支持前台系统。系统间关系复杂，无法预先设计与规划。调用链路繁多，通过日志分析难度很大。<br/>
-<br/>
-分布式系统的开发者和维护人员，希望在系统出现业务错误时，得到邮件通知，并能从全局角度追踪调用关系，而不用在庞大的分布式日志中，寻找关联关系和错误原因。<br/>
-<br/>
-从Google发表自己的Drapper分布式追踪系统的论文发表以来，wiki、淘宝、京东等各家国内外大型互联网公司，都研发了自己的全链路追踪系统。可见此系统在离散的分布式集群中的重要作用。</p>
-<p>
-另外，针对非分布式应用，应用的性能调优也是开发团队头疼问题，全链路监控可以针对应用的各种本地或远程调用，为提高执行效率提供依据。</p>
-
-<h3>
-<a id="sky-walking支持追踪哪些调用" class="anchor" href="#sky-walking%E6%94%AF%E6%8C%81%E8%BF%BD%E8%B8%AA%E5%93%AA%E4%BA%9B%E8%B0%83%E7%94%A8" aria-hidden="true"><span class="octicon octicon-link"></span></a>Sky Walking支持追踪哪些调用?</h3>
-
-<p>Sky Walking已开放底层API的方式，支持对java程序的本地调用、远程调用（同步/异步）、多线程运行的追踪监控<br/>
-为了方便使用，计划在初期，开发以下常用的插件，更方便的进行追踪监控<br/>
-1.web调用<br/>
-2.jdbc调用<br/>
-3.dubbo/dubbox<br/>
-4.Spring本地方法调用<br/>
-5.公司内部封装的内部服务<br/>
-6.应用可自行封装的各种调用</p>
-
-<h3>
-<a id="sky-walking目前的进展情况" class="anchor" href="#sky-walking%E7%9B%AE%E5%89%8D%E7%9A%84%E8%BF%9B%E5%B1%95%E6%83%85%E5%86%B5" aria-hidden="true"><span class="octicon octicon-link"></span></a>Sky Walking目前的进展情况?</h3>
-<p><b>1.0-alpha2(on developing):</b><br/>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;1.支持链路的识别，分析归类，汇总调用次数、成功率、QPS等指标<br/>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;2.webui展现链路分析报告<br/>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;3.log4j和log4j2扩展，能在日志中快速展现tid</p>
-<p><b>1.0-alpha1(released):</b><br/>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;1.支持链路追踪、上下文传递、追踪日志持久化。<br/>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;2.追踪插件支持web filter, JDBC(MySQL Driver, other driver extend api), dubbo, dubbox(2.8.4/below 2.8.3), apache httpclient(4.2/4.3), spring context<br/>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;3.webui展现调用轨迹、耗时、状态等。<br/>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;4.支持异常调用的识别，并通过邮件告警<br/></p>
-
-
-      <footer class="site-footer">
-        <span class="site-footer-owner"><a href="https://github.com/wu-sheng/sky-walking">Sky Walking</a> is maintained by <a href="https://github.com/wu-sheng">吴晟</a>，<a href="https://github.com/ascrutae">张鑫</a>，<a href="https://github.com/tanzhen84">谭真</a>.</span>
-      </footer>
-
-    </section>
-
-  
-  </body>
-</html>