# stardog-admin log print Manual Page

# NAME

stardog-admin log print —Prints the contents of an access or audit log. A log is a sequence of events where each event has a type, timestamp, user, ip, flags, and an optional value.

# SYNOPSIS

stardog-admin log print [ --binary ] [ {-d | --delimeter} <delimeter> ] [ {-f | --field} <field>... ] [ --filter <filter>... ] [ --json ] [ {-n | --lines} <lines> ] [ --tail ] [ --text ] [--] <log file>...

# OPTIONS

--binary
Used to indicate that the log file is in binary protobuf format. By default logs are expected to be in JSON format.
-d <delimeter>, --delimeter <delimeter>
Delimiter to use for separating fields in the output. By default the output is printed in a tabular format but this option can be used to output in CSV or TSV format.
-f <field>, --field <field>
Fields to include in the output. Allowed values are: {Time, Event, Database, User, IP, Value, Query, Flags}
--filter <filter>
Filter expressions to hide certain events. A filter expression is in the form 'field op value' where field is one of the fields defined in --field option, op is one of '=', '<', '<=', '>', '>=', or '~', and value should be a valid value for the field. For example,filter expression for time field should use xsd:date or xsd:dateTime values. The op '~' represents regular expression matching where value should be a valid Java regular expression and should match the entire value of the given field. Valid values for event field are: { AddRole, AddUser, AddUserRole, Authentication, Backup, ChangePassword, ChangeUserEnabled, ConnectionClose, ConnectionOpen, Copy, CreateDatabase, DataAdd, DataRemove, DataRemoveAll, DataRemoveContext, DeleteRole, DeleteUser, DeleteUserRole, DropDatabase, GetEffectiveUserPermissions, GetEnabledStatus, GetOption, GetRolePermissions, GetSuperStatus, GetUserPermissions, GetUserRoles, GetUsersWithRole, ListRoles, ListUsers, Migrate, Offline, Online, Optimize, Query, QueryEnd, Repair, Restore, RolePermissionGrant, RolePermissionRevoke, SetEnabledStatus, SetOption, SetSuperStatus, SetUserRoles, Shutdown, Startup, StoredQueryAdded, StoredQueryRemoved, StoredQueryUpdated, TxBegin, TxCommit, TxRollback, UserPermissionGrant, UserPermissionRevoke, WildcardPermissionRevoke }
--json
Display results in JSON.
-n <lines>, --lines <lines>
The number of lines to output from the bottom of the file. -1 is the default and means every line.
--tail
Wait for new events to be logged and print them as they are logged.
--text
Used to indicate that the log file is in text protobuf format. By default logs are expected to be in JSON format.
--
This option can be used to separate command-line options from the list of argument, (useful when arguments might be mistaken for command-line options
<log file>
The log file(s) to print

# EXAMPLES

Print all the events in the log file

        $ stardog-admin log print access.log

Print all the events but show only the specified fields

        $ stardog-admin log print --field time user database query -- access.log

Print only query events for the databases matching the regular expression that occurred in a specific time interval

        $ stardog-admin log print --filter event=query database~customer.* time>=2014-01-06 time<=2014-01-07 -- audit.log