docs: missing documentation for system.backtrace system table

Open Beginner friendly
#3,220 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
74/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Quiet
Tech stack
sql
Domain
documentation

Research direction

Read src/query/storages/system/src/backtrace_table.rs to confirm the registered name and columns, then compare the structure of docs/en/sql-reference/00-sql-reference/31-system-tables/system-query-log.md. Create the suggested system-backtrace.md with a schema table and example SELECT query; done means the system.backtrace table is documented in the same format.

Written by the indexing model from the issue text.

Description

documentation

Missing Documentation: system.backtrace

The system.backtrace system table is implemented in Databend but has no documentation in databend-docs.

Source Code

/workspace/databend/src/query/storages/system/src/backtrace_table.rs

Registered as: system.backtrace (constant NAME = "system.backtrace")

What it does

Exposes the current async task backtraces for all running tasks across warehouse nodes. Each row contains:

  • node — the cluster node name
  • query_id — the associated query ID
  • stack_trace — the backtrace/stack trace string for the task

Useful for diagnosing hung queries or debugging async runtime issues in a distributed Databend deployment.

Suggested Doc Location

/docs/en/sql-reference/00-sql-reference/31-system-tables/system-backtrace.md

Should follow the same format as other system table docs (e.g. system-query-log.md), including a schema table and example SELECT query.

Dominant language
TypeScript
Stars
17
Forks
44
Avg merge
2d 7m
Merged PRs (30d)
4

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from databendlabs/databend-docs

All issues in databendlabs/databend-docs

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.