Log Streams
Log streams enable streaming of events such as function executions and
console.log
s from your Convex deployment to supported destinations, such as
Axiom, Datadog, or a custom webhook.
The most recent logs produced by your Convex deployment can be viewed in the Dashboard Logs page, the Convex CLI, or in the browser console, providing a quick and easy way to view recent logs.
Log streaming to a third-party destination like Axiom or Datadog enables storing historical logs, more powerful querying and data visualization, and integrations with other tools (e.g. PagerDuty, Slack).
Log streams require a Convex Pro plan. Learn more about our plans or upgrade.
Configuring log streams
We currently support the following log streams, with plans to support many more:
See the instructions for configuring an integration. The specific information needed for each log stream is covered below.
Axiom
Configuring an Axiom log stream requires specifying:
- The name of your Axiom dataset
- An Axiom API key
- An optional list of attributes and their values to be included in all log
events send to Axiom. These will be sent via the
attributes
field in the Ingest API.
When configuring a Convex dataset in Axiom, a dashboard will automatically be created in Axiom. You can find it in the Integrations section of the Dashboards tab. To customize the layout of the dashboard, you can fork it.
Datadog
Configuring a Datadog log stream requires specifying:
- The site location of your Datadog deployment
- A Datadog API key
- A comma-separated list of tags that will be passed using the
ddtags
field in all payloads sent to Datadog. This can be used to include any other metadata that can be useful for querying or categorizing your Convex logs ingested by your Datadog deployment.