We have new documentation
You can find our new up-to-date documentation in the new Administration Guide at
syslog-ng.github.io.
Highlights
Default config version in configuration files
cfg: allow usage of current in config @version by default if it is not presented
This change allows syslog-ng to start even if the @version information is not present in the configuration file and treats the version as the latest in that case.
NOTE: syslog-ng will still raise a warning if
@version is not present. Please use
@version: current to confirm the intention of always using the latest version and silence the warning. (
#5030)
BSD directory monitoring with kqueue
directory-monitor: Added a kqueue based directory monitor implementation.
wildcard-file() sources are using a
directory monitor as well to aid detection of changes in the folders of the followed files. The new kqueue-based directory monitor uses far fewer resources than the
poll based version on BSD-based systems.
(
#5022)
Wildcard file source fine-tuning
wildcard-file(): Added a dedicated monitor_freq option to control the poll frequency of the change detection in the directories separately when the
poll method is selected via the monitor-method() option.
The
monitor-method() option controls only the change detection method in the directories, not the following of the file changes, and if
poll is the selected method the frequency must not necessarily be the same, e.g. if the (earlier) commonly used
follow-freq() is set to 0 for switching to the
poll_fd_events method for file content change detection, that also might be meant a directory change poll with zero delays (if
monitor-method() was set to
poll as well), and that could cause a heavy CPU load unnecessarily.
(
#4998)
Features
-
s3(): Introduced server side encryption related options
server-side-encryption() and
kms-key() can be used to configure encryption.
Currently only server-side-encryption("aws:kms") is supported.
The kms-key() should be:
To be able to use the aws:kms encryption the AWS Role or User has to have the following
permissions on the given key:
Check
this page on why the
kms:Decrypt is mandatory.
Example config:
destination d_s3 {
s3(
bucket("log-archive-bucket")
object-key("logs/syslog")
server-side-encryption("aws:kms")
kms-key("alias/log-archive")
);
};
See the
S3 documentation for more details.
(
#4993)
-
an ID of a key
-
an alias of a key, but in that case you have to add the alias/prefix
-
an ARN of a key
-
kms:Decrypt -
kms:Encrypt -
kms:GenerateDataKey
-
filter: Added numerical severity settings.
The level filter option now accepts numerical values similar to
facility.
Example config:
filter f_severity {
level(4)
};
This is equivalent to
filter f_severity {
level("warning")
};
-
opentelemetry(),
loki(), bigquery(): Added headers() option
Enables adding headers to RPC calls.
Example config:
opentelemetry(
...
headers(
"my_header" = "my_value"
)
);
-
Added new proxy options to the syslog() and network() source drivers
The
transport(proxied-tcp),
transport(proxied-tls), and
transport(proxied-tls-passthrough) options are now available when configuring
syslog() and
network() sources.
(
#4544)
Bugfixes
-
disk-buffer(): fix crash when pipeline initialization fails
log_queue_disk_free_method: assertion failed: (!qdisk_started(self->qdisk))
(
#4994)
-
rate-limit(): Fixed a crash which occured on a config parse failure.
(
#5033)
-
Fixed potential null pointer deref issues
(
#5035)
-
wildcard-file(): fix a crash and detection of file delete/move when using ivykis poll events
Two issues were fixed
-
Fixed a crash in log pipe queue during file deletion and EOF detection (
#4989)
The crash was caused by a concurrency issue in the EOF and file deletion detection when using a
wildcard-file() source.
If a file is written after being deleted (e.g. with an application keeping the file open), or if these events happen concurrently, the file state change poller mechanism might schedule another read cycle even
though the file has already been marked as fully read and deleted.
To prevent this re-scheduling between these two checks, the following changes have been made:
Instead of maintaining an internal EOF state in the WildcardFileReader, when a file deletion notification is received, the poller will be signaled to stop after reaching the next EOF. Only after both conditions are set the reader instance will
be deleted.
-
Fixed the file deletion and removal detection when the
file-reader uses
poll_fd_events to follow file changes, which were mishandled. For example, files that were moved or deleted (such as those rolled by a log-rotator) were read to the end but never read again if they were not touched
anymore, therefore switching to the new file never happened.
(
#4998)
-
syslog-ng-ctl query: fix showing Prometheus metrics as unnamed values
none.value=726685
(
#4995)
-
macros: Fixed a bug which always set certain macros to string type
The affected macros are
$PROGRAM,
$HOST and
$MESSAGE.
(
#5024)
-
syslog-ng-ctl query: show timestamps and fix
g_pattern_spec_match_string assert
(
#4995)
-
csv-parser(): fix escape-backslash-with-sequences dialect on ARM
csv-parser() produced invalid output on platforms where char is an unsigned type.
(
#4947)
Other changes
-
bigquery(),
loki(), opentelemetry(), cloud-auth(): C++ modules can be compiled with clang
Compiling and using these C++ modules are now easier on FreeBSD and macOS.
(
#4933)
-
syslog-ng-ctl: do not show orphan metrics for
stats prometheus
As the stats prometheus command is intended to be used to forward metrics
to Prometheus or any other time-series database, displaying orphaned metrics
should be avoided in order not to insert new data points when a given metric
is no longer alive.
In case you are interested in the last known value of orphaned counters, use
the
stats or
query subcommands.
(
#4921)
-
s3(): new metric
syslogng_output_event_bytes_total
(
#4958)
-
multiline-options: Allow
multi_line_timeout to be set to a non-integer value.
Since
multi_line_timeout is suggested to be set as a multiple of
follow-freq, and
follow-freq can be much smaller than one second, it makes sense to allow this value to be a non-integer as well.
(
#5002)
-
packages/dbld: add support for Ubuntu 24.04 (Noble Numbat)
(
#4925)
-
packages/dbld: add support for AlmaLinux 9
(
#5009)
-
packages/dbld: added support for Fedora Rawhide and CentOS Stream 9 as testing platforms
(
#5009)
Credits
syslog-ng is developed as a community project, and as such it relies
on volunteers, to do the work necessarily to produce syslog-ng.
Reporting bugs, testing changes, writing code or simply providing
feedback are all important contributions, so please if you are a user
of syslog-ng, contribute.
We would like to thank the following people for their contribution:
Alex Becker, Andras Mitzki, Arpad Kunszt, Attila Szakacs,
Balazs Scheidler, Bálint Horváth, Dmitry Levin, Hofi, Ilya Kheifets,
joohoonmaeng, ktzsolt, László Várady, Mate Ory, Natanael Copa,
Peter Czanik, qsunchiu, Robert Fekete, shifter, Szilárd Parrag,
Tamas Pal, Wolfram Joost