Runtime Tracing

debug_goTrace

Turns on Go runtime tracing for the given duration and writes trace data to disk.

Client

Method Invocation

Console

debug.goTrace(file, seconds)

RPC

{"method": "debug_goTrace", "params": [string, number]}

Parameters

Name

Type

Description

file

string

The filename for the trace output.

seconds

int

The tracing duration in seconds.

Return Value

None

Example

Console

> debug.goTrace("go.trace", 5)
null

HTTP RPC

$ curl -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"debug_goTrace","params":["go.trace",5],"id":1}' http://localhost:8551
{"jsonrpc":"2.0","id":1,"result":null}

debug_startGoTrace

Starts writing a Go runtime trace to the given file.

Client

Method Invocation

Console

debug.startGoTrace(file)

RPC

{"method": "debug_startGoTrace", "params": [string]}

Parameters

Name

Type

Description

file

string

The filename for the tracing output.

Return Value

None

Example

Console

> debug.startGoTrace("go.trace")
null

HTTP RPC

$ curl -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"debug_startGoTrace","params":["go.trace"],"id":1}' http://localhost:8551
{"jsonrpc":"2.0","id":1,"result":null}

debug_stopGoTrace

Stops writing the Go runtime trace.

Client

Method Invocation

Console

debug.stopGoTrace()

RPC

{"method": "debug_stopGoTrace", "params": []}

Parameters

None

Return Value

None

Example

Console

> debug.stopGoTrace()
null

HTTP RPC

$ curl -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"debug_stopGoTrace","params":[],"id":1}' http://localhost:8551
{"jsonrpc":"2.0","id":1,"result":null}