examples

Examples

This repository contains examples for using the Tilebox Go library.

Environment variables

To run the examples, TILEBOX_API_KEY environment variable needs to be set to your Tilebox API key. Head over to Tilebox Console if you don't have one already.

Running the examples

Each example can be run using the following command:

go run ./examples/<example-folder>

For example, to run the workflows/helloworld example:

go run ./examples/workflows/helloworld

Most workflow examples submit a job first, then start a task runner in the same process. The release-worker example is an execution-only child managed by tilebox runner start and does not poll independently.

Workflows examples

• Hello world: How to submit a task and run it.
• MapReduce: How to fan out tasks and submit dependent reduce tasks.
• Progress: How to report workflow progress.
• Protobuf tasks: How to use Protobuf tasks.
• Go release worker: How to author an execution-only Go child for a workflow release.
• Observability: How to query Tilebox workflow telemetry and export traces/logs to custom Axiom or OpenTelemetry backends.

Datasets examples

• Querying data: How to query datapoints from dataset collections.
• Ingest and delete data: How to create a collection, ingest datapoints, and then delete them.