presto-audit icon indicating copy to clipboard operation
presto-audit copied to clipboard

THIS REPOSITORY IS DEPRECATED

⛔️ THIS REPOSITORY IS DEPRECATED ⛔️

This repository is no longer maintained. Please refer to the following developer guides:

  • https://prestodb.io/docs/current/develop/event-listener.html
  • https://trino.io/docs/current/develop/event-listener.html

Presto Query Audit Log(log history)

Plugin for Presto to save queries and metrics into files.

Build Status

Requirement

  • Presto 0.193 or later

Build

% ./mvnw clean compile package

packaging - rpm

% ./mvnw clean compile package rpm:rpm

Usage

install

Copy jar file to target directory.

% export PLUGIN_VER=1.0
% cp target/presto-audit-plugin-${PLUGIN_VER}-SNAPSHOT-all.jar /usr/lib/presto/lib/plugin/yj-audit/

run

create a event-listener.properties file under /etc/presto/ .

eg. /etc/presto/event-listener.properties

event-listener.name=presto-audit-log
event-listener.audit-log-path=/var/log/presto/
event-listener.audit-log-filename=presto-auditlog.log

full log

To enable full log, add the following line to the file

event-listener.audit-log-full-filename=presto-auditlog-full.log

To add a filter for full log, add the following line to the file. The filter should be a regex. If the filter match with --source of a query, this query will not be logged in full log.

# Format:
event-listener.audit-log-full-filter=<regex>

# Example:
event-listener.audit-log-full-filter=SRE_SYSTEM
event-listener.audit-log-full-filter=(SRE_SYSTEM|Presto-team)

Send message to Pulsar broker

Send the log to Pulsar broker immediately after a query is completed. Config:

event-listener.pulsar.simple-log-topic=persistent://namespace/global/test/topic1
event-listener.pulsar.full-log-topic=persistent://namespace/global/test/topic2
event-listener.pulsar.pulsar-url=pulsar+ssl://pulsar.cluster.com:6651
event-listener.pulsar.pulsar-cert-path=/etc/pki/tls/certs/ca-bundle.crt
event-listener.pulsar.use-TLS=true  # Optional
event-listener.pulsar.compression-type=ZLIB  # Optional (default: NONE)
event-listener.athenz.private-key-path=/etc/presto/athenz/private.key
event-listener.athenz.tenant-domain=tenant.pulsar.tenant
event-listener.athenz.tenant-service=mq
event-listener.athenz.provider-domain=provider.plusar.tenant
event-listener.athenz.config-path=/usr/local/etc/pulsar-athenz-config/athenz.conf
event-listener.athenz.principal-header=Athenz-Principal-Auth
event-listener.athenz.role-header=Athenz-Role-Auth

Analyze SQL samples

Table DDL can be found in src/sql/ddl.sql

SELECT
    date_parse(executionStartTime, '%Y%m%d%H%i%S.%f') AS EXEC_START,
    state,
    date_diff('millisecond', date_parse(executionStartTime, '%Y%m%d%H%i%S.%f'), date_parse(endTime, '%Y%m%d%H%i%S.%f')) AS PRESTO_EXEC_TIME_MS
FROM
    presto_audit
WHERE
    ymd = '20170912' AND createTime > '20170912233000.572'
ORDER BY
    createTime;