Doris BE Print Stack API Research

Doris#62497

This repository studies ways to dump live native stacks from doris_be.

Current State

Phase 1 is archived in archive/phase1/.

Phase 2 compares four stack collection designs inside Doris:

• ClickHouse-style PHDR-cache unwind in a signal handler.
• OceanBase-style two-phase kill -60 collection.
• Snapshot plus remote unwind from copied stack bytes.
• Frame-pointer walking with Doris Release build flags.

The current goal is to prove fp-walk first, as the baseline, gated by tests that ship in the patches. The other three designs are compared only after the baseline passes.

Key Files

• AGENTS.md: project instructions
• docs/phase2-charter.md: goal and constraints (human-owned)
• docs/phase2-acceptance.md: baseline gate and work checklist (human Gate, agent checklist)
• docs/architecture.md: variant-agnostic contract and structure for the print_stack API (agent-owned)
• docs/phase2-test-plan.md: three CK-shape test cases for the fp-walk baseline (agent-owned)
• docs/writing-guidelines.md: project writing style
• docs/coding-guidelines.md: code and comment conventions