Skip to content

Commit 07e0524

Browse files
authored
Merge pull request syslog-ng#5007 from HofiOne/Update-readme
Update main README.md
2 parents c791d59 + ef049e0 commit 07e0524

File tree

1 file changed

+42
-57
lines changed

1 file changed

+42
-57
lines changed

README.md

+42-57
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,3 @@
1-
[![Discord](https://img.shields.io/discord/1082023686028148877?label=Discord&logo=discord&logoColor=white)](https://discord.gg/qmq53uBm2c)
21
[![Build Status](https://github.com/syslog-ng/syslog-ng/actions/workflows/devshell.yml/badge.svg)](https://github.com/syslog-ng/syslog-ng/actions/workflows/devshell.yml)
32
[![Nightly](https://github.com/syslog-ng/syslog-ng/actions/workflows/nightly-release.yml/badge.svg)](https://github.com/syslog-ng/syslog-ng/actions/workflows/nightly-release.yml)
43
[![Binary packages](https://github.com/syslog-ng/syslog-ng/actions/workflows/packages.yml/badge.svg)](https://github.com/syslog-ng/syslog-ng/actions/workflows/packages.yml)
@@ -17,7 +16,7 @@ The simplest configuration accepts system logs from /dev/log (from
1716
applications or forwarded by systemd) and writes everything to a single
1817
file:
1918

20-
```
19+
``` config
2120
@version: 4.7
2221
@include "scl.conf"
2322
@@ -29,7 +28,7 @@ log {
2928

3029
This one additionally processes logs from the network (TCP/514 by default):
3130

32-
```
31+
``` config
3332
@version: 4.7
3433
@include "scl.conf"
3534
@@ -43,7 +42,7 @@ log {
4342
```
4443
This config is designed for structured/application logging, using local submission via JSON, and outputting in key=value format:
4544

46-
```
45+
``` config
4746
@version: 4.7
4847
@include "scl.conf"
4948
@@ -55,59 +54,59 @@ log {
5554

5655
To submit a structured log using `logger`, you might run:
5756

58-
```
57+
```shell
5958
$ logger '@cim: {"name1":"value1", "name2":"value2"}'
6059
```
6160

6261
In which case the resulting message will be:
6362

64-
```
63+
``` text
6564
name1=value1 name2=value2
6665
```
67-
For a brief introduction to configuring the syslog-ng application, see the [quickstart guide](https://syslog-ng.github.io/admin-guide/040_Quick-start_guide/README).
6866

67+
For a brief introduction to configuring the syslog-ng application, see the [quickstart guide](https://syslog-ng.github.io/admin-guide/040_Quick-start_guide/README).
6968

7069
## Features
7170

72-
* Receive and send [RFC3164](https://tools.ietf.org/html/rfc3164)
73-
and [RFC5424](https://tools.ietf.org/html/rfc5424) style syslog
74-
messages
75-
* Receive and send [JSON](http://json.org/) formatted messages
76-
* Work with any kind of unstructured data
77-
* Classify and structure logs using built-in parsers (csv-parser(),
78-
db-parser(), kv-parser(), etc.)
79-
* Normalize, crunch, and process logs as they flow through the system
80-
* Hand over logs for further processing using files, message queues (like
81-
[AMQP](http://www.amqp.org/)), or databases (like
82-
[PostgreSQL](http://www.postgresql.org/) or
83-
[MongoDB](http://www.mongodb.org/))
84-
* Forward logs to big data tools (like [Elasticsearch](https://www.elastic.co/),
85-
[Apache Kafka](http://kafka.apache.org/), or
86-
[Apache Hadoop](http://hadoop.apache.org/))
71+
* Receive and send [RFC3164](https://tools.ietf.org/html/rfc3164)
72+
and [RFC5424](https://tools.ietf.org/html/rfc5424) style syslog
73+
messages
74+
* Receive and send [JSON](http://json.org/) formatted messages
75+
* Work with any kind of unstructured data
76+
* Classify and structure logs using built-in parsers (csv-parser(),
77+
db-parser(), kv-parser(), etc.)
78+
* Normalize, crunch, and process logs as they flow through the system
79+
* Hand over logs for further processing using files, message queues (like
80+
[AMQP](http://www.amqp.org/)), or databases (like
81+
[PostgreSQL](http://www.postgresql.org/) or
82+
[MongoDB](http://www.mongodb.org/))
83+
* Forward logs to big data tools (like [Elasticsearch](https://www.elastic.co/),
84+
[Apache Kafka](http://kafka.apache.org/), or
85+
[Apache Hadoop](http://hadoop.apache.org/))
8786

8887
### Performance
8988

90-
* syslog-ng provides performance levels comparable to a large
91-
cluster when running on a single node
92-
* In the simplest use case, it scales up to 600-800k messages per
93-
second
94-
* But classification, parsing, and filtering still produce several
95-
tens of thousands of messages per second
89+
* syslog-ng provides performance levels comparable to a large
90+
cluster when running on a single node
91+
* In the simplest use case, it scales up to 600-800k messages per
92+
second
93+
* But classification, parsing, and filtering still produce several
94+
tens of thousands of messages per second
9695

9796
### Community
9897

99-
* syslog-ng is developed by a community of volunteers, the best way to
100-
contact us is via our [github project page](http://github.com/syslog-ng/syslog-ng)
101-
project, our [gitter channel](https://gitter.im/syslog-ng/syslog-ng) or
102-
our [mailing list](https://lists.balabit.hu/mailman/listinfo/syslog-ng).
103-
* syslog-ng is integrated into almost all Linux distributions and BSDs, it
104-
is also incorporated into a number of products, see our [powered by
105-
syslog-ng](https://syslog-ng.com/powered-by-syslog-ng) page for more details.
98+
* syslog-ng is developed by a community of volunteers, the best way to
99+
contact us is via our [github project page](http://github.com/syslog-ng/syslog-ng)
100+
project, our [gitter channel](https://gitter.im/syslog-ng/syslog-ng) or
101+
our [mailing list](https://lists.balabit.hu/mailman/listinfo/syslog-ng).
102+
* syslog-ng is integrated into almost all Linux distributions and BSDs, it
103+
is also incorporated into a number of products, see our [powered by
104+
syslog-ng](https://syslog-ng.com/powered-by-syslog-ng) page for more details.
106105

107106
### Sponsors
108107

109-
- [Axoflow](https://axoflow.com) is the company of Balazs Scheidler, the original creator and main developer of syslog-ng, and the creators of the Kubernetes Logging Operator. Currently Axoflow is the most active contributor of syslog-ng, and offers commercial support, professional services, and related products.
110108
- [Balabit](http://www.balabit.com/) is the original commercial sponsor of the syslog-ng project, and was acquired by One Identity in 2018. One Identity offers a commercial edition for syslog-ng, called the syslog-ng Premium Edition.
109+
- Axoflow is the company of Balazs Scheidler, the original creator and main developer of syslog-ng.
111110

112111
## Feedback
113112

@@ -146,7 +145,6 @@ development libraries are present. The configure script displays a
146145
summary of enabled features at the end of its run.
147146
For details, see the [syslog-ng compiling instructions](https://syslog-ng.github.io/admin-guide/030_Installing_syslog-ng/000_Compiling_syslog-ng_from_source).
148147

149-
150148
## Installation from binaries
151149

152150
Binaries are available in various Linux distributions and contributors
@@ -184,13 +182,13 @@ syslog-ng packages are released for the following distribution versions (x86-64)
184182

185183
1. Download and install the release signing key:
186184

187-
```
185+
``` shell
188186
wget -qO - https://ose-repo.syslog-ng.com/apt/syslog-ng-ose-pub.asc | sudo apt-key add -
189187
```
190188

191189
2. Add the repository containing the latest build of syslog-ng to the APT sources. For example, stable releases on Ubuntu 22.04:
192190

193-
```
191+
``` shell
194192
echo "deb https://ose-repo.syslog-ng.com/apt/ stable ubuntu-noble" | sudo tee -a /etc/apt/sources.list.d/syslog-ng-ose.list
195193
```
196194

@@ -202,15 +200,15 @@ Nightly packages are built and released from the git `master` branch everyday.
202200

203201
Use `nightly` instead of `stable` in step 2 to use the nightly APT repository. E.g.:
204202

205-
```
203+
``` shell
206204
echo "deb https://ose-repo.syslog-ng.com/apt/ nightly ubuntu-noble" | sudo tee -a /etc/apt/sources.list.d/syslog-ng-ose.list
207205
```
208206

209207
Nightly builds can be used for testing purposes (obtaining new features and bugfixes) at the risk of breakage.
210208

211209
### Arch Linux
212210

213-
```
211+
``` shell
214212
# pacman -S syslog-ng
215213
```
216214

@@ -219,7 +217,7 @@ Nightly builds can be used for testing purposes (obtaining new features and bugf
219217
syslog-ng is available as a Fedora package that you can install using
220218
dnf:
221219

222-
# dnf install syslog-ng
220+
#### dnf install syslog-ng
223221

224222
You can download packages for the latest versions from [here](https://copr.fedoraproject.org/coprs/czanik/).
225223

@@ -229,7 +227,7 @@ If you wish to install the latest RPM package that comes from a recent commit in
229227

230228
### macOS
231229

232-
```
230+
``` shell
233231
# brew install syslog-ng
234232
```
235233

@@ -244,25 +242,12 @@ official [third party page][3rd-party].
244242

245243
Binaries are also available as a Docker image. To find out more, check out the blog post, [Your central log server in Docker](https://syslog-ng.com/blog/central-log-server-docker/).
246244

247-
There are alternatives to the upstream provided, bare syslog-ng image, such
248-
as the [AxoSyslog image](https://github.com/axoflow/axosyslog-docker/pkgs/container/axosyslog)
249-
for running syslog-ng in Kubernetes.
250-
251-
* [AxoSyslog, a cloud native distribution for syslog-ng announcement](https://axoflow.com/cloud-ready-syslog-ng-images/)
252-
* [AxoSyslog log collection for Kubernetes](https://axoflow.com/axosyslog-log-collection-for-kubernetes/)
253-
* [AxoSyslog Documentation](https://axoflow.com/docs/axosyslog/)
254-
* [GitHub](https://github.com/axoflow/axosyslog-docker)
255-
256245
## Documentation
257246

258-
For the latest, markdown based version, see the [syslog-ng documentation](https://syslog-ng.github.io) center.
247+
For the latest, markdown based version, see the [syslog-ng documentation](https://syslog-ng.github.io) center. \
259248
The official documentation of the earlier versions of syslog-ng Open Source Edition provided by One Identity is available
260249
[here](https://www.syslog-ng.com/technical-documents/doc/syslog-ng-open-source-edition/).
261250

262-
An alternative, markdown based, improved, community maintained version of the
263-
documentation is available [as AxoSyslog Core documentation](https://axoflow.com/docs/axosyslog-core/).
264-
[Source code](https://github.com/axoflow/axosyslog-core-docs/)
265-
266251
## Contributing
267252

268253
If you would like to contribute to syslog-ng, to fix a bug or create a new module, the [syslog-ng pages](https://syslog-ng.github.io/dev-guide/README) helps you take the first steps to working with the code base.

0 commit comments

Comments
 (0)