The Real Scope Behind the rsyslog Documentation Overhaul

For a concise Computer Science summary of this effort, see the section at the end of this article.

When I began the current documentation overhaul, the objective was never limited to cleaning up a few pages. From the beginning, the plan was to prepare rsyslog for the AI era. And the truth is simple: without modern AI tooling, this work would not have been feasible at this depth or speed.

Symbolic illustration showing documentation, an AI head, and a graph structure representing RAG.
Continue reading “The Real Scope Behind the rsyslog Documentation Overhaul”

YAML for rsyslog — a new option, not a revolution

rsyslog’s configuration language has grown into a very capable scripting environment — RainerScript — that can express almost anything a log pipeline might need. For complex systems, that won’t change.
But many modern environments — especially containerized and cloud-native ones — expect configuration in YAML. So the idea is simple: rsyslog should understand that world directly.

Symbol image for “Engineering Rational” type of postings. (Image: Rainer Gerhards via AI)
Continue reading “YAML for rsyslog — a new option, not a revolution”

From Stream to Lake: Thinking About rsyslog as the River System Behind Your Data

I recently had a discussion about data lakes. It made me realize that people often picture them as the starting point of data collection — as if all information somehow appears in the lake. In reality, no lake exists without rivers. And in the world of IT systems, rsyslog is part of that river system.

rsyslog is the river system that feeds your data lake. (Image: Rainer Gerhards via AI)
Continue reading “From Stream to Lake: Thinking About rsyslog as the River System Behind Your Data”

Outdated readthedocs problem solved!

I am glad to tell that I finally managed to solve an issue that caused confusion for years. Someone had cloned and published the rsyslog documentation at readthedocs. Unfortunately, it was not maintained afterwards and also looked like an official rsyslog doc. That added a lot to the “rsyslog’s doc is bad and inconsistent” feel inside the community. This could now be resolved, and current, official doc is now available at readthedocs. I am very happy and glad for readthedocs staff members who helped us to finally resolve the issue.

The current rsyslog documentation is finally shown at readthedocs. (Screenshot: 2025-09-18, Rainer Gerhards)
Continue reading “Outdated readthedocs problem solved!”

Status update: omhttp, CI, backlog, and containers

Time goes fast, it is Sep 10 already. Mid August I said we will do a great refactoring of omhttp within a week or two. Well, that did not work out as planned. We still made solid progress, but more pressing work put it on hold for a bit. Time for a small update of what is happening in rsyslog.

Symbol image for “Status Update” type of postings. (Image: Rainer Gerhards via AI)
Continue reading “Status update: omhttp, CI, backlog, and containers”

rsyslog becoming target for social engineering PRs? Lessons learned.

In the past days I noticed PR patterns that do not look right. This is a smell, not a verdict. The upside is real: rsyslog is interesting enough to attract attention. That is actually great news. Now we have the problem ourselves, and that is the moment to engineer the right guardrails without losing our welcoming tone. You need to be a target in order to gain sufficient experience to tackle that hard problem.

IT Security (Symbol Image: Rainer Gerhards via AI)
Continue reading “rsyslog becoming target for social engineering PRs? Lessons learned.”