---
search:
exclude: true
---
# Frame
| Field | Type | Description |
|---|---|---|
| frame_type | [bitdrift.public.unary.issues.v1.FrameType](bitdrift_public_unary_issues_v1_FrameType.md#bitdrift.public.unary.issues.v1.FrameType){ title="bitdrift.public.unary.issues.v1.FrameType"} | The result of the symbolication process. |
| source_file | [bitdrift.public.unary.issues.v1.SourceFile](bitdrift_public_unary_issues_v1_SourceFile.md#bitdrift.public.unary.issues.v1.SourceFile){ title="bitdrift.public.unary.issues.v1.SourceFile"} | |
| symbol_name | optional string | The method or function name of the frame. |
| image_path | optional string | The path to the image that contains the frame. |
| frame_address | optional uint64 | Address of the current execution frame. |
| symbol_address | optional uint64 | Address of the named symbol nearest above the current execution frame. |
| symbolicated_name | optional string | The name of the symbol that was resolved during symbolication. |
| original_index | uint64 | The original index of this frame before symbolication. Some languages may expand a single frame into multiple during symbolication, so keeping this field allows us to track this. |
| in_app | bool | Whether this frame comes from the application or from a library/third party framework. |
| image_load_address | optional uint64 | The starting address of the image which contains this frame |
| image_id | optional string | The unique identifier of the image which contains this frame |
| status | [bitdrift.public.unary.issues.v1.Frame.FrameStatus](#bitdrift.public.unary.issues.v1.Frame.FrameStatus){ title="bitdrift.public.unary.issues.v1.Frame.FrameStatus"} | The status of the frame after symbolication. This can be used to determine if the frame was successfully symbolicated or not. |
| state | repeated string | contextual info about the frame |
#### Example
```json
{
"frame_address": 4376830024,
"frame_type": "DWARF",
"image_id": "8c4e2a1b-3f56-4d89-a012-bc345678def0",
"image_load_address": 4376829952,
"image_path": "/usr/lib/libSystem.dylib",
"in_app": false,
"original_index": 3,
"source_file": {
"column": 5,
"lineno": 42,
"path": "src/main.rs"
},
"state": [
"crashed"
],
"status": "SYMBOLICATED",
"symbol_address": 4376829952,
"symbol_name": "_ZN5alloc5alloc18handle_alloc_error17h123456789abcdef0E",
"symbolicated_name": "alloc::alloc::handle_alloc_error"
}
```
# Frame.FrameStatus
| Name | Number | Description |
|---|---|---|
| UNKNOWN | 0 | |
| MISSING | 1 | |
| SYMBOLICATED | 2 | |
| MISSING_SYMBOL | 3 | |
| UNKNOWN_IMAGE | 4 | |
| MALFORMED | 5 | |