This is not the latest version of Linkerd!
This documentation is for an older version of Linkerd. You may want the Linkerd 2.12 (current) documentation instead.

jaeger

jaeger manages the jaeger extension of Linkerd service mesh.

Subcommands

check

Check the Jaeger extension for potential problems.

The check command will perform a series of checks to validate that the Jaeger extension is configured correctly. If the command encounters a failure it will print additional information about the failure and exit with a non-zero exit code.

Examples

# Check that the Jaeger extension is up and running
linkerd jaeger check

Flags

Flag Usage
--namespace
-n
Namespace to use for –proxy checks (default: all namespaces)
--output
-o
Output format. One of: basic, json
--proxy Also run data-plane checks, to determine if the data plane is healthy
--wait Maximum allowed time for all tests to pass

dashboard

Open the Jaeger extension dashboard in a web browser

Flags

Flag Usage
--address The address at which to serve requests
--port
-p
The local port on which to serve requests (when set to 0, a random port will be used)
--show-url show only URL in the CLI, and do not open the browser
--wait Wait for dashboard to become available if it’s not available when the command is run

install

Output Kubernetes resources to install jaeger extension.

Examples

# Default install.
linkerd jaeger install | kubectl apply -f -
# Install Jaeger extension into a non-default namespace.
linkerd jaeger install --namespace custom | kubectl apply -f -

The installation can be configured by using the --set, --values, --set-string and --set-file flags.
A full list of configurable values can be found at https://www.github.com/linkerd/linkerd2/tree/main/jaeger/charts/linkerd-jaeger/README.md

Flags

Flag Usage
--set set values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
--set-file set values from respective files specified via the command line (can specify multiple or separate values with commas: key1=path1,key2=path2)
--set-string set STRING values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
--skip-checks Skip checks for linkerd core control-plane existence
--values
-f
specify values in a YAML file or a URL (can specify multiple)
--wait Wait for core control-plane components to be available

list

Lists which pods have tracing enabled

Flags

Flag Usage
--all-namespaces
-A
If present, list pods across all namespaces
--namespace
-n
The namespace to list pods in

uninstall

Output Kubernetes resources to uninstall the Linkerd-jaeger extension.

This command provides all Kubernetes namespace-scoped and cluster-scoped resources (e.g services, deployments, RBACs, etc.) necessary to uninstall the Linkerd-jaeger extension.

Examples

linkerd uninstall | kubectl delete -f -