blob: b257bfd8f22fbaa1e8d731aceebe069e833465cc (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
|
Rsyslog Documentation Review Proposal
=====================================
Currently the Rsyslog documentation is spread over many places. It's not logical
and well-organized as well. The objective of this proposal is to address those issues
and establish a procedure for further development of the documentation.
.. note::
We SHOULD NOT write examples using mixed formats, RainerScripts and legacy. It confused
the readers. We can provide them in both formats, but should not mix them.
Compile information from current sources of information
-------------------------------------------------------
Below are listed the official locations where documentation about Rsyslog can be found.
* Wiki: http://wiki.rsyslog.com/index.php/Main_Page
* Rainer's blog: https://rainer.gerhards.net/2012/10/how-to-use-rsyslogs-ruleset-and-call.html
* Issues: https://github.com/rsyslog/rsyslog
* docs: https://github.com/rsyslog/rsyslog-doc
* Forum: http://kb.monitorware.com/configuration-f36.html
* https://www.youtube.com/user/rainergerhards
Add a Cookbook Section
----------------------
We should create some cookbooks to help people get started with Rsyslog.
Some candidates to be a cookbook are below.
* http://sickbits.net/log-storage-and-analysis-infrastructure-reliable-logging-and-analysis-with-rsyslog-and-relp/
* http://kb.monitorware.com/omfile-with-dynfile-syslogfacility-text-t12515.html
* http://www.freeipa.org/page/Howto/Centralised_Logging_with_Logstash/ElasticSearch/Kibana
Add a subsection called "processing logs from". We'd place articles that'd would help people with specific
common scenarios for a specific log sender application.
Add a Reference Section
-----------------------
This section would have all the reference configuration of all possible tags, in both formats, RainerScript
and legacy.
Write articles that address common problems
-------------------------------------------
Some of the common are following.
* https://github.com/rsyslog/rsyslog/issues/160
* http://kb.monitorware.com/nginx-logging-rsyslog-t12359.html
* http://trac.nginx.org/nginx/ticket/677
Extra
-----
Some resources worth taking a look.
* https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/System_Administrators_Guide/ch-Viewing_and_Managing_Log_Files.html
* https://www.usenix.org/system/files/login/articles/06_lang-online.pdf
* https://media.readthedocs.org/pdf/rsyslog/latest/rsyslog.pdf
* http://download.rsyslog.com/rainerscript2_rsyslog.conf
* http://people.redhat.com/pvrabec/rpms/rsyslog/rsyslog-example.conf
* http://www.rsyslog.com/doc/syslog_parsing.html
Initial Summary
---------------
- Troubleshooting
* http://www.rsyslog.com/how-can-i-check-the-config/
Proposed Documentation Structure
--------------------------------
toctree::
new_documentation/index
|