kosli list trails #

Synopsis #

kosli list trails [flags]

List Trails of an org.The list can be filtered by flow, flow tag and artifact fingerprint. When multiple filters are provided, only trails matching all specified criteria are returned. The results are paginated and ordered from latest to oldest.

Flags #

Flag	Description
-F, --fingerprint string	[optional] The SHA256 fingerprint of the artifact to filter trails by.
-f, --flow string	[optional] The Kosli flow name.
-t, --flow-tag string	[optional] A key=value flow tag to filter trails by.
-h, --help	help for trails
-o, --output string	[defaulted] The format of the output. Valid formats are: [table, json]. (default "table")
--page int	[defaulted] The page number of a response. (default 1)
-n, --page-limit int	[defaulted] The number of elements per page. (default 20)

Flags inherited from parent commands #

Flag	Description
-a, --api-token string	The Kosli API token.
-c, --config-file string	[optional] The Kosli config file path. (default "kosli")
--debug	[optional] Print debug logs to stdout. A boolean flag https://docs.kosli.com/faq/#boolean-flags (default false)
-H, --host string	[defaulted] The Kosli endpoint. (default "https://app.kosli.com")
--http-proxy string	[optional] The HTTP proxy URL including protocol and port number. e.g. 'http://proxy-server-ip:proxy-port'
-r, --max-api-retries int	[defaulted] How many times should API calls be retried when the API host is not reachable. (default 3)
--org string	The Kosli organization.

Examples Use Cases #

These examples all assume that the flags --api-token, --org, --host, (and --flow, --trail when required), are set/provided.

get a paginated list of trails for a flow #

kosli list trails

list the most recent 30 trails for a flow #

kosli list trails 
	--page-limit 30

show the second page of trails for a flow #

kosli list trails 
	--page-limit 30 
	--page 2

get a paginated list of trails for a flow (in JSON) #

kosli list trails 
	--output json

get a paginated list of trails across all flows that contain an artifact with the provided fingerprint (in JSON) #

kosli list trails 
	--fingerprint yourArtifactFingerprint 
	--output json

	# get a paginated list of trails across all flows tagged with the provided key-value pair:
kosli list trails 
	--flow-tag team=backend