Generate Cluster Reports

As of version 1.9.7, SingleStore Toolbox supports generating cluster reports via the Kube API for Kubernetes.

Note

Toolbox must be installed on the same Linux host that has Kube API access to the cluster. This is a requirement as the Kube config is first used to make the connection, and then generate and pull the report.

The instructions for installing Toolbox are provided below.

To generate cluster reports, the sdb-report binary is required, which is part of SingleStore Toolbox. You can obtain this binary in one of two ways:

  1. Install SingleStore Toolbox. Refer to Install SingleStore Toolbox for installation instructions.

  2. Use the singlestore/tools Docker image.

Note

Select the method based on where you plan to run the report collection. Refer to Generate a Cluster Report for more information.

Install SingleStore Toolbox

Generate a Cluster Report

There are two methods to run the sdb-report collect-kube command to generate a cluster report.

Method 1: External (Using Kubeconfig)

Run the following command from any host where you can execute kubectl commands. This method uses a kubeconfig file for authentication.

  • The sdb-report binary from Toolbox or a Docker image.

  • The Kubeconfig file can be specified using the KUBECONFIG environment variable or the --config-file flag.

  • The kubectl command which has access to the cluster.

sdb-report collect-kube --namespace <namespace> --cluster-name <cluster-name>

To generate a cluster report, run the following command. The name of the cluster can be found by running kubectl get singlestore.

Note

If the Operator logs are missing, run the following command.

kubectl label deployment <operator> app.kubernetes.io/component=operator

Refer to sdb-report collect-kube for more information.

Method 2: In-Cluster (From Within a Pod)

Run the following command from within a Kubernetes Pod using in-cluster configuration. This method does not require configuration files.

  • A Pod with the sdb-report binary available (for example, using the singlestore/tools Docker image)

  • A service account with the required permissions for Kubernetes API calls (such as listing Pods)

Note

The SingleStore node image does not include the sdb-report binary. To use this method, use a Pod with the singlestore/tools image or copy the binary into a node Pod using kubectl cp.

sdb-report collect-kube --namespace <namespace> --cluster-name <cluster-name>

To generate a cluster report, run the following command. The name of the cluster can be found by running kubectl get singlestore.

Note

If the Operator logs are missing, run the following command.

kubectl label deployment <operator> app.kubernetes.io/component=operator

Refer to sdb-report collect-kube for more information.

Last modified:

Was this article helpful?