Extend tables

Create a table and add rows

Open Extend tables and create a table. Each row is a key plus a record of named fields. The API also supports extend-table management:

# upsert a row keyed by "checkout"
curl -X PUT http://localhost:5080/api/v1/extend_tables/service_meta/rows/checkout \
  -H "authorization: Bearer $MS_JWT" \
  -H 'content-type: application/json' \
  -d '{"team":"payments","tier":"gold"}'

Action	Endpoint
List tables	`GET /api/v1/extend_tables`
List a table’s rows	`GET /api/v1/extend_tables/{table}`
Upsert a row	`PUT /api/v1/extend_tables/{table}/rows/{key}`
Delete a row	`DELETE /api/v1/extend_tables/{table}/rows/{key}`

Perform a lookup from a transform

Inside a VRL transform, call lookup(table, key) and read a field off the returned record:

# enrich each event with the service's owning team
.team = lookup("service_meta", .service).team

Lookups run in memory and add no query or storage cost to a pipeline run. The table loads on startup and stays current as rows are upserted or deleted.

Extend tables are scoped to the active organization and shared across all pipelines — define a mapping once for reuse across all pipelines.

functions.read lists tables and usage. Creating a table requires functions.create; row changes require functions.edit; deleting a table requires functions.delete.

Pipelines

Build the transform chain that calls the extend tables.

Getting Started

Observe

Reliability

AI Ops

Data

Collaboration

Admin

Deploy & Operate

Create a table and add rows

Perform a lookup from a transform

Pipelines

​Create a table and add rows

​Perform a lookup from a transform

Pipelines

Create a table and add rows

Perform a lookup from a transform