@@ -12,7 +12,7 @@ uplink data to the SkyWalking backend.
...
@@ -12,7 +12,7 @@ uplink data to the SkyWalking backend.
v1.1
v1.1
#### gRPC proto files
#### gRPC proto files
[gRPC proto files](../../apm-protocol/apm-network/src/main/proto)
[gRPC proto files](https://github.com/apache/incubator-skywalking-data-collect-protocol/tree/v1.1.1)
## Collector discovery service
## Collector discovery service
### Abstract
### Abstract
...
@@ -34,7 +34,7 @@ JSON Array. Each element in the array ia a valid gRPC service address.
...
@@ -34,7 +34,7 @@ JSON Array. Each element in the array ia a valid gRPC service address.
### Abstract
### Abstract
Register Application Code to the backend, and receive an integer represents the application.
Register Application Code to the backend, and receive an integer represents the application.
[gRPC service define](../..apm-protocol/apm-network/src/main/proto/ApplicationRegisterService.proto)
[gRPC service define](https://github.com/apache/incubator-skywalking-data-collect-protocol/blob/v1.1.1/ApplicationRegisterService.proto)
- applicationCode is the config in your `agent.config`.
- applicationCode is the config in your `agent.config`.
- The return id is **ApplicationId** as the value in `KeyWithIntegerValue`, which will be used in further data uplink.
- The return id is **ApplicationId** as the value in `KeyWithIntegerValue`, which will be used in further data uplink.
...
@@ -42,13 +42,13 @@ Register Application Code to the backend, and receive an integer represents the
...
@@ -42,13 +42,13 @@ Register Application Code to the backend, and receive an integer represents the
## Discovery Service
## Discovery Service
### Register Instance Service
### Register Instance Service
[gRPC service define](../../apm-protocol/apm-network/src/main/proto/DiscoveryService.proto#L11-L12)
[gRPC service define](https://github.com/apache/incubator-skywalking-data-collect-protocol/blob/v1.1.1/DiscoveryService.proto#L29)
- agentUUID generated by agent, should be unique. Stay same before reboot, at least.
- agentUUID generated by agent, should be unique. Stay same before reboot, at least.
-**ApplicationInstanceId** will be used in further data uplink.
-**ApplicationInstanceId** will be used in further data uplink.
### Heart beat service
### Heart beat service
[gRPC service define](../../apm-protocol/apm-network/src/main/proto/DiscoveryService.proto#L14-L15)
[gRPC service define](https://github.com/apache/incubator-skywalking-data-collect-protocol/blob/v1.1.1/DiscoveryService.proto#L32)
- Recommend to report heart beat every 20-60 seconds.
- Recommend to report heart beat every 20-60 seconds.
- Java agent don't use this, because JVM metrics upstream replace the capabilities of this.
- Java agent don't use this, because JVM metrics upstream replace the capabilities of this.
...
@@ -57,7 +57,7 @@ Register Application Code to the backend, and receive an integer represents the
...
@@ -57,7 +57,7 @@ Register Application Code to the backend, and receive an integer represents the
### Abstract
### Abstract
Replace the literal String service(operation) name by an id(integer)
Replace the literal String service(operation) name by an id(integer)
[gRPC service define](../../apm-protocol/apm-network/src/main/proto/DiscoveryService.proto#L53-L74)
[gRPC service define](.https://github.com/apache/incubator-skywalking-data-collect-protocol/blob/v1.1.1/DiscoveryService.proto#L70)
- Optional service, reduce the network cost but use more memory as a buffer mapping.
- Optional service, reduce the network cost but use more memory as a buffer mapping.
...
@@ -65,7 +65,7 @@ Replace the literal String service(operation) name by an id(integer)
...
@@ -65,7 +65,7 @@ Replace the literal String service(operation) name by an id(integer)
### Abstract
### Abstract
Network Address includes all remove service address, includes ip, port, hostname, etc., which used in RPC framework, MQ, DB, etc.
Network Address includes all remove service address, includes ip, port, hostname, etc., which used in RPC framework, MQ, DB, etc.
[gRPC service define](../../apm-protocol/apm-network/src/main/proto/NetworkAddressRegisterService.proto)
[gRPC service define](https://github.com/apache/incubator-skywalking-data-collect-protocol/blob/v1.1.1/NetworkAddressRegisterService.proto)
- Optional service, reduce the network cost but use more memory as a buffer mapping.
- Optional service, reduce the network cost but use more memory as a buffer mapping.
...
@@ -73,10 +73,10 @@ Network Address includes all remove service address, includes ip, port, hostname
...
@@ -73,10 +73,10 @@ Network Address includes all remove service address, includes ip, port, hostname
### Abstract
### Abstract
Uplink the JVM metrics, including PermSize, HeapSize, CPU, Memory, etc., every second.
Uplink the JVM metrics, including PermSize, HeapSize, CPU, Memory, etc., every second.
[gRPC service define](../../apm-protocol/apm-network/src/main/proto/JVMMetricsService.proto)
[gRPC service define](https://github.com/apache/incubator-skywalking-data-collect-protocol/blob/v1.1.1/JVMMetricsService.proto)
## Trace Segment Service
## Trace Segment Service
[gRPC service define](../../apm-protocol/apm-network/src/main/proto/TraceSegmentService.proto)
[gRPC service define](https://github.com/apache/incubator-skywalking-data-collect-protocol/blob/v1.1.1/TraceSegmentService.proto)
- UniqueId represents segmentId and globalTraceId. It have 3 parts(Longs), 1) applicationInstanceId, 2) ThreadId, 3) Timestamp + 10000 + seq(seq is in [0, 100000) )
- UniqueId represents segmentId and globalTraceId. It have 3 parts(Longs), 1) applicationInstanceId, 2) ThreadId, 3) Timestamp + 10000 + seq(seq is in [0, 100000) )
- Span data please refs to [Plugin Development Guide](Plugin-Development-Guide.md)
- Span data please refs to [Plugin Development Guide](Plugin-Development-Guide.md)