View as Markdown

Frame¶

Field	Type	Description
frame_type	bitdrift.public.unary.client_report.v1.FrameType	The result of the symbolication process.
source_file	bitdrift.public.unary.client_report.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.client_report.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