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(java.util.List<SentryStackFrame> frames)

Method Summary

Modifier and Type	Method and Description
void	acceptUnknownProperties(java.util.Map<java.lang.String,java.lang.Object> unknown)
java.util.List<SentryStackFrame>	getFrames() Gets the frames of this stacktrace.
java.util.Map<java.lang.String,java.lang.String>	getRegisters()
void	setFrames(java.util.List<SentryStackFrame> frames) Sets the frames of this stacktrace.
void	setRegisters(java.util.Map<java.lang.String,java.lang.String> registers)

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(java.util.List<SentryStackFrame> frames)

Method Detail

getFrames

public java.util.List<SentryStackFrame> getFrames()

Gets the frames of this stacktrace.

Returns:

the frames.

setFrames

public void setFrames(java.util.List<SentryStackFrame> frames)

Sets the frames of this stacktrace.

Parameters:

frames - the frames.

acceptUnknownProperties

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

Specified by:

acceptUnknownProperties in interface IUnknownPropertiesConsumer

getRegisters

public java.util.Map<java.lang.String,java.lang.String> getRegisters()

setRegisters

public void setRegisters(java.util.Map<java.lang.String,java.lang.String> registers)