Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,9 +48,9 @@ See the [full quick start guide](docs/en/quickstart.md) for a walkthrough.

## Query Templates

7 built-in templates across 3 categories:
6 built-in templates across 3 categories:

- **Basic**: `active_blocks`, `blocks_by_size`, `events_by_action`, `memory_timeline`
- **Basic**: `block`, `event`, `allocation`
- **Statistical**: `callstack_analysis`, `memory_peak`
- **Business**: `leak_detection`

Expand Down
4 changes: 2 additions & 2 deletions README_zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,9 +48,9 @@ pt-snap query --template-use leak_detection --params '{"min_size": 1024}'

## 查询模板

7 个内置模板,3 个分类:
6 个内置模板,3 个分类:

- **Basic**: `active_blocks`, `blocks_by_size`, `events_by_action`, `memory_timeline`
- **Basic**: `block`, `event`, `allocation`
- **Statistical**: `callstack_analysis`, `memory_peak`
- **Business**: `leak_detection`

Expand Down
7 changes: 3 additions & 4 deletions docs/en/querying.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,10 +32,9 @@ Raw data lookup.

| Template | Description |
|----------|-------------|
| `active_blocks` | Currently active (unfreed) memory blocks |
| `blocks_by_size` | Memory blocks sorted by size |
| `events_by_action` | Events grouped by action type |
| `memory_timeline` | Memory allocation timeline |
| `block` | Query memory blocks with flexible field filters |
| `event` | Query memory events with flexible field filters |
| `allocation` | Memory allocation timeline (id, allocated, active, reserved) |

### Statistical Queries

Expand Down
2 changes: 1 addition & 1 deletion docs/en/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ pt-snap query --template-use memory_peak
pt-snap query --template-use leak_detection --params '{"min_size": 1024}'

# Query automatically uses the focused device, or you can override it
pt-snap query --template-use active_blocks --device 1
pt-snap query --template-use block --device 1 --state 1
```

## What's Next
Expand Down
7 changes: 3 additions & 4 deletions docs/zh/querying.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,10 +32,9 @@ pt-snap query [--template-use <template_name>] [--params <json>] [--device <id>]

| 模板 | 说明 |
|------|------|
| `active_blocks` | 当前活跃(未释放)的内存块 |
| `blocks_by_size` | 按大小排序的内存块 |
| `events_by_action` | 按动作类型分组的事件 |
| `memory_timeline` | 内存分配时间线 |
| `block` | 灵活字段过滤的内存块查询 |
| `event` | 灵活字段过滤的内存事件查询 |
| `allocation` | 内存分配时间线(id, allocated, active, reserved) |

### Statistical Queries

Expand Down
2 changes: 1 addition & 1 deletion docs/zh/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ pt-snap query --template-use memory_peak
pt-snap query --template-use leak_detection --params '{"min_size": 1024}'

# 查询自动使用 focus 中设置的设备,也可以显式覆盖
pt-snap query --template-use active_blocks --device 1
pt-snap query --template-use block --device 1 --state 1
```

## 下一步
Expand Down
2 changes: 1 addition & 1 deletion src/pt_snap_cli/cli.py
Original file line number Diff line number Diff line change
Expand Up @@ -225,7 +225,7 @@ def query_database(
pt-snap focus --device 1 # Change device only
pt-snap query --list # List templates
pt-snap query --template-use leak_detection # Uses focused db and device
pt-snap query --template-use active_blocks --device 0
pt-snap query --template-use block --device 0 --state 1
pt-snap query custom.db --template-use leak_detection # Override with custom path
pt-snap query --template-info leak_detection
pt-snap query --list --category basic # List only basic queries
Expand Down
37 changes: 0 additions & 37 deletions src/pt_snap_cli/query/templates/basic/active_blocks.yaml

This file was deleted.

73 changes: 73 additions & 0 deletions src/pt_snap_cli/query/templates/basic/allocation.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
version: "1.0"
queries:
allocation:
description: Memory allocation timeline — (id, allocated, active, reserved) curve
devices:
- all
parameters:
min_id:
type: int
default: null
required: false
description: Minimum event ID (start of range)
max_id:
type: int
default: null
required: false
description: Maximum event ID (end of range)
min_allocated:
type: int
default: null
required: false
description: Minimum total allocated bytes
min_active:
type: int
default: null
required: false
description: Minimum total active bytes
min_reserved:
type: int
default: null
required: false
description: Minimum memory pool reserved bytes
order_by:
type: str
default: "id"
required: false
description: Column to order by
order_dir:
type: str
default: "ASC"
required: false
description: Sort direction (ASC or DESC)
limit:
type: int
default: 1000
required: false
description: Maximum rows to return
offset:
type: int
default: 0
required: false
description: Number of rows to skip
query: |
SELECT id, allocated, active, reserved
FROM {{ device_trace_table }}
WHERE 1=1
{% if min_id is not none %}AND id >= {{ min_id }}{% endif %}
{% if max_id is not none %}AND id <= {{ max_id }}{% endif %}
{% if min_allocated is not none %}AND allocated >= {{ min_allocated }}{% endif %}
{% if min_active is not none %}AND active >= {{ min_active }}{% endif %}
{% if min_reserved is not none %}AND reserved >= {{ min_reserved }}{% endif %}
ORDER BY {{ order_by }} {{ order_dir }}
LIMIT {{ limit }}
{% if offset > 0 %}OFFSET {{ offset }}{% endif %}
output_schema:
- column: id
type: int
- column: allocated
type: int
- column: active
type: int
- column: reserved
type: int
118 changes: 118 additions & 0 deletions src/pt_snap_cli/query/templates/basic/block.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,118 @@
version: "1.0"
queries:
block:
description: Query memory blocks with flexible field filters
devices:
- all
parameters:
id:
type: int
default: null
required: false
description: Block ID
address:
type: int
default: null
required: false
description: Memory address
size:
type: int
default: null
required: false
description: Exact block size in bytes
min_size:
type: int
default: null
required: false
description: Minimum block size
max_size:
type: int
default: null
required: false
description: Maximum block size
requestedSize:
type: int
default: null
required: false
description: Exact user-requested size
allocEventId:
type: int
default: null
required: false
description: Allocation event ID
min_allocEventId:
type: int
default: null
required: false
description: Minimum allocation event ID
max_allocEventId:
type: int
default: null
required: false
description: Maximum allocation event ID
freeEventId:
type: int
default: null
required: false
description: Free event ID
min_freeEventId:
type: int
default: null
required: false
description: Minimum free event ID
max_freeEventId:
type: int
default: null
required: false
description: Maximum free event ID
order_by:
type: str
default: "size"
required: false
description: Column to order by
order_dir:
type: str
default: "DESC"
required: false
description: Sort direction (ASC or DESC)
limit:
type: int
default: 100
required: false
description: Maximum rows to return
offset:
type: int
default: 0
required: false
description: Number of rows to skip
query: |
SELECT * FROM {{ device_block_table }}
WHERE 1=1
{% if id is not none %}AND id = {{ id }}{% endif %}
{% if address is not none %}AND address = {{ address }}{% endif %}
{% if size is not none %}AND size = {{ size }}{% endif %}
{% if min_size is not none %}AND size >= {{ min_size }}{% endif %}
{% if max_size is not none %}AND size <= {{ max_size }}{% endif %}
{% if requestedSize is not none %}AND requestedSize = {{ requestedSize }}{% endif %}
{% if allocEventId is not none %}AND allocEventId = {{ allocEventId }}{% endif %}
{% if min_allocEventId is not none %}AND allocEventId >= {{ min_allocEventId }}{% endif %}
{% if max_allocEventId is not none %}AND allocEventId <= {{ max_allocEventId }}{% endif %}
{% if freeEventId is not none %}AND freeEventId = {{ freeEventId }}{% endif %}
{% if min_freeEventId is not none %}AND freeEventId >= {{ min_freeEventId }}{% endif %}
{% if max_freeEventId is not none %}AND freeEventId <= {{ max_freeEventId }}{% endif %}
ORDER BY {{ order_by }} {{ order_dir }}
LIMIT {{ limit }}
{% if offset > 0 %}OFFSET {{ offset }}{% endif %}
output_schema:
- column: id
type: int
- column: address
type: int
- column: size
type: int
- column: requestedSize
type: int
- column: allocEventId
type: int
- column: freeEventId
type: int
37 changes: 0 additions & 37 deletions src/pt_snap_cli/query/templates/basic/blocks_by_size.yaml

This file was deleted.

Loading
Loading