Install the Jaeger agent

Updated at:

Managed Service for OpenTelemetry allows you to use OpenTelemetry, Jaeger, Zipkin, and SkyWalking clients to report application trace data to the console. This topic describes how to install the Jaeger agent.

Step 1: Obtain an endpoint

  1. Log on to the ARMS console. In the left-side navigation pane, click Integration Center.

  2. In the Server-side Applications area, click the Jaeger card.

  3. In the Jaeger panel, select the region where you want to report data.

    Note

    Resources are automatically provisioned the first time you access a region.

  4. Select a Connection Type and an Export Protocol, and then copy the endpoint information.

    • Connection Type: If your service is deployed on Alibaba Cloud and its region is the same as the selected integration region, use the Alibaba Cloud VPC network. Otherwise, use the public network.

    • Export Protocol: Select the protocol that your client supports. For example, you can select gRPC.

    68

Step 2: Download and start the Jaeger agent

ECS clusters

If your application is deployed in an Elastic Compute Service (ECS) cluster, you can start the Jaeger agent by performing the following operations:

  1. Download and decompress the installation package of the Jaeger agent.

    Note

    We recommend that you download the latest version of the Jaeger agent.

  2. Run the following command to start the Jaeger agent:

    nohup ./jaeger-agent --reporter.grpc.host-port=<endpoint> --agent.tags=<token>
    Note
    • If your Jaeger agent is of V1.15.0 or an earlier version, replace --agent.tags with --jaeger.tags.

    • Replace <endpoint> with the endpoint that you obtained in Step 1.

    • Replace <token> with the token that you obtained in Step 1.

Docker containers

If your application is deployed in a Docker container, we recommend that you start the Jaeger agent by running the docker run command. This reduces your O&M costs. Run the following command to start the Jaeger agent:

docker run -d\
  --rm \
  -p5775:5775/udp \
  -p6831:6831/udp \
  -p6832:6832/udp \
  -p5778:5778/tcp \
  jaegertracing/jaeger-agent:<version> \
  --reporter.grpc.host-port=<endpoint> \
  --agent.tags=<token>
Note

Perform the following operations on the parameters in the docker run command:

  • If your Jaeger agent is of V1.15.0 or an earlier version, replace --agent.tags with --jaeger.tags.

  • Replace <version> with the version of the Jaeger agent, such as 1.23. For more information about other available versions, visit jaegertracing/jaeger-agent.

  • Replace <endpoint> with the endpoint that you obtained in Step 1.

  • Replace <token> with the token that you obtained in Step 1.