the doc link at the bottom of the main page is https://href.li/?http://http://www.rsyslog.com/doc/v8-devel/ instead of http://www.rsyslog.com/doc/v8-devel/

Currently the v8-stable documentation is not listed in the Help menu.

It's confusing having "7.4.0 – the new stable" under Top News, when 7.6 (or specifically 7.6.2) is the current stable release.

Reported by Thomas D.

If you are on http://www.rsyslog.com/doc/, the submenu items
(v8-devel, v7-stable) aren't visible... white on white. Could be related
to 1 or another problem. Google understands invisible links and treats
them as forbidden SEO.

http://www.rsyslog.com/plugins/ must be consolidated with the graphical image on the homepage. In the longer term, we must find a better way to convey what is available and how it can be used.

This is related to #16

(Copied from rsyslog/rsyslog-doc#35)
See attached screenshot

After loading the documentation, the drop-down list is broken, the doc menu items are invisible. Might be a CSS issue.

Hi,

currently, the documentation with code examples looks like

Often I have to increase the size by hand to see all the content. Doesn't the following design looks better?

I applied

box-sizing: border-box;
width: 100%;

to the textarea element (box-sizing: border-box; makes the magic), to achieve this design.

Reported by Thomas D.

These sub folders aren't in your sitemap
(http://www.rsyslog.com/files/sitemap.xml.gz). And due to "weekly" for
"doc", changes may take a week to be recognized by Google.

This page http://www.rsyslog.com/project-status/ should somehow be merged with the other version info page/box.

more precisely, a visible newsfeed, not just a link to the news list. At a minimum, it must contain the post date and heading. Probably that's also sufficient, as it must not clutter the page.

It would be great if the omprog output module could be configured in the configuration wizard as well.

Currently it's fairly hard to find the links to repositories. Not sure what the best solution is, here are few ideas:

• put them in the Project menu (similar to the old rsyslog page)
• 'Current versions' block on the right could be called 'Installation' or 'Downloads' or 'Where to get rsyslog' and the headline could be a link (to a page descibed below)
• www.rsyslog.com/downloads/download-other/ and www.rsyslog.com/downloads/ could be just one page that lists all repositories as well as packages (tarballs) that one can download

Similarly I don't see obvious links to github, it would be great if they are listed together with other places where one can get Rsyslog. There is a link to github in Community block in lower right corner which is virtually invisible (maybe it's just me:)

On http://www.rsyslog.com/doc/v8-stable/configuration/modules/pmrfc3164.html the parser parameter "permit.squarebracketsinhostname" is described as "permit.squarevracketsinhostname".

Also the heading claims that the module will "Parse RFC3161-formatted messages" rather than rfc3164.

Please provide a complete example, somewhere, of how to set up remote logging using RELP.

The documentation is somewhat piecemeal as it comes to the omrelp and imrelp modules. Documentation found on the web indicates that RELP is now the standard, yet there is nothing in the rsyslog docs themselves that indicates this. In particular, there is no obvious clarification whether omrelp is required on the sending/client side of remote logging if imrelp is being used on the server side.

Also, I see that my distro (devuan) does not install librelp0 by default. Since this library is, per rsyslog docs, a requirement for using omrelp and imrelp, clearly RELP cannot be enabled by default, at least on my distro. By carefully tracking down these various pieces of information, I conclude that to use readmode=2 of the imrelp module (reliably, if at all?) one needs to install librelp0 and explicitly configure omrelp and imrelp on the respective servers. (Can the paragraph mode even be used on the server, reliably or otherwise, if the sender is not using omrelp? Seems to me not, but without deep source code inspection, I am not entirely certain.)

It would be gratifying for the documentation to completely and holistically clarify this because I am not entirely sure I have arrived at the correct conclusion. A complete example illustrating the action on each side would be helpful, though maybe not necessary if the documentation were thorough enough.

1. Available here: http://www.rsyslog.com/downloads/download-other/
2. Not here: http://www.rsyslog.com/downloads/download-v8-stable/

http://www.rsyslog.com/doc/v8-stable/configuration/basic_structure.html#inputs has a "rsyslog modules" link to http://www.rsyslog.com/doc/v8-stable/configuration/rsyslog_conf_modules.html but that just says "Invalid file specified". Note, it returns 200 OK and not 404, so that's another problem.

The "Rules" link bottom of the page https://www.rsyslog.com/download/files/windows-agent-manual/configuringmonitorwareagent.html is dead. The destination page just says "Page not found" now, and I successfully read the contents via internet archive. Currently http://www.monitorware.com/common/en/concepts/rules-mwa12.php seems to be the correct destination page. Would the link to be fixed?

currently there is the text:

Current Versions

stable: 7.6.0

devel: 8.0.2

make these be links to http://www.rsyslog.com/download/stable-download/ and http://www.rsyslog.com/download/devel-download/

I would seriously consider adding the three links to the different repos here as well (everything under the downloads menu at the top of the page) It may also be worth putting a link to 'how to compile from source' or 'how to get git version' in one of both of these locatins.

8.31 is the last version listed.

Can we do that via a WP-integrated Q&A software package? If not, how can we add the forum so that users can make best use out of it?

Hello,

could you please tell me whether "Add filter" feature works or not? I'm not able to add any filter while building a new rsyslog configuration. Is that me doing something wrong? When I get down to the tab "Add filter" I don't see any button to click on. I've tried several browsers such as FF/Chrome/IE, none of them worked.

Thank you in advance!

Error message provided by rsyslog for a local log file I'm writing via omfile:

file '/var/log/mysql/mysqld.log': open error: Permission denied [v8.36.0 try http://www.rsyslog.com/e/2433 ]

When visiting the provided link I was sent to https://www.rsyslog.com/?s=error+2433 and given this error message:

Nothing Found
Sorry, but nothing matched your search terms. Please try again with some different keywords.

Most probably this should replace "related products", which isn't really useful (and should either be removed or moved to some small-print in the footer line).

Config builder URL is

http://www.rsyslog.com/rsyslog-configuration-builder/

Page: http://www.rsyslog.com/doc/rsyslog_conf_examples.html

Contains invalid examples such as *.=emerg *, which need to be changed

Outdated, must be revamped, most probably replaced by more than one page:

http://www.rsyslog.com/features/

At least ubuntu (now PPA) must be updated.

It should point to a page that lists the available version choices.

Snippet from a mailing list discussion:

So how about this?

• do not mention forum any longer
• say "github is for questions"
• say "SE is experimentally for questions, but less likely to draw
  answers from team"
• keep "mailing list is great to ask questions"

update this in doc, site etc.

If nobody violently objects by monday morning, let's implement the
changes. We may not get everything immediately, but that's it. I'll
see that I can change the forum to read-only, but that needs to go to
web guys and is not top priority.

Rainer

@rgerhards @alorbach

refs rsyslog/rsyslog-doc#622

On http://www.rsyslog.com/doc/v8-stable/configuration/modules/imtcp.html there is no mention of module parameter "streamdriver.name" or its possible values.

The current one for sure is better than the previous one, but it still needs some streamlining.

when you click on RELP you get the GSSAPI page, and everything below that is off as well

On http://www.rsyslog.com/doc/v8-stable/configuration/modules/imtcp.html the module parameter section is named "global parameters" and the input parameter section is named "action parameters".

To avoid manual maintenance, link directly to the github ChangeLogs (which are obviously automatically correct). Then, we can also link to each of the stable versions AND master branch (as "devel").

A sample link for v7-stable is:
https://github.com/rsyslog/rsyslog/blob/v7-stable/ChangeLog

I tried using the config builder, but it never adds my rules, or changes. Simply goes back to blank screen like I had never typed in anything.

Hello,

After navigating to https://www.rsyslog.com/downloads/download-v8-stable/ and clicking on download link it results 404 for https://www.rsyslog.com/files/download/rsyslog/rsyslog-8.2006.0.tar.gz

Same happens for all links in https://www.rsyslog.com/downloads/download-other/ (eg. http://www.rsyslog.com/download/files/download/rsyslog/rsyslog-8.2004.0.tar.gz )

Reported by Thomas D.

There's no space between attributes:

<li id="menu-item-1366" class="menu-item menu-item-type-custom
menu-item-object-custom menu-item-has-children dropdown
menu-item-1366"data-dropdown="dropdown"><a href="/guides/"
class="dropdown-toggle">HELP <b class="caret"></b> </a>

should become

<li id="menu-item-1366" class="menu-item menu-item-type-custom
menu-item-object-custom menu-item-has-children dropdown menu-item-1366"
data-dropdown="dropdown"><a href="/guides/" class="dropdown-toggle">HELP
<b class="caret"></b> </a>

(missing space before "data-dropdown=")

For -> http://www.rsyslog.com/rsyslog-configuration-builder/

Have an option for adding a template(s)

When selection actions have a list of the templates defined *or at least the ones which are already within rsyslog.

The work around is to simply add the semicolon and template name!

These require a bit different escaping than the traditional $template string (which actually did the escaping wrong...).

Backstory

See irskep/sphinx-better-theme#32 for details, but due to how PyPi handled the version of the older package and the newer, the old package was installed by default unless the user opted to override it with the latest version. The package maintainer removed the old version (0.13) so that only the newest one (0.1.5) is available via PyPi.

The changes since that version are listed here:

https://sphinx-better-theme.readthedocs.io/en/latest/

Situation

I checked and have confirmed that the old version of the sphinx-better-theme package is installed in the rsyslog/rsyslog_doc_gen_website image.

Opening this ticket in order to have the Docker image updated to include the latest version.

Proof

Output from testing/checking the version:

ubuntu@ubuntu-1604-virtual-machine:~/Desktop$ sudo docker pull rsyslog/rsyslog_doc_gen_website

Using default tag: latest
latest: Pulling from rsyslog/rsyslog_doc_gen_website
2fdfe1cd78c2: Pull complete 
1cd4a3ec306a: Pull complete 
24fcc0ddf03d: Pull complete 
43c871a80e9b: Pull complete 
67ae96d55649: Pull complete 
c239b83d8d92: Pull complete 
4fc5cdc94999: Pull complete 
7427d256772d: Pull complete 
d9cfd4dc9e81: Pull complete 
Digest: sha256:e49dde128a2ba3a5d3b7e5af9b63fbd714735159cf252440009c0155c990585e
Status: Downloaded newer image for rsyslog/rsyslog_doc_gen_website:latest
ubuntu@ubuntu-1604-virtual-machine:~/Desktop$ sudo docker run -ti rsyslog/rsyslog_doc_gen_website bash
You are now in Alpine's ash

/home/appliance # pip list

DEPRECATION: The default format will switch to columns in the future. You can use --format=(legacy|columns) (or define a format=(legacy|columns) in your pip.conf under the [list] section) to disable this warning.
alabaster (0.7.10)
Babel (2.5.3)
certifi (2018.1.18)
chardet (3.0.4)
docutils (0.14)
idna (2.6)
imagesize (0.7.1)
Jinja2 (2.10)
MarkupSafe (1.0)
pip (9.0.1)
Pygments (2.2.0)
pytz (2018.3)
requests (2.18.4)
setuptools (33.1.1.post20171031)
six (1.11.0)
snowballstemmer (1.2.1)
Sphinx (1.6.7)
sphinx-better-theme (0.13)
sphinxcontrib-websupport (1.0.1)
typing (3.6.4)
urllib3 (1.22)

Concerns:

Installing/trusting a package signing key would probably best be handled by downloading that key over an encrypted connection. As it stands now, the key only appears to be available over an unencrypted connection.

Once this is done, the rsyslog.repo files would need to be updated to reference the new https support.

-gpgkey=http://rpms.adiscon.com/RPM-GPG-KEY-Adiscon
+gpgkey=https://rpms.adiscon.com/RPM-GPG-KEY-Adiscon

On http://www.rsyslog.com/doc/v8-stable/configuration/modules/imtcp.html there are links "network stream driver" to http://www.rsyslog.com/doc/v8-stable/configuration/modules/netstream.html but that page exclaims "Invalid file specified". Possibly http://www.rsyslog.com/doc/v8-stable/concepts/netstrm_drvr.html would be the correct destination.

When writing a post it seems that line breaks are not honored by the template. Either line breaks in the Visual view and the Text view of the editor are shown in the editor, but not when viewing the post.

Even HTML line breaks do not work as expexted. Not with < br > tags nor with < div > tags.

• do not center text
• it is NOT just about regexp, clarify this

On http://www.rsyslog.com/doc/v8-stable/configuration/modules/imptcp.html the input parameter "notifyonconnectionclose" is described as "servernotifyonconnectionclose".

This page:

http://www.rsyslog.com/debian-repository/

Probably needs to be updated to point to the repos mentioned here:

http://blog.gerhards.net/2018/01/experimental-debian-rsyslog-packages.html