Send Syslog Data to Sematext

Search…
​Sematext is a tool for managing logs, and considered an alternative to Splunk, but with cheaper and more flexible pricing. In this article, we present an alternative to Splunk by combining Fluentd with the Sematext open Elasticsearch API.
Sematext Dashboard
​Elasticsearch is an open source search engine known for its ease of use. Sematext runs and manages Elasticsearch in the cloud. You also have the option to use Kibana alongside the dashboards in the Sematext UI.
By combining Fluentd and Sematext's managed Elasticsearch + Kibana you get a scalable, flexible, easy to use log management tool and search engine with an intuitive native web UI. You also get Kibana, if you want to use it. This provides a managed Splunk alternative, for a fraction of the cost.
In this guide, we'll cover the installation, setup, and basic use of this log management solution. This setup was tested on Ubuntu 18.04. If you're not familiar with Fluentd, please learn more about Fluentd first.
Prerequisites
Set Up Sematext
You need to sign up and create an App. Read more in the docs here.
Set Up Fluentd (td-agent)
In this guide you'll install td-agent, the stable release of Fluentd. Please refer to the guides below for detailed installation steps:
​Debian Package​
​RPM Package​
​Ruby gem​
Next, install the Elasticsearch plugin for Fluentd fluent-plugin-elasticsearch:
1
$ sudo /usr/sbin/td-agent-gem install fluent-plugin-elasticsearch --no-document
Copied!
Now you'll configure the td-agent (Fluentd) to interface properly with Elasticsearch. Please edit /etc/td-agent/td-agent.conf as shown below:
1
# Switch to debug if you need to debug
2
<system>
3
  log_level debug
4
</system>
5
​
6
# get logs from syslog
7
<source>
8
  @type syslog
9
  port 42185
10
  tag syslog
11
</source>
12
​
13
# get logs from fluent-logger, fluent-cat or other Fluentd instances
14
<source>
15
  @type forward
16
</source>
17
​
18
<filter **>
19
  @type stdout
20
</filter>
21
​
22
<match syslog.**>
23
  @type elasticsearch
24
  host logsene-receiver.sematext.com
25
  # for EU
26
  # host logsene-receiver.eu.sematext.com
27
  port 443
28
  scheme https
29
  index_name <LOGS_TOKEN>
30
  <buffer>
31
    @type file
32
    path /tmp/fluent/es-buffer/es.all.*.buffer
33
    chunk_limit_size 250k
34
    flush_interval 50s
35
    flush_thread_count 1
36
    retry_limit 5
37
    retry_wait 60
38
  </buffer>
39
</match>
Copied!
Once everything has been set up and configured, start td-agent:
1
# init
2
$ sudo /etc/init.d/td-agent start
3
​
4
# or systemd
5
$ sudo systemctl start td-agent.service
Copied!
Set Up rsyslogd
Finally, configure forwarding logs from your rsyslogd to Fluentd. Please add the following line to your /etc/rsyslog.conf, and restart rsyslog. This will forward your local syslog to Fluentd, and Fluentd will forward the logs to Sematext:
1
*.* @127.0.0.1:42185
Copied!
Please restart the rsyslog service once the modification is complete:
1
$ sudo /etc/init.d/rsyslog restart
Copied!
Store and Search Logs
Once Fluentd receives logs from rsyslog and ships them to Sematext, you can view, search and visualize the log data using prebuilt Dashboards, by creating custom Dashboards, or with Kibana.
First of all, open up the Seamtext UI and access your App. You'll see prebuilt dashboards with full-text search, filters, and alerts out-of-the-box.
Sematext: Configure Logs
Sematext will automatically figure out hosts, idents, pids, timestamps, and the origin of the logs. In this case the origin is Fluentd.
After you start receiving logs, you can create custom charts, reports, and alerts to fine-tune your own personal use-case.
If you are used to Kibana, you can still use it as well. For more details, read Kibana's official manual.
Sematext: Logs Overview
Debugging
To manually send logs to Sematext, please use the logger command:
1
$ logger -t test foobar
Copied!
When debugging your td-agent configuration, using filter_stdout will be useful. All the logs including errors can be found at /etc/td-agent/td-agent.log.
1
<filter **>
2
  @type stdout
3
</filter>
4
​
5
<match **>
6
  @type elasticsearch
7
  host logsene-receiver.sematext.com
8
  # for EU
9
  # host logsene-receiver.eu.sematext.com
10
  port 443
11
  scheme https
12
  index_name <LOGS_TOKEN>
13
  <buffer>
14
    flush_interval 5s # for testing
15
  </buffer>
16
</match>
Copied!
Conclusion
This how-to guide introduced an alternative SaaS tool to use instead of Splunk. The combination of Fluentd and Sematext, with an open Elasticsearch API and Kibana, gives you tooling you are used to, with the added benefit of not having to manage an Elasticsearch cluster.
You'll get access to storing and searching logs from infrastructure, apps, and software. The example provided in this article has been tested for the current production environments of Sematext.
Learn More
​Fluentd Architecture​
​Fluentd Get Started​
​Downloading Fluentd​
​Set up Fluentd with Sematext​
If this article is incorrect or outdated, or omits critical information, please let us know. Fluentd is an open-source project under Cloud Native Computing Foundation (CNCF). All components are available under the Apache 2 License.