io.sentry.protocol

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 and Description
SentryStackTrace()
SentryStackTrace(@Nullable java.util.List<SentryStackFrame> frames)

Method Summary

Modifier and Type	Method and 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)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

@ApiStatus.Internal
public void acceptUnknownProperties(@NotNull
                                                        @NotNull java.util.Map<java.lang.String,java.lang.Object> unknown)

Specified by:

acceptUnknownProperties in interface IUnknownPropertiesConsumer

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)