Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tilebox.com/llms.txt

Use this file to discover all available pages before exploring further.

Tilebox can export workflow telemetry to Axiom through OTLP. Use this when your team already analyzes logs and traces in Axiom or wants long-term telemetry in Axiom datasets. Built-in Tilebox Console observability does not require Axiom. Axiom export is optional and additive.
Tilebox is pre-integrated with Axiom

Configure Axiom export

Create Axiom datasets for logs and traces and an API key with ingest permissions. Then configure export when the runner process starts.
Python
from tilebox.workflows import Client
from tilebox.workflows.observability.logging import configure_otel_logging_axiom
from tilebox.workflows.observability.tracing import configure_otel_tracing_axiom

from my_workflow import ProcessScene

configure_otel_tracing_axiom(
    service="sentinel-2-runner",
    dataset="workflow-traces",
    api_key="<axiom-api-key>",
)
configure_otel_logging_axiom(
    service="sentinel-2-runner",
    dataset="workflow-logs",
    api_key="<axiom-api-key>",
)

client = Client(name="sentinel-2-runner")
runner = client.runner(tasks=[ProcessScene])
runner.run_forever()

Environment variables

You can omit credentials from code by setting environment variables:
VariableUsed by
AXIOM_API_KEYlog and trace export
AXIOM_LOGS_DATASETconfigure_otel_logging_axiom()
AXIOM_TRACES_DATASETconfigure_otel_tracing_axiom()
Python
configure_otel_tracing_axiom(service="sentinel-2-runner")
configure_otel_logging_axiom(service="sentinel-2-runner")

Existing Axiom screenshots

Tilebox workflow logs in Axiom
Tilebox workflow traces in Axiom