1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
|
# OpenTelemetry C++ Example
## gRPC
This is a simple example that demonstrates tracing a gRPC request from client to
server. There is an experimental directory in this example - the code within has
been commented out to prevent any conflicts. The example shows several aspects
of tracing such as:
* Using the `TracerProvider`
* Implementing the TextMapCarrier
* Context injection/extraction
* Span Attributes
* Span Semantic Conventions
* Using the ostream exporter
* Nested spans
* W3c Trace Context Propagation (Very soon!)
### Running the example
1. The example uses gRPC C++ as well as Google's protocol buffers. Make sure you
have installed both of these packages on your system, in such a way that
CMake would know how to find them with this command:
``find_package(gRPC)``
2. Build and Deploy the opentelemetry-cpp as described in
[INSTALL.md](../../INSTALL.md). Building the project will build all of the
examples and create new folders containing their executables within the
'build' directory NOT the 'examples' directory.
3. Start the server from your `build/examples/grpc` directory. Both the server
and client are configured to use 8800 as the default port, but if you would
like to use another port, you can specify that as an argument.
```console
$ ./server [port_num]
Server listening on port: 0.0.0.0:8800
```
4. In a separate terminal window, run the client to make a single request:
```console
$ ./client [port_num]
...
```
5. You should see console exporter output for both the client and server
sessions.
* Client console
```console
{
name : GreeterClient/Greet
trace_id : f5d16f8399be0d2c6b39d992634ffdbb
span_id : 9c79a2dd744d7d2d
tracestate :
parent_span_id: 0000000000000000
start : 1622603339918985700
duration : 4960500
description :
span kind : Client
status : Ok
attributes :
rpc.grpc.status_code: 0
net.peer.port: 8080
net.peer.ip: 0.0.0.0
rpc.method: Greet
rpc.service: grpc-example.GreetService
rpc.system: grpc
events :
}
```
* Server console
```console
{
name : GreeterService/Greet
trace_id : f5d16f8399be0d2c6b39d992634ffdbb
span_id : 1e8a7d2d46e08573
tracestate :
parent_span_id: 9c79a2dd744d7d2d
start : 1622603339923163800
duration : 76400
description :
span kind : Server
status : Ok
attributes :
rpc.grpc.status_code: 0
rpc.method: Greet
rpc.service: GreeterService
rpc.system: grpc
events :
{
name : Processing client attributes
timestamp : 1622603339923180800
attributes :
}
{
name : Response sent to client
timestamp : 1622603339923233700
attributes :
}
links :
}
```
|
