diff --git a/apm-collector/apm-collector-thirdparty-receiver/receiver-zipkin/docs/README-CN.md b/apm-collector/apm-collector-thirdparty-receiver/receiver-zipkin/docs/README-CN.md new file mode 100644 index 0000000000000000000000000000000000000000..48229b575a619a11d8ffe24e3db78a5ed48d327f --- /dev/null +++ b/apm-collector/apm-collector-thirdparty-receiver/receiver-zipkin/docs/README-CN.md @@ -0,0 +1,24 @@ +# Zipkin接收器 +[Zipkin](http://zipkin.io/)接收器提供了接受Zipkin格式的span数据功能.SkyWalking可以分析、聚合并且将数据展示到可视化界面.因此,用户不需要了解SkyWalking的自动采集探针(Java, .NET, node.js)是如何工作的,或者这些用户因为某些原因不想改变已有的采集方式,例如Zipkin的集成工作已经完成. + +Zipkin接受器在SkyWalking中仅仅只是一个可选特性,即使到目前为止它依然是[孵化特性] +(../../../../docs/cn/Incubating/Abstract-CN.md). + +## 局限性 +作为孵化功能,它仍是一个原型.所以它包含以下几点局限: + +1. 不要在同一分布式系统中使用SkyWalking原生探针和Zipkin的类库。考虑到Zipkin和SkyWalking的HEADER不是共享/可互操作的,它们的两个不会相互传播context.这会导致已跟踪的链接中断 +1. 不支持集群模式. +1. 在进行链路分析时,基于链路会在制定时间内结束。默认链路执行时间不超过2分钟。SkyWalking使用了更复杂的header和context结构,来避免zipkin分析时的这个问题. + +## 打开Zipkin接收器 +Zipkin接收器是一个可选模块,默认是关闭.要打开它,在collector的application.yml配置文件中修改下面的配置项 +```yaml +receiver_zipkin: + default: + host: localhost + port: 9411 + contextPath: / + expireTime: 20 # 单位为秒 + maxCacheSize: 1000000 # traces buffer的大小 +``` diff --git a/docs/README_ZH.md b/docs/README_ZH.md index d97c0bf5a7ae1f065c5c0fab8122b122be09eb25..d31902bf936248f8e592aa47aaccfb409eff0f4d 100644 --- a/docs/README_ZH.md +++ b/docs/README_ZH.md @@ -22,8 +22,9 @@ * [基于Token认证](cn/Token-auth-CN.md) * [添加自定义组件库](cn/Component-libraries-extend-CN.md) * 孵化特性 - * [个性化服务过滤](../apm-sniffer/optional-plugins/trace-ignore-plugin/README_CN.md) + * [孵化特性的由来?](cn/Incubating/Abstract-CN.md) * [使用Shardingjdbc作为存储实现](cn/Use-ShardingJDBC-as-storage-implementor-CN.md) + * [接受Zipkin格式的span数据](../apm-collector/apm-collector-thirdparty-receiver/receiver-zipkin/docs/README-CN.md) * APM相关介绍资料 * [OpenTracing中文版](https://github.com/opentracing-contrib/opentracing-specification-zh) * Application Toolkit,应用程序工具包 diff --git a/docs/cn/Incubating/Abstract-CN.md b/docs/cn/Incubating/Abstract-CN.md new file mode 100644 index 0000000000000000000000000000000000000000..04ce589a20e215ddf98853db256e35a33e4804d3 --- /dev/null +++ b/docs/cn/Incubating/Abstract-CN.md @@ -0,0 +1,11 @@ +# 孵化特性 +孵化的功能特性是由SkyWalking社区人员开发和贡献代码. +目前代码还是原型,或者预览版本,并已经提交到主干代码,并进行发布。同时,功能开发者希望社区更多的开发者参与,对功能进行完善。 + +PMC和Committor团队会评估提交的特性,确保它是否具有移植性,是否兼容当前版本. + +下面是已知的,可能存在的孵化功能: +1. collector提供了新的存储实现,例如:支持 ElasticSearch REST API(HTTP协议),MYSQL...... +1. collector添加新的模块. +1. agent添加新的监控插件. +1. collector集成了一些新的功能和服务.