grpc/examples/cpp/otel/README.md

gRPC C++ OpenTelemetry Example

The opentelemetry example builds on the Hello World Example and changes the gRPC client and server to show a sample way of configuring the gRPC OpenTelemetry plugin with a prometheus exporter.

For more information on the gRPC OpenTelemetry plugin, please refer to - * A66: OpenTelemetry Metrics

• https://opentelemetry.io/

Running the example

To run the server -

$ tools/bazel run examples/cpp/otel:greeter_callback_server

To run the client -

$ tools/bazel run examples/cpp/otel:greeter_callback_client

The client continuously sends an RPC to the server every second.

To make sure that the server and client metrics are being exported properly, in a separate terminal, run the following -

$ curl localhost:9464/metrics

$ curl localhost:9465/metrics

NOTE: If the prometheus endpoint configured is overridden, please update the target in the above curl command.

CMake Instructions

The following libraries need to be installed before building the example with CMake -

• absl
• protobuf
• prometheus-cpp
• opentelemetry-cpp (with the options -DWITH_ABSEIL=ON -DWITH_PROMETHEUS=ON)
• grpc (with the option -DgRPC_BUILD_GRPCPP_OTEL_PLUGIN=ON)

You can find a complete set of instructions for building gRPC and running the Hello World app in the C++ Quick Start.