ENGINEERING

BigQuery regression to Linear ticket with AI root-cause hypothesis

Detects BigQuery query regressions on a schedule, asks an LLM to read the query plan and propose a likely root cause and fix.

CategoryEngineering
Enginesim
Difficultyintermediate
Triggerschedule
Steps5
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerScheduled regression hunt
  • ActionCompare BigQuery jobs to baselineGoogle BigQueryBigQuery
  • LogicFilter to material regressions
  • ActionLLM analyzes plan, returns root-cause hypothesisOpenAI
  • OutputCreate Linear issue with hypothesis and cost deltaLinearLinear

What it does

This goes a step beyond detection: when a query regresses, it sends the plan and stats to an LLM that names the likely culprit (missing partition filter, broadcast join blowup, spilled shuffle) and drafts a suggested fix. The result lands in Linear as a ready-to-pick-up ticket, so triage is mostly done before a human opens it.

When to use it

Ideal for analytics-engineering teams who live in Linear and want regressions to arrive with a starting hypothesis instead of just a number. Useful when the people fixing queries aren't always the people who wrote them.

How it works

  1. 1A schedule triggers the hunt at a set hour.
  2. 2BigQuery job history is queried and compared to a baseline to find regressed queries.
  3. 3A logic step filters to material regressions worth a ticket.
  4. 4The query text, execution plan, and cost delta are passed to an LLM that returns a root-cause hypothesis and suggested fix.
  5. 5A Linear issue is created with the hypothesis, plan, delta, and a priority derived from the cost increase.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect BigQueryDatasets, queries, schemas.
  2. 2
    Connect OpenAIModels, embeddings, files.
  3. 3
    Connect LinearIssues, projects, cycles, triage.
  4. 4
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  5. 5
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  6. 6
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.