logs

Get application logs

Returns an endpoint for the requested application logs.

get/applications/{id}/logs

Path parameters

idstring required

Application id.

Query parameters

type'access' | 'pageviews' | 'csp-reports' | 'cdn'

The type of logs to be returned. Available options are access, pageviews, csp-reports, and cdn.

fromstring

Beginning of a date-time range.

tostring

End of a date-time range.

formatstring

Format of the logs. One of <tt>json</tt> <tt>csv</tt>.

selectstring

A comma separated list of fields to be returned in the result set. Field names that can be used are: arrival, bytes_in, bytes_out, cache_control, cache_source, completed, country, delivery_status, elapsed, internal_transport_latency, labels, load_id, location, proxy_address, peer_address, queue_latency, range, referrer, request_address, request_id, request_method, request_host, request_port, request_path, request_protocol, request_query, request_url, response_content_type, server_address, server_latency, status_code, session_id, status_code_and_url, threat, tls_cipher, tls_version, ttfb, useragent, useragent_device, useragent_name, useragent_os, webcontrols

filterstring

A set of filters to be applied to the query. Filter expressions are separated by <tt>and</tt> or <tt>or</tt>, and can be nested in parentheses to enforce precedence.

startinteger

The starting item to be returned, used for pagination.

orderstring

A comma-separated list of attributes that specifies the order in which results should be returned. Each attribute may be prefixed by a '-' or '+' to specify descending or ascending sort respectively. The default for each attribute is ascending

groupbystring

A field or interval function to be grouped by. An interval function is specified as <tt>interval(<i>n</i>)</tt>, where <i>n</i> specifies the duration of the groups returned, with each matching record being assigned to the interval containing it. If not provided, then no group result is returned

groupfiltersstring

A comma-separated list of filters that specify multiple groups will be returned, with each constructed from the filtered logs. The special filter "other" can appear as a final filter to select logs that do not match other filters. Each group filter selects logs from within the set already determined by the "filter" parameter

grouplimitinteger

The maximum number of group records returned. If not provided, the default limit is 100. The maximum grouplimit is 200.

groupselectstring

A comma separated list of fields with aggregation functions in the format <aggregation>(<field>). Ex. sum(bytes_out),sum(bytes_in). Possible aggregations are sum|avg|min|max|count. 'count' is a special aggregation function and should not be specified with any field. If not provided, the default is 'count'.

grouporderstring

A comma separated list that dictates the order in which grouped results should be returned.

Response

A CSV or a JSON document containing the application access logs. The fields included in the response depend on the parameters specified in the request.

fromstring required

An iso8601 formatted timestamp

tostring required

An iso8601 formatted timestamp

Changes

No recorded changes to this endpoint across all 1 revision of this API.