jaeger

You are viewing docs for an older version of Linkerd. View the latest docs.

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
`--ignore-cluster`	Ignore the current Kubernetes cluster when checking for existing cluster configuration (default false)
`--registry`	Docker registry to pull jaeger-webhook image from ($LINKERD_DOCKER_REGISTRY)
`--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 -