Jaeger

The integration with Open Telemetry is completely native, in the Devprime platform, simplifying the journey of the software developer with the use of this resource, which adds a lot of value in the distributed systems scenario, allowing you to track a business process in all the microservices involved.

The leading cloud platforms in the market are already supporting OpenTelemetry, which facilitates adoption in the production environment. There is the option to use it on kubernetes or any other managed solution.

In the context of our demo, we’ll use a local docker container to have the data collector and the Jaeger tool.

Follow the steps below:

1. Install the Devprime CLI.

2. Initialize the Jaeger container provided in the docker documentation.

3. Clone the repository with the two microservices (ms-order/ms-payment) or deploy manually.
   git clone https://github.com/devprime/devprime-microservices-order-payment.git.

a) Open the file in Visual Studio Code inside the microservice folder
code src/App/appsettings.json

b) Open the Observability switch and verify that the Enable option is true. Then go to the Trace option and set the Enable to true, Type to zipkin and the Endpoint with the url of the service. In on-premises docker, the url has the default value of “http://localhost:9411/api/v2/spans”.

 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

 "Devprime_Observability": {
    "Enable": "true",
    "Log": {
      "Enable": "true",
      "Save": "false",
      "Type": "text",
      "FileSize": "5242880",
      "HideDetails": "false",
      "HideDateTime": "false",
      "ShowAppName": "false",
      "Path": "",
      "ShowHttpErrors": "400",
      "Export": {
        "Enable": "false",
        "Type": "seq",
        "Host": "http://localhost:5341",
        "ApiKey": "your api key",
        "ControlLevelSwitch": "Information"
      }
    },
    "Metrics": {
      "Enable": "false"
    },
    "Trace": {
      "enable": "true",
      "Type": "Jaeger",
      "Host": "localhost",
      "Port": "6831",
      "Endpoint": "http://localhost:14268",
      "Protocol": "UdpCompactThrift"
    }
  },

4. Update the Stack by running on the main folder to detect both microservices
   dp stack

5. Run the ‘ms-order’ microservice and notice in the log that the configured Open Telemetry information will already be up and running. The log already demonstrates that the Trace is set to Enable and the Type is set to “Jaeger”.

1
2

[App][Observability]["Enable"][Log "Enable"][Export "Disable"]
[Trace "Enable"][Type "jaeger"][Metrics "Disable"]

Tracking the tracing of two or more microservices

1. Run the ms-order and ms-payment microservice
2. Open in the browser in http://localhost:5000 and make one or more posts in /v1/order
3. Open Jaeger in the browser in http://localhost:16686 and view

4. Check all the details of the processing

Legal information:
Jaeger is an open-source tool that is compatible with the Open Telemetery standard. For any information on licensing and use, we recommend the manufacturer.