Skip to main content

deploymentLogs

Subscribe to a single deployment's logs as they're appended via WebSocket.

Receives one DeploymentLog per worker flush — each flush is a batch of lines written as a single object in storage. Unlike deploymentEvents, this subscription does not re-send the entire deployment on every message; it streams only the new log batch. Cheap to keep open even for deployments producing logs at high cadence.

For the initial backfill, query deployment { logs { ... } } once and render the result, then open this subscription to stream new batches.

subscription {
  deploymentLogs(organizationId: "my-org", deploymentId: "a1b2c3...") {
    timestamp
    message
  }
}
deploymentLogs(
  organizationId: ID!
  deploymentId: ID!
): DeploymentLog!

Arguments​

deploymentLogs.organizationId ● ID! non-null scalar {#organization-id}​

Your organization's unique identifier.

deploymentLogs.deploymentId ● ID! non-null scalar {#deployment-id}​

The deployment's unique identifier.

Type​

DeploymentLog object​

A single batch of deployment logs emitted by the provisioner.

One DeploymentLog corresponds to one worker flush, which may contain multiple log lines joined by \n in the message field.