Fixes `docs/` and `README.md` typos and errors.
Signed-off-by: Arkadii Yakovets <ark@victoriametrics.com>
(cherry picked from commit c740a8042e
)
Signed-off-by: hagen1778 <roman@victoriametrics.com>
32 KiB
sort | weight | title | menu | aliases | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
7 | 7 | VictoriaLogs changelog |
|
|
VictoriaLogs changelog
The following tip
changes can be tested by building VictoriaLogs from the latest commit of VictoriaMetrics repository
according to these docs
tip
v0.15.0
Released at 2024-05-30
-
FEATURE: add
row_any
function forstats
pipe. This function returns a sample log entry per every calculated group of results. -
FEATURE: add
default
operator tomath
pipe. It allows overridingNaN
results with the given default value. -
FEATURE: add
exp()
andln()
functions tomath
pipe. -
FEATURE: allow omitting result name in
math
pipe expresions. In this case the result name is automatically set to string representation of the corresponding math expression. For example,_time:5m | math duration / 1000
is equivalent to_time:5m | math (duration / 1000) as "duration / 1000"
. -
FEATURE: allow omitting result name in
stats
pipe. In this case the result name is automatically set to string representation of the corresponding stats function expression. For example,_time:5m | count(*)
is valid LogsQL query now. It is equivalent to_time:5m | stats count(*) as "count(*)"
. -
BUGFIX: properly calculate the number of matching rows in
* | field_values x | stats count() rows
and in* | unroll (x) | stats count() rows
queries.
v0.14.0
Released at 2024-05-29
-
FEATURE: allow specifying fields, which must be packed into JSON in
pack_json
pipe viapack_json fields (field1, ..., fieldN)
syntax. -
BUGFIX: properly apply
if (...)
filters to calculated results instats
pipe when grouping by fields is enabled. For example,_time:5m | stats by (host) count() logs, count() if (error) errors
now properly calculates per-host
errors
.
v0.13.0
Released at 2024-05-28
- FEATURE: add
extract_regexp
pipe for extracting arbitrary substrings from log fields with RE2 regular expressions. - FEATURE: add
math
pipe for mathematical calculations over log fields. - FEATURE: add
field_values
pipe, which returns unique values for the given log field. - FEATURE: allow omitting
stats
prefix instats
pipe. For example,_time:5m | count() rows
is a valid query now. It is equivalent to_time:5m | stats count() as rows
. - FEATURE: allow omitting
filter
prefix infilter
pipe if the filter doesn't clash with pipe names. For example,_time:5m | stats by (host) count() rows | rows:>1000
is a valid query now. It is equivalent to_time:5m | stats by (host) count() rows | filter rows:>1000
. - FEATURE: allow
head
pipe without number. For example,error | head
. In this case 10 first values are returned ashead
Unix command does by default. - FEATURE: allow using comparison filters with strings. For example,
some_text_field:>="foo"
matches log entries withsome_text_field
field values bigger or equal tofoo
.
v0.12.1
Released at 2024-05-26
-
FEATURE: add support for comments in multi-line LogsQL queries. See these docs.
-
BUGFIX: properly apply
in(...)
filter insideif (...)
conditions at various pipes. This bug has been introduced in v0.12.0.
v0.12.0
Released at 2024-05-26
-
FEATURE: add
pack_json
pipe, which packs all the log fields into a JSON object and stores it into the given field. -
FEATURE: add
unroll
pipe, which can be used for unrolling JSON arrays stored in log fields. -
FEATURE: add
replace_regexp
pipe, which allows updating log fields with regular expressions. -
FEATURE: improve performance for
/select/logsql/field_names
HTTP API. -
BUGFIX: prevent from panic in
sort
pipe when VictoriaLogs runs on a system with one CPU core. -
BUGFIX: do not return referenced fields if they weren't present in the original logs. For example,
_time:5m | format if (non_existing_field:"") "abc"
could return emptynon_exiting_field
, while it shouldn't be returned because it is missing in the original logs. -
BUGFIX: properly initialize values for
in(...)
filter insidefilter
pipe if thein(...)
contains other filters. For example,_time:5m | filter ip:in(user_type:admin | fields ip)
now works correctly.
v0.11.0
Released at 2024-05-25
- FEATURE: add
replace
pipe, which allows replacing substrings in log fields. - FEATURE: support comparing log field values with special numeric values. For example,
duration:>1.5s
andresponse_size:<15KiB
are valid filters now. - FEATURE: properly sort durations and short numeric values in
sort
pipe. For example,10s
goes in front of1h
, while10KB
goes in front of1GB
. - FEATURE: add an ability to preserve the original non-empty field values when executing
extract
,unpack_json
,unpack_logfmt
andformat
pipes. - FEATURE: add an ability to preserve the original field values if the corresponding unpacked values are empty when executing
extract
,unpack_json
,unpack_logfmt
andformat
pipes.
v0.10.0
Released at 2024-05-24
-
FEATURE: return the number of matching log entries per returned value in HTTP API results. This simplifies detecting field / stream values with the biggest number of logs for the given LogsQL query.
-
FEATURE: improve performance for regexp filter in the following cases:
- If the regexp contains just a phrase without special regular expression chars. For example,
~"foo"
. - If the regexp starts with
.*
or ends with.*
. For example,~".*foo.*"
. - If the regexp contains multiple strings delimited by
|
. For example,~"foo|bar|baz"
. - If the regexp contains multiple words. For example,
~"foo bar baz"
.
- If the regexp contains just a phrase without special regular expression chars. For example,
-
FEATURE: allow disabling automatic unquoting of the matched placeholders in
extract
pipe. See these docs. -
BUGFIX: properly parse
!
in front of exact filter, exact-prefix filter and regexp filter. For example,!~"some regexp"
is properly parsed asnot ="some regexp"
. Previously it was incorrectly parsed as'~="some regexp"'
phrase filter. -
BUGFIX: properly sort results by
_time
field whenlimit
pipe is applied. For example,_time:5m | sort by (_time) desc | limit 10
properly works now.
v0.9.1
Released at 2024-05-22
v0.9.0
Released at 2024-05-22
-
FEATURE: allow using
~"some_regexp"
regexp filter instead ofre("some_regexp")
. -
FEATURE: allow using
="some phrase"
exact filter instead ofexact("some phrase")
. -
FEATURE: allow using
="some prefix"*
exact prefix filter instead ofexact("some prefix"*)
. -
FEATURE: add ability to generate output fields according to the provided format string. See these docs.
-
FEATURE: add ability to extract fields with
extract
pipe only if the given condition is met. See these docs. -
FEATURE: add ability to unpack JSON fields with
unpack_json
pipe only if the given condition is met. See these docs. -
FEATURE: add ability to unpack logfmt fields with
unpack_logfmt
pipe only if the given condition is met. See these docs. -
FEATURE: add
row_min
androw_max
functions forstats
pipe, which allow returning all the log fields for the log entry with the minimum / maximum value at the given field. -
FEATURE: add
/select/logsql/streams
HTTP endpoint for returning streams from results of the given query. See these docs for details. -
FEATURE: add
/select/logsql/stream_field_names
HTTP endpoint for returning stream field names from results of the given query. See these docs for details. -
FEATURE: add
/select/logsql/stream_field_values
HTTP endpoint for returning stream field values for the given label from results of the given query. See these docs for details. -
FEATURE: web UI: change time range limitation from
_time
in the expression tostart
andend
query args. -
BUGFIX: fix
invalid memory address or nil pointer dereference
panic when usingextract
,unpack_json
orunpack_logfmt
pipes. See this issue. -
BUGFIX: web UI: fix an issue where logs with long
_msg
values might not display. See this issue. -
BUGFIX: properly handle time range boundaries with millisecond precision. See this issue.
v0.8.0
Released at 2024-05-20
-
FEATURE: add ability to extract JSON fields from log fields. See these docs.
-
FEATURE: add ability to extract logfmt fields from log fields. See these docs.
-
FEATURE: add ability to extract arbitrary text from log fields into the output fields. See these docs.
-
FEATURE: add ability to put arbitrary queries inside
in()
filter. -
FEATURE: add support for post-filtering of query results with
filter
pipe. -
FEATURE: allow applying individual filters per each stats function. See these docs.
-
FEATURE: allow passing string values to
min
andmax
functions. Previously only numeric values could be passed to them. -
FEATURE: speed up
sort ... limit N
pipe for typical cases. -
FEATURE: allow using more convenient syntax for
range
filters if upper or lower bound isn't needed. For example, it is possible to writeresponse_size:>=10KiB
instead ofresponse_size:range[10KiB, inf)
, ortemperature:<42
instead oftemperature:range(-inf, 42)
. -
FEATURE: add
/select/logsql/hits
HTTP endpoint for returning the number of matching logs per the given time bucket over the selected time range. See these docs for details. -
FEATURE: add
/select/logsql/field_names
HTTP endpoint for returning field names from results of the given query. See these docs for details. -
FEATURE: add
/select/logsql/field_values
HTTP endpoint for returning unique values for the given field obtained from results of the given query. See these docs for details. -
BUGFIX: properly take into account
offset
atsort
pipe when it already haslimit
. For example,_time:5m | sort by (foo) offset 20 limit 10
.
v0.7.0
Released at 2024-05-15
- FEATURE: add support for optional
start
andend
query args to HTTP querying API, which can be used for limiting the time range for LogsQL query. - FEATURE: add ability to return the first
N
results fromsort
pipe. This is useful whenN
biggest orN
smallest values must be returned from large amounts of logs. - FEATURE: add
quantile
andmedian
stats functions.
v0.6.1
Released at 2024-05-14
-
FEATURE: use natural sort order when sorting logs via
sort
pipe. -
BUGFIX: properly return matching logs in streams with small number of entries. Previously they could be skipped. The issue has been introduced in the release v0.6.0.
-
BUGFIX: fix
runtime error: index out of range
panic when usingsort
pipe like_time:1h | sort by (_time)
. See this issue.
v0.6.0
Released at 2024-05-12
-
FEATURE: return all the log fields by default in query results. Previously only
_stream
,_time
and_msg
fields were returned by default. -
FEATURE: add support for returning only the requested log fields. See these docs.
-
FEATURE: add support for calculating various stats over log fields. Grouping by arbitrary set of log fields is supported. See these docs for details.
-
FEATURE: add support for sorting the returned results. See these docs.
-
FEATURE: add support for returning unique results. See these docs.
-
FEATURE: add support for limiting the number of returned results. See these docs.
-
FEATURE: add support for copying and renaming the selected log fields. See these and these docs.
-
FEATURE: allow using
_
inside numbers. For example,score:range[1_000, 5_000_000]
forrange
filter. -
FEATURE: allow numbers in hexadecimal and binary form. For example,
response_size:range[0xff, 0b10001101101]
forrange
filter. -
FEATURE: allow using duration and byte size suffixes in numeric values inside LogsQL queries. See these docs.
-
FEATURE: improve data ingestion performance by up to 50%.
-
FEATURE: optimize performance for LogsQL query, which contains multiple filters for words or phrases delimited with
AND
operator. For example,foo AND bar
query must find log messages withfoo
andbar
words at faster speed. -
BUGFIX: prevent from possible corruption of short log fields during data ingestion.
-
BUGFIX: prevent from additional CPU usage for up to a few seconds after canceling the query.
-
BUGFIX: prevent from returning log entries with emtpy
_stream
field in the form"_stream":""
in search query results. See this issue.
v0.5.2
Released at 2024-04-11
- BUGFIX: properly register new log streams under high data ingestion rate. The issue has been introduced in v0.5.0.
v0.5.1
Released at 2024-04-04
- BUGFIX: properly apply time range filter for queries containing
OR
operators. See this issue. - BUGFIX: do not log debug lines
DEBUG: start trimLines
andDEBUG: end trimLines
. This bug has been introduced in v0.5.0 in this commit.
v0.5.0
Released at 2024-03-01
-
FEATURE: support the ability to limit the number of returned log entries from HTTP querying API by passing
limit
query arg. Previously all the matching log entries were returned until closing the response stream. See this feature request. Thanks to @dmitryk-dk for the pull request. -
BUGFIX: do not panic on incorrect regular expression in stream filter. Thanks to @XLONG96 for the bugfix.
-
BUGFIX: properly determine when the assisted merge is needed. Previously the logs for determining whether the assisted merge is needed was broken. This could lead to too big number of parts under high data ingestion rate. Thanks to @lujiajing1126 for the fix.
-
BUGFIX: properly stop execution of aborted query when the query doesn't contain
_stream
filter. Previously such a query could continue consuming resources after being aborted by the client. Thanks to @z-anshun for the fix.
v0.4.2
Released at 2023-11-15
- BUGFIX: properly locate logs for the requested streams. Previously logs for some streams may be missing in query results. See this issue. Thanks to @XLONG96 for the fix!
- BUGFIX: web UI: properly sort found logs by time. See this issue.
v0.4.1
Released at 2023-10-04
- BUGFIX: fix the free space verification process in VictoriaLogs that was erroneously shifting to read-only mode, despite there being sufficient free space available. See this issue.
v0.4.0
Released at 2023-10-03
-
FEATURE: add
-elasticsearch.version
command-line flag, which can be used for specifying Elasticsearch version returned by VictoriaLogs to Filebeat at elasticsearch bulk API. This helps resolving this issue. -
FEATURE: expose the following metrics at /metrics page:
vl_data_size_bytes{type="storage"}
- on-disk size for data excluding log stream indexes.vl_data_size_bytes{type="indexdb"}
- on-disk size for log stream indexes.
-
FEATURE: add
-insert.maxFieldsPerLine
command-line flag, which can be used for limiting the number of fields per line in logs sent to VictoriaLogs via ingestion protocols. This helps to avoid issues like this. -
FEATURE: expose
vl_http_request_duration_seconds
histogram at the /metrics page. Thanks to @crossoverJie for this pull request. -
FEATURE: add support of
-storage.minFreeDiskSpaceBytes
command-line flag to allow switching to read-only mode when running out of disk space at-storageDataPath
. See this issue. -
BUGFIX: fix possible panic when no data is written to VictoriaLogs for a long time. See this issue. Thanks to @crossoverJie for filing and fixing the issue.
-
BUGFIX: add
/insert/loki/ready
endpoint, which is used by Promtail for healthchecks. This should removeunsupported path requested: /insert/loki/ready
warning logs. See this comment. -
BUGFIX: prevent from panic during background merge when the number of columns in the resulting block exceeds the maximum allowed number of columns per block. See this issue.
v0.3.0
Released at 2023-07-20
- FEATURE: add support for data ingestion via Promtail (aka default log shipper for Grafana Loki). See these and these docs.
v0.2.0
Released at 2023-07-17
- FEATURE: support short form of
_time
filters over the last X minutes/hours/days/etc. For example,_time:5m
is a short form for_time:(now-5m, now]
, which matches logs with timestamps for the last 5 minutes. See these docs for details. - FEATURE: add ability to specify offset for the selected time range. For example,
_time:5m offset 1h
is equivalent to_time:(now-5m-1h, now-1h]
. See these docs for details. - FEATURE: LogsQL: replace
exact_prefix("...")
withexact("..."*)
. This makes it consistent with i() filter, which can accept phrases and prefixes, e.g.i("phrase")
andi("phrase"*)
. See these docs.
v0.1.0
Released at 2023-06-21
Initial release