Materialize Documentation
Join the Community github/materialize

Troubleshoot Cloud

Materialize Cloud is in beta and is not subject to Materialize's backwards compatibility guarantee.

We’re working on other monitoring tools, but for now there are a few tools you can use for troubleshooting issues with Materialize Cloud.

Third-party monitoring tools

Materialize supports integrations with Grafana and Prometheus. For more information, see Monitor Cloud.

Status check

You can check on the status of Materialize systems at You can also sign up at the page to be notified of any incidents through email, text, Slack, or Atom or RSS feed.


The Metrics card shows memory and CPU utilization for different ranges of time, and offers access to logs.


Materialize periodically emits messages to its log file. You can view these logs in the Metrics card on the Deployments page. Click View logs beneath the utilization graph, then click Download if you want to save the logs for review.

These log messages serve several purposes:

We recommend that you monitor for messages at the WARN or ERROR levels. Every message at either of these levels indicates an issue that must be investigated and resolved.

For more information, see Monitoring: Logging

Disabling user indexes

WARNING! This feature is primarily meant for advanced administrators of Materialize.

If your Cloud deployment unexpectedly consumes all CPU or memory, you can troubleshoot by restarting with indexes on user-created objects disabled.

To do so:

  1. Go to the Deployment details page and click Edit.

  2. Open the Advanced settings section and click Disable User indexes, then click Save.

    The deployment will restart automatically.

In this mode users…

After troubleshooting any issues, you can enable individual indexes or restart Materialize without disabling user indexes to enable all indexes at once.

For assistance with this mode, see:

Did this info help?
Yes No