Workflow Observability

Tilebox Workflows now includes built-in observability for jobs and runners. Tilebox captures workflow logs, traces, task status, and runner context, then correlates them with jobs and tasks.

Each task execution creates a trace span, and runners continue the job’s trace across machines. Use context.logger for structured log attributes and context.tracer.span() to measure individual operations within a task:

from tilebox.workflows import ExecutionContext, Task

class InspectScene(Task):
    scene_id: str

    def execute(self, context: ExecutionContext) -> None:
        with context.tracer.span("inspect-scene") as span:
            span.set_attribute("scene_id", self.scene_id)
            context.logger.info("Inspecting scene", scene_id=self.scene_id)
            # Add the operation you want to measure here.

The custom span is nested under the task span. Logs emitted inside it carry the active trace and span IDs alongside job, task, and runner metadata. In the Console, move from a slow or failed task to its execution timing and logs without matching records manually.