Check the Linkerd installation for potential problems.
The check command will perform a series of checks to validate that the linkerd CLI and control plane are configured correctly. If the command encounters a failure it will print additional information about the failure and exit with a non-zero exit code.
Take a look at the troubleshooting documentation for a full list of all the possible checks, what they do and how to fix them.
# Check that the Linkerd control plane is up and running linkerd check # Check that the Linkerd control plane can be installed in the "test" namespace linkerd check --pre --linkerd-namespace test # Check that "linkerd install config" succeeded linkerd check config # Check that the Linkerd data plane proxies in the "app" namespace are up and running linkerd check --proxy --namespace app
$ linkerd check kubernetes-api -------------- √ can initialize the client √ can query the Kubernetes API kubernetes-version ------------------ √ is running the minimum Kubernetes API version linkerd-existence ----------------- √ control plane namespace exists √ controller pod is running √ can initialize the client √ can query the control plane API linkerd-api ----------- √ control plane pods are ready √ control plane self-check √ [kubernetes] control plane can talk to Kubernetes √ [prometheus] control plane can talk to Prometheus linkerd-service-profile ----------------------- √ no invalid service profiles linkerd-version --------------- √ can determine the latest version √ cli is up-to-date control-plane-version --------------------- √ control plane is up-to-date √ control plane and cli versions match Status check results are √
||Used to override the version of the cli (mostly for testing)|
||Overrides the version used when checking if Linkerd is running the latest version (mostly for testing)|
||When running pre-installation checks (–pre), assume the linkerd-cni plugin is already installed, and a NET_ADMIN check is not needed|
||Namespace to use for –proxy checks (default: all namespaces)|
||Output format. One of: basic, json, short|
||Only run pre-installation checks, to determine if the control plane can be installed|
||Only run data-plane checks, to determine if the data plane is healthy|
||Maximum allowed time for all tests to pass|
Check supports subcommands as part of the Multi-stage install feature.
Check the Linkerd cluster-wide resources for potential problems.
The check command will perform a series of checks to validate that the Linkerd cluster-wide resources are configured correctly. It is intended to validate that “linkerd install config” succeeded. If the command encounters a failure it will print additional information about the failure and exit with a non-zero exit code.
# Check that the Linkerd cluster-wide resource are installed correctly linkerd check config