7.9. 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 disable it or configure details.

Usage Metrics Configuration Properties#
Property name Description Default value
usage-metrics.log.enabled Toggle to enable or disable usage metrics tracking true
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.