bronto traces

Explore OpenTelemetry traces stored in the .traces dataset

Platform docs: docs.bronto.io/tracing/explore-traces

bronto traces <command> [flags]

Subcommands

Command	Description
`bronto traces aggregate`	Aggregate span attribute values across traces
`bronto traces list`	List individual spans
`bronto traces operations`	Show span counts and latency per service and operation
`bronto traces services`	Show span counts and latency per service
`bronto traces shape`	Show the merged call-tree shape across a sample of traces
`bronto traces show`	Render a single trace as a waterfall

Also accepts the global flags.

bronto traces aggregate

Aggregate span attribute values across traces

bronto traces aggregate [flags]

Flags

Flag	Short	Type	Default	Description
`--all-spans`		bool		consider all spans, not just roots
`--by`	`-b`	stringArray		attribute to group by (repeatable, required)
`--errors`		bool		only error spans
`--include-empty`		bool		include rows where an attribute is missing
`--kind`	`-k`	string		filter by span kind, e.g. server or client
`--limit`	`-n`	int	`50`	max rows
`--root-only`		bool	`true`	only consider root spans
`--service`	`-s`	string		filter by service name
`--since`		string		relative lookback (default 15m)
`--where`	`-w`	string		additional raw WHERE clause

Also accepts the global flags.

Examples

bronto traces aggregate --by http.route
bronto traces aggregate --by db.system --all-spans --kind client

bronto traces list

List individual spans

bronto traces list [flags]

Flags

Flag	Short	Type	Default	Description
`--errors`		bool		only error spans
`--limit`	`-n`	int	`50`	max spans
`--min-duration-ms`		float		only spans at least this many milliseconds long
`--operation`		string		filter by operation (span) name
`--service`	`-s`	string		filter by service name
`--since`		string		relative lookback (default 15m)

Also accepts the global flags.

Examples

bronto traces list -s checkout-service --errors
bronto traces list --min-duration-ms 500 -n 20

bronto traces operations

Show span counts and latency per service and operation

bronto traces operations [flags]

Flags

Flag	Short	Type	Default	Description
`--errors`		bool		only error spans
`--limit`	`-n`	int	`25`	max operations
`--service`	`-s`	string		filter by service name
`--since`		string		relative lookback (default 15m)

Also accepts the global flags.

Examples

bronto traces operations --since 15m
bronto traces operations -s checkout-service --errors -n 10

bronto traces services

Show span counts and latency per service

bronto traces services [flags]

Flags

Flag	Short	Type	Default	Description
`--errors`		bool		only error spans
`--limit`	`-n`	int	`50`	max services
`--since`		string		relative lookback (default 15m)

Also accepts the global flags.

Examples

bronto traces services --since 15m
bronto traces services --errors

bronto traces shape

Show the merged call-tree shape across a sample of traces

bronto traces shape [flags]

Flags

Flag	Short	Type	Default	Description
`--any-span`		bool		sample by any matching span, not just entries
`--bar-width`		int	`50`	waterfall bar width in characters
`--entry`		bool	`true`	sample by entry (server) spans
`--errors`		bool		only error spans/traces
`--min-duration-ms`		float		only entry spans at least this many milliseconds long
`--min-traces`		int	`1`	drop buckets present in fewer than this many traces
`--operation`		string		filter by operation (span) name
`--sample`		int	`30`	number of traces to sample
`--service`	`-s`	string		filter by service name
`--since`		string		relative lookback (default 1h)
`--where`	`-w`	string		additional raw WHERE clause

Also accepts the global flags.

Examples

bronto traces shape -s checkout-service --sample 20
bronto traces shape --any-span --operation 'SELECT users'

bronto traces show

Render a single trace as a waterfall

bronto traces show <trace-id> [flags]

Flags

Flag	Short	Type	Default	Description
`--bar-width`		int	`40`	waterfall bar width in characters
`--limit`	`-n`	int	`500`	max spans to fetch
`--since`		string		relative lookback (default 1h)

Also accepts the global flags.

Examples

bronto traces show 4bf92f3577b34da6a3ce929d0e0e4736
bronto traces show <trace-id> --since 6h -n 200

Start here

Guides

Configuration

Extend

Help

Reference

Subcommands

bronto traces aggregate

Flags

Examples

bronto traces list

Flags

Examples

bronto traces operations

Flags

Examples

bronto traces services

Flags

Examples

bronto traces shape

Flags

Examples

bronto traces show

Flags

Examples

​Subcommands

​bronto traces aggregate

​Flags

​Examples

​bronto traces list

​Flags

​Examples

​bronto traces operations

​Flags

​Examples

​bronto traces services

​Flags

​Examples

​bronto traces shape

​Flags

​Examples

​bronto traces show

​Flags

​Examples

Subcommands

bronto traces aggregate

Flags

Examples

bronto traces list

Flags

Examples

bronto traces operations

Flags

Examples

bronto traces services

Flags

Examples

bronto traces shape

Flags

Examples

bronto traces show

Flags

Examples