Exception Reporting
Configure exception reporting to gain visibility into errors from your Convex function executions. Convex supports integration with Sentry and with Datadog Error Tracking.
Currently, exception reporting is only available to Pro users.
Configuring Sentry
To configure sentry, navigate to the Deployment Settings in the Dashboard, and the "Integrations" tab in the sidebar.
Click on the Sentry card and follow the setup directions. You will need your Sentry DSN. You may optionally specify additional tags to be added to each exception event.
Supported Tags
Convex automatically tags exception events on their way to sentry with the following tags. These tags cannot be overridden.
func
: The name of the running function in string formatfunc_type
: One of["query", "mutation", "action", "http_action"]
func_runtime
: One of the function runtimes -["default", "node"]
request_id
: The request id of the function that errored.server_name
: The name of the deployment. e.g.happy-animal-123
environment
: One of["prod", "dev", "preview"]
user
: If the function is authenticated, then the tokenIdentifier is used as the user id on Sentry. ThetokenIdentifier
is a stable and globally unique string representing the authenticated user.
Sentry Notes
- Sentry Exceptions may take a minute or two to propagate to Sentry.
- Convex's built-in sentry support does not yet support the advanced customization provided by the sentry SDK.
- Please reach out with any questions, comments, or suggestions on Discord.
Configuring Datadog Error Tracking
Follow the instructions in the Datadog application to configure Datadog error tracking via the Sentry SDK. Then use the Convex-Sentry integration to proceed.