Skip to main content
Tilebox stores workflow logs and spans for each job. Query them when you need structured diagnostics outside the Console, such as in notebooks, scripts, or agent loops.

​
Query from the command line

Use JSON output when another tool or agent will parse the result. 
tilebox job logs <job-id> --json
tilebox job spans <job-id> --json
Use jq to narrow the output during debugging. 
tilebox job logs <job-id> --json | jq '.[] | select(.level == "ERROR")'

​
Query from Python

Use the jobs client in notebooks and scripts.
Python
from tilebox.workflows import Client

client = Client()
job = client.jobs().find("019e07b1-916b-0630-f3ba-f1c33235d174")

logs = client.jobs().query_logs(job)
spans = client.jobs().query_spans(job.id)

logs_df = logs.to_pandas()
spans_df = spans.to_pandas()

​
Use the detailed reference pages

Query telemetry

Query logs and spans from Python and Go.

Logging

Emit structured logs from workflow tasks.

Tracing

Add custom spans around important parts of task code.

Axiom integration

Export workflow telemetry to Axiom.