diff --git a/docs/api.md b/docs/api.md index 51e1544f0a72d656886ed17a2e2c03df50684e44..cea4c21813dc57865bad2a07e91aa5878934a8b6 100644 --- a/docs/api.md +++ b/docs/api.md @@ -26,12 +26,12 @@ The Loki server has the following API endpoints (_Note:_ Authentication is out o For doing queries, accepts the following parameters in the query-string: - - `query`: a logQL query + - `query`: a [logQL query](./usage.md) (eg: `{name=~"mysql.+"}` or `{name=~"mysql.+"} |= "error"`) - `limit`: max number of entries to return - - `start`: the start time for the query, as a nanosecond Unix epoch (nanoseconds since 1970) or as RFC3339Nano (eg: "2006-01-02T15:04:05.999999999Z07:00"). Default is always one hour ago. - - `end`: the end time for the query, as a nanosecond Unix epoch (nanoseconds since 1970) or as RFC3339Nano (eg: "2006-01-02T15:04:05.999999999Z07:00"). Default is current time. + - `start`: the start time for the query, as a nanosecond Unix epoch (nanoseconds since 1970) or as RFC3339Nano (eg: "2006-01-02T15:04:05.999999999-07:00"). Default is always one hour ago. + - `end`: the end time for the query, as a nanosecond Unix epoch (nanoseconds since 1970) or as RFC3339Nano (eg: "2006-01-02T15:04:05.999999999-07:00"). Default is current time. - `direction`: `forward` or `backward`, useful when specifying a limit. Default is backward. - - `regexp`: a regex to filter the returned results, will eventually be rolled into the query language + - `regexp`: a regex to filter the returned results Loki needs to query the index store in order to find log streams for particular labels and the store is spread out by time, so you need to specify the start and end labels accordingly. Querying a long time into the history will cause additional diff --git a/docs/logentry/processing-log-lines.md b/docs/logentry/processing-log-lines.md index 55e740cf84e6f1dc1859ccde06d906c9e1084c97..c3ff04db933382e3de9f5312ef70f4da9f53e7b2 100644 --- a/docs/logentry/processing-log-lines.md +++ b/docs/logentry/processing-log-lines.md @@ -250,8 +250,8 @@ RFC822Z = "02 Jan 06 15:04 -0700" // RFC822 with numeric zone RFC850 = "Monday, 02-Jan-06 15:04:05 MST" RFC1123 = "Mon, 02 Jan 2006 15:04:05 MST" RFC1123Z = "Mon, 02 Jan 2006 15:04:05 -0700" // RFC1123 with numeric zone -RFC3339 = "2006-01-02T15:04:05Z07:00" -RFC3339Nano = "2006-01-02T15:04:05.999999999Z07:00" +RFC3339 = "2006-01-02T15:04:05-07:00" +RFC3339Nano = "2006-01-02T15:04:05.999999999-07:00" ``` Additionally support for common Unix timestamps is supported: