Home  /  Installation

Troubleshooting

Troubleshooting Kubernetes

Materialize operator

To check the status of the Materialize operator:

kubectl -n materialize get all

If you encounter issues with the Materialize operator,

  • Check the operator logs, using the label selector:

    kubectl -n materialize logs -l app.kubernetes.io/name=materialize-operator

  • Check the log of a specific object (pod/deployment/etc) running in your namespace:

    kubectl -n materialize logs <type>/<name>

    In case of a container restart, to get the logs for previous instance, include the --previous flag.

  • Check the events for the operator pod:

    • You can use kubectl describe, substituting your pod name for <pod-name>:

      kubectl -n materialize describe pod/<pod-name>

    • You can use kubectl get events, substituting your pod name for <pod-name>:

      kubectl -n materialize get events --sort-by=.metadata.creationTimestamp --field-selector involvedObject.name=<pod-name>

Materialize deployment

  • To check the status of your Materialize deployment, run:

    kubectl  -n materialize-environment get all

  • To check the log of a specific object (pod/deployment/etc) running in your namespace:

    kubectl -n materialize-environment logs <type>/<name>

    In case of a container restart, to get the logs for previous instance, include the --previous flag.

  • To describe an object, you can use kubectl describe:

    kubectl -n materialize-environment describe <type>/<name>

For additional kubectl commands, see kubectl Quick reference.

Troubleshooting Console unresponsiveness

If you experience long loading screens or unresponsiveness in the Materialize Console, it may be that the size of the mz_catalog_server cluster (where the majority of the Console’s queries are run) is insufficient (default size is 25cc).

To increase the cluster’s size, you can follow the following steps:

  1. Login as the mz_system user in order to update mz_catalog_server.

    1. To login as mz_system you’ll need the internal-sql port found in the environmentd pod (6877 by default). You can port forward via kubectl port-forward svc/mzXXXXXXXXXX 6877:6877 -n materialize-environment.

    2. Connect using a pgwire compatible client (e.g., psql) and connect using the port and user mz_system. For example:

      psql -h localhost -p 6877 --user mz_system

  2. Run the following ALTER CLUSTER statement to change the cluster size to 50cc:

    ALTER CLUSTER mz_catalog_server SET (SIZE = '50cc');

  3. Verify your changes via SHOW CLUSTERS;

    show clusters;

    The output should include the mz_catalog_server cluster with a size of 50cc:

           name        | replicas  | comment
 -------------------+-----------+---------
 mz_analytics      |           |
 mz_catalog_server | r1 (50cc) |
 mz_probe          |           |
 mz_support        |           |
 mz_system         |           |
 quickstart        | r1 (25cc) |
 (6 rows)

See also

Back to top ↑