skywalking-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From wush...@apache.org
Subject [incubator-skywalking] branch document/advanced updated: Add namespace document.
Date Mon, 02 Apr 2018 04:01:51 GMT
This is an automated email from the ASF dual-hosted git repository.

wusheng pushed a commit to branch document/advanced
in repository https://gitbox.apache.org/repos/asf/incubator-skywalking.git


The following commit(s) were added to refs/heads/document/advanced by this push:
     new f997154  Add namespace document.
f997154 is described below

commit f997154a1c1bd6f761a2e1dcb4486b11bcabb8b4
Author: wu-sheng <wu.sheng@foxmail.com>
AuthorDate: Mon Apr 2 12:01:14 2018 +0800

    Add namespace document.
---
 .../src/main/resources/application.yml             |  1 +
 apm-sniffer/config/agent.config                    |  3 ++
 docs/README.md                                     |  5 +--
 docs/en/{direct-uplink.md => Direct-uplink.md}     |  3 ++
 docs/en/Namespace.md                               | 39 ++++++++++++++++++++++
 5 files changed, 49 insertions(+), 2 deletions(-)

diff --git a/apm-collector/apm-collector-boot/src/main/resources/application.yml b/apm-collector/apm-collector-boot/src/main/resources/application.yml
index bcaa653..a3a33ea 100644
--- a/apm-collector/apm-collector-boot/src/main/resources/application.yml
+++ b/apm-collector/apm-collector-boot/src/main/resources/application.yml
@@ -70,6 +70,7 @@ storage:
 #    user_name: sa
 configuration:
   default:
+    # namespace: xxxxx
     application_apdex_threshold: 2000
     service_error_rate_threshold: 10.00
     service_average_response_time_threshold: 2000
diff --git a/apm-sniffer/config/agent.config b/apm-sniffer/config/agent.config
index 24f1ec9..dcf6afa 100644
--- a/apm-sniffer/config/agent.config
+++ b/apm-sniffer/config/agent.config
@@ -14,6 +14,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# The agent namespace
+# agent.namespace=default-namespace
+
 # The application name in UI
 agent.application_code=Your_ApplicationName
 
diff --git a/docs/README.md b/docs/README.md
index 4d48c5f..8dc6b47 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -6,9 +6,10 @@
     * [Supported middlewares, frameworks and libraries](Supported-list.md)
       * [How to disable plugins?](en/How-to-disable-plugin.md)
   * Advanced Features
-    * [Direct uplink and disable naming discovery](en/direct-uplink.md)
+    * [Direct uplink and disable naming discovery](en/Direct-uplink.md)
     * [Open TLS](en/TLS.md)
-    * Namespace Isolation
+    * [Namespace Isolation](en/Namespace.md)
+    * [Token Authentication]
   * Application Toolkit
     * [Overview](en/Applicaton-toolkit.md)
     * [OpenTracing Tracer](en/Opentracing.md)
diff --git a/docs/en/direct-uplink.md b/docs/en/Direct-uplink.md
similarity index 97%
rename from docs/en/direct-uplink.md
rename to docs/en/Direct-uplink.md
index d82220f..11f49bb 100644
--- a/docs/en/direct-uplink.md
+++ b/docs/en/Direct-uplink.md
@@ -1,4 +1,7 @@
 # Direct uplink
+## Supported version
+5.0.0-beta +
+
 ## What is direct uplink?
 In default, SkyWalking agent uses naming service to find all collector addresses. Then connect
to gRPC services.
 
diff --git a/docs/en/Namespace.md b/docs/en/Namespace.md
new file mode 100644
index 0000000..d5e9fa5
--- /dev/null
+++ b/docs/en/Namespace.md
@@ -0,0 +1,39 @@
+# Namespace
+## Supported version
+5.0.0-beta +
+
+## Background
+SkyWalking is a monitoring tool, which collects metrics from a distributed system. In the
real world, a very large distributed system
+includes hundreds of application, thousands of application instance. In that case, more likely,
more than one group, 
+even than one company are maintaining and monitoring the distributed system. Each one of
them takes charge of different parts,
+don't or can't share there metrics.
+
+Namespace is proposal from this.It is used for tracing and monitoring isolation.
+
+## Set the namespace
+### Set agent.namespace in agent config
+```properties
+# The agent namespace
+# agent.namespace=default-namespace
+``` 
+
+The default value of `agent.namespace` is empty. 
+
+**Influence**
+The default header key of SkyWalking is `sw3`, more in this [document](Skywalking-Cross-Process-Propagation-Headers-Protocol-v1.md).
+After `agent.namespace` set, the key changes to `namespace:sw3`.
+
+The across process propagation chain breaks, when the two sides are using different namespace.
+
+### Set namespace in collector
+```yml
+configuration:
+  default:
+    namespace: xxxxx
+```
+
+**Influences**
+1. If cluster model is active, with zookeeper implementation, The path in zookeeper is changed
to include namespace prefix path.
+1. If use Elasticsearch as storage implementation, all type names are changed to include
namespace prefix.
+
+

-- 
To stop receiving notification emails like this one, please contact
wusheng@apache.org.

Mime
View raw message