List Logs

Query over every log generated by PlusAuth belongs to your tenant.

DateMath Reference
:

If you are used to ElasticSearch, Kibana or Grafana date math queries, than you can ignore this section as PlusAuth includes same characteristics with them.

The expression starts with an anchor date, which can either be now, or a date string ending with ||. This anchor date can optionally be followed by one or more maths expressions:

  • +1h: Add one hour
  • -1d: Subtract one day
  • /d: Round down to the nearest day

The supported units are:

Time UnitDuration
yYears
MMonths
wWeeks
dDays
hHours
HHours
mMinutes
sSeconds

Assuming now is 2001-01-01 12:00:00, some examples are:

ExpressionDescriptionResolves To
now+1hnow in milliseconds plus one hour2001-01-01 13:00:00
now-1hnow in milliseconds minus one hour2001-01-01 11:00:00
now-1h/dnow in milliseconds minus one hour, rounded down to UTC 00:002001-01-01 00:00:00
Scopes
read:log
limit
integer
min0
max
1000

Limit the number of results returned

offset
integer
min0
max
99999999999999

Page number of records you wish to skip before selecting records. Final skipped records count would be limit * offset.

from
string

Filter logs occurred after this date. This can be a datetime string or date math expression.

to
string

Filter logs occurred until this date. This can be a datetime string or date math expression.

type
string

Type/s of logs to be retrieved. Comma separated. Ex.: error,warning,info

operation
string

Retrieve logs belongs to one or more operation. Comma separated. Ex.: authorization.error,create.user