Skip to main content

Monitoring and Alerting

Superblocks sends logs to your preferred observability platform so you can easily monitor your internal tools.

For example, in Datadog, visualize the execution of Workflows or Scheduled Jobs broken out by integration and drill into each step for detailed metadata. Configure alerts on error logs to proactively notify for failures and identify root cause of failing steps.

Python code error
Traces and logs within Datadog

The following monitoring platforms are currently supported.

  • Datadog
  • New Relic
  • Coralogix
  • Elastic Cloud
  • Amazon OpenSearch
  • Kafka
  • Confluent Cloud


Logs are generated for certain events inside your Superblocks account. The following is a non-exhaustive list of events that generate a log.

  • An Application, Workflow, or Scheduled Job is created, edited, deployed, or cloned
  • A deployed Application is viewed
  • An API step (across Applications, Workflows, or Scheduled Jobs) is executed, completes successfully, or fails
  • An On-Premise Agent is registered, disconnected, or removed/deactivated


Navigate to the Observability page and follow the instructions to configure sending logs to your preferred monitoring platform.

Select the Datadog tile and fill out the form with the following configuration:

Connecting to Datadog

Logging Schema

agent-id          The id of the Superblocks Cloud or On-Premise Agent executing the request
agent-version The version of the Superblocks Cloud or On-Premise Agent executing the request
application-id The id of the parent Application where the API ran (if applicable)
component The Superblocks agent component (e.g, orchestrator,, worker.go)
correlation-id The unique id for aggregating all logs of a single API execution
level The severity level
message The log message
organization-id The Superblocks organization id
profile The Superblocks profile used during execution
resource-action The resource action
resource-id The id of the API executed
resource-name The resource name
resource-type The resource type
service An identifier for Superblocks
source An identifier for Superblocks
timestamp The timestamp of the log
user-email The user who executed the API
user-type The type of user, either Superblocks or Embed


"agent-id": "018cd5aa-6b42-7f68-9384-e691f254a425",
"agent-version": "v0.1282.0",
"component": "orchestrator",
"correlation-id": "018cda86-2ff2-7f70-b6c9-038b0c4b34a1",
"level": "info",
"message": "The api API1 has been started.",
"organization-id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"profile": "production",
"resource-action": "started",
"resource-id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"resource-name": "API1",
"resource-type": "api",
"service": "superblocks",
"source": "superblocks",
"timestamp": 1701377369695,
"user-email": "",
"user-type": "superblocks"