Convex keeps getting better. This time we’re focused on helping you debug your apps and we’re also gearing up for the open-source release of the Convex backend.

Highlights:

  • Request IDs let you find related logs
  • Improved error messages and new warnings
  • New CLI commands: convex export, convex env, convex data
  • Convex is now SOC-2 compliance certified

Request IDs added to all errors

When a function fails, it’s helpful to find all the logs related to its execution. This is now much easier to do! Just grab the Request ID included in the error message, and paste it into the dashboard Logs page’s search field:

Request IDs propagate to queries, mutations and actions called from actions.

You can also use the Request ID to filter logs in Axiom or Datadog if you have log streaming set up.

Improved warnings and error messages

We’re working on further improving the messages of errors thrown by the backend, such as when a limit is reached, or when too many conflicting writes prevent a mutation from succeeding:

We have also added a dedicated docs page which provides more information about specific errors: https://docs.convex.dev/error. Expect to see more errors linking to this page in the future.

Convex has limits in place to ensure that your backend stays highly available and responsive. Functions now also log warnings related to their execution limits:

You can find the full list of limits in the docs.

convex export for snapshot export from CLI

The new npx convex export command allows exporting a snapshot of all the data from any of your deployments, without having to use the dashboard:

You can optionally include all files from the file storage as well, via the --include-file-storage option.

convex env for setting environment variables from CLI

The new npx convex env command allows viewing, setting and deleting environment variables for any of your deployments without having to use the dashboard:

Remember that these are the deployment environment variables, which are used by your backend functions in the convex folder. Other environment variables, such as those for your frontend, need to be configured as before (such as via .env files or in your hosting provider’s dashboard).

convex data for inspecting the database from CLI

The new npx convex data command allows viewing data stored in your deployment’s database without having to use the dashboard:

You can list documents from your tables and from system tables (_storage and _scheduled_functions).

Convex is now SOC-2 compliance certified

We know you’re trusting us to keep your data private, safe, secure and available. We take this responsibility very seriously, and now we have a third-party certification to prove it. Learn more in Jamie’s announcement.

Other improvements