This topic describes how to install the Jaeger agent.

Step 1: Obtain an endpoint in the ARMS console

  1. Log on to the Application Real-Time Monitoring Service (ARMS) console. In the left-side navigation pane, choose Tracing Analysis > Cluster Configurations.
  2. Select a region in the top navigation bar. Click the Access point information tab. Then, turn on Show Token for the Cluster Information parameter.
  3. Set the Client parameter to the client that you want to use to collect trace data. In this example, select Jaeger.
  4. In the Related Information column of the table in the lower part, click the copy icon next to the endpoint that you want to use.
    Jaeger endpoints
    Note If your application is deployed in an Alibaba Cloud production environment, select a private endpoint. Otherwise, select a public endpoint.

Step 2: Download and start the Jaeger agent

For 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 in the startup command with --jaeger.tags.
    • Replace <endpoint> with the endpoint for Jaeger that you selected in the specified region on the Overview page in the Tracing Analysis console.
    • Replace <token> with the endpoint that you obtained in Step 1.

For 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 \
  --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 in the command 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 for Jaeger that you selected in the specified region on the Overview page in the Tracing Analysis console.
  • Replace <token> with the endpoint that you obtained in Step 1.