StackTrace

A call stack appearing in a trace.

JSON representation
{
  "stackFrames": {
    object(StackFrames)
  },
  "stackTraceHashId": string
}
Fields
stackFrames

object(StackFrames)

Stack frames in this stack trace. A maximum of 128 frames are allowed.

stackTraceHashId

string (int64 format)

The hash ID is used to conserve network bandwidth for duplicate stack traces within a single trace.

Often multiple spans will have identical stack traces. The first occurrence of a stack trace should contain both the stackFrame content and a value in stackTraceHashId.

Subsequent spans within the same request can refer to that stack trace by only setting stackTraceHashId.

StackFrames

A collection of stack frames, which can be truncated.

JSON representation
{
  "frame": [
    {
      object(StackFrame)
    }
  ],
  "droppedFramesCount": number
}
Fields
frame[]

object(StackFrame)

Stack frames in this call stack.

droppedFramesCount

number

The number of stack frames that were dropped because there were too many stack frames. If this value is 0, then no stack frames were dropped.

StackFrame

Represents a single stack frame in a stack trace.

JSON representation
{
  "functionName": {
    object(TruncatableString)
  },
  "originalFunctionName": {
    object(TruncatableString)
  },
  "fileName": {
    object(TruncatableString)
  },
  "lineNumber": string,
  "columnNumber": string,
  "loadModule": {
    object(Module)
  },
  "sourceVersion": {
    object(TruncatableString)
  }
}
Fields
functionName

object(TruncatableString)

The fully-qualified name that uniquely identifies the function or method that is active in this frame (up to 1024 bytes).

originalFunctionName

object(TruncatableString)

An un-mangled function name, if functionName is mangled. The name can be fully-qualified (up to 1024 bytes).

fileName

object(TruncatableString)

The name of the source file where the function call appears (up to 256 bytes).

lineNumber

string (int64 format)

The line number in fileName where the function call appears.

columnNumber

string (int64 format)

The column number where the function call appears, if available. This is important in JavaScript because of its anonymous functions.

loadModule

object(Module)

The binary module from where the code was loaded.

sourceVersion

object(TruncatableString)

The version of the deployed source code (up to 128 bytes).

Module

Binary module.

JSON representation
{
  "module": {
    object(TruncatableString)
  },
  "buildId": {
    object(TruncatableString)
  }
}
Fields
module

object(TruncatableString)

For example: main binary, kernel modules, and dynamic libraries such as libc.so, sharedlib.so (up to 256 bytes).

buildId

object(TruncatableString)

A unique identifier for the module, usually a hash of its contents (up to 128 bytes).

Was this page helpful? Let us know how we did:

Send feedback about...

Stackdriver Trace