Usage Metrics#

Usage metrics collection enables Presto to log information about all nodes in the cluster. This feature is mostly used for Mission Control and other management solutions. Users can use the resulting log information for their own monitoring and operational purposes.

Configuration#

Usage metrics collection is configured by a number of properties, that you can add in etc/config.properties to configure details.

Usage Metrics Configuration Properties#

Property name

Description

Default value

usage-metrics.log.path

Base path of the usage log files

var/log/presto/usage-metrics.log

usage-metrics.log.max-size

Maximum size of a single usage log file

100 MB, minimum 1MB

usage-metrics.log.max-history

Maximum number of usage log files

1000

usage-metrics.cloud-watch-logs-directory

Path to the directory on the node in which log files are stored, for example, /var/log/presto/cloudwatch. Amazon CloudWatch is automatically enabled by the Presto CFT and the usage metrics data is available in usage-metrics-* log streams.

usage-metrics.gathering.initial-delay

The initial delay to before tracking usage, allowing the cluster to start up before metrics gathering starts.

1 min

usage-metrics.gathering.interval

Length of the interval between usage metric log entry creation.

1 min

usage-metrics.gatherer-threads

Number of threads used to gather and write all usage information.

100, minimum 10

usage-metrics.cluster-usage-resource.enabled

Expose the usage metrics, aggregated for all nodes since cluster start, on a REST API end point on the coordinator at /v1/cluster/usage

false

Logging Details#

The logged information includes details about number of nodes, number of cores, start time, cpu time, and other data about the cluster and nodes in the cluster. The log uses JSON format for each entry.