Class SentryStackTrace
- java.lang.Object
-
- io.sentry.protocol.SentryStackTrace
-
- All Implemented Interfaces:
IUnknownPropertiesConsumer
public final class SentryStackTrace extends java.lang.Object implements IUnknownPropertiesConsumer
A stack trace of a single thread.A stack trace contains a list of frames, each with various bits (most optional) describing the context of that frame. Frames should be sorted from oldest to newest.
For the given example program written in Python:
```python def foo(): my_var = 'foo' raise ValueError()
def main(): foo() ```
A minimalistic stack trace for the above program in the correct order:
```json { "frames": [ {"function": "main"}, {"function": "foo"} ] } ```
The top frame fully symbolicated with five lines of source context:
```json { "frames": [{ "in_app": true, "function": "myfunction", "abs_path": "/real/file/name.py", "filename": "file/name.py", "lineno": 3, "vars": { "my_var": "'value'" }, "pre_context": [ "def foo():", " my_var = 'foo'", ], "context_line": " raise ValueError()", "post_context": [ "", "def main():" ], }] } ```
A minimal native stack trace with register values. Note that the `package` event attribute must be "native" for these frames to be symbolicated.
```json { "frames": [ {"instruction_addr": "0x7fff5bf3456c"}, {"instruction_addr": "0x7fff5bf346c0"}, ], "registers": { "rip": "0x00007ff6eef54be2", "rsp": "0x0000003b710cd9e0" } } ```
-
-
Constructor Summary
Constructors Constructor Description SentryStackTrace()
SentryStackTrace(@Nullable java.util.List<SentryStackFrame> frames)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
acceptUnknownProperties(@NotNull java.util.Map<java.lang.String,java.lang.Object> unknown)
@Nullable java.util.List<SentryStackFrame>
getFrames()
Gets the frames of this stacktrace.@Nullable java.util.Map<java.lang.String,java.lang.String>
getRegisters()
@Nullable java.lang.Boolean
getSnapshot()
void
setFrames(@Nullable java.util.List<SentryStackFrame> frames)
Sets the frames of this stacktrace.void
setRegisters(@Nullable java.util.Map<java.lang.String,java.lang.String> registers)
void
setSnapshot(@Nullable java.lang.Boolean snapshot)
-
-
-
Constructor Detail
-
SentryStackTrace
public SentryStackTrace()
-
SentryStackTrace
public SentryStackTrace(@Nullable @Nullable java.util.List<SentryStackFrame> frames)
-
-
Method Detail
-
getFrames
@Nullable public @Nullable java.util.List<SentryStackFrame> getFrames()
Gets the frames of this stacktrace.- Returns:
- the frames.
-
setFrames
public void setFrames(@Nullable @Nullable java.util.List<SentryStackFrame> frames)
Sets the frames of this stacktrace.- Parameters:
frames
- the frames.
-
acceptUnknownProperties
@Internal public void acceptUnknownProperties(@NotNull @NotNull java.util.Map<java.lang.String,java.lang.Object> unknown)
- Specified by:
acceptUnknownProperties
in interfaceIUnknownPropertiesConsumer
-
getRegisters
@Nullable public @Nullable java.util.Map<java.lang.String,java.lang.String> getRegisters()
-
setRegisters
public void setRegisters(@Nullable @Nullable java.util.Map<java.lang.String,java.lang.String> registers)
-
getSnapshot
@Nullable public @Nullable java.lang.Boolean getSnapshot()
-
setSnapshot
public void setSnapshot(@Nullable @Nullable java.lang.Boolean snapshot)
-
-