All Products
Search
Document Center

Managed Service for OpenTelemetry:Install the Jaeger agent

Last Updated:May 14, 2024

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 Managed Service for OpenTelemetry console.

  2. In the left-side navigation pane, click Cluster Configurations. On the page that appears, click the Access point information tab.

  3. In the top navigation bar, select a region. In the Cluster Information section, turn on Show Token.

  4. Set the Client parameter to Jaeger or Zipkin. In this example, Jaeger is selected.

    Obtain an endpoint of Jaeger or Zipkin in the Related Information column of the table in the lower part.

    Jaeger/Zipkin接入点信息

    Note

    If your application is deployed in an Alibaba Cloud production environment, use a VPC endpoint. Otherwise, use a public endpoint. Generally, use the endpoint of v2 for Zipkin. Use the endpoint of v1 only if you know Zipkin well.

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.