Skip to content

Latest commit

 

History

History
154 lines (105 loc) · 5.84 KB

logs-to-sematext.md

File metadata and controls

154 lines (105 loc) · 5.84 KB

Send Syslog Data to Sematext

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

The following software/services are required to be set up correctly:

You can install Fluentd via major packaging systems.

Set Up Sematext

You need to sign up and create an App. Read more in the docs here.

Install Elasticsearch Plugin

If out_elasticsearch (fluent-plugin-elasticsearch) is not installed yet, please install it manually.

See Plugin Management section how to install fluent-plugin-elasticsearch on your environment.

Now you'll configure the fluent-package (Fluentd) to interface properly with Elasticsearch. Please edit /etc/fluent/fluentd.conf as shown below:

# Switch to debug if you need to debug
<system>
  log_level debug
</system>

# get logs from syslog
<source>
  @type syslog
  port 42185
  tag syslog
</source>

# get logs from fluent-logger, fluent-cat or other Fluentd instances
<source>
  @type forward
</source>

<match syslog.**>
  @type elasticsearch
  host logsene-receiver.sematext.com
  # for EU
  # host logsene-receiver.eu.sematext.com
  port 443
  scheme https
  index_name <LOGS_TOKEN>
  <buffer>
    @type file
    path /tmp/fluent/es-buffer/es.all.*.buffer
    chunk_limit_size 250k
    flush_interval 50s
    flush_thread_count 1
    retry_limit 5
    retry_wait 60
  </buffer>
</match>

Once everything has been set up and configured, start fluentd:

$ sudo systemctl start fluentd

Set Up rsyslogd

Finally, configure forwarding logs from your rsyslogd to Fluentd. Create /etc/rsyslog.d/90-fluentd.conf, and restart rsyslog. This will forward your local syslog to Fluentd, and Fluentd will forward the logs to Sematext:

*.* @127.0.0.1:42185

Please restart the rsyslog service once the modification is complete:

$ sudo systemctl restart rsyslog

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 Sematext 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:

$ logger -t test foobar

When debugging your fluent-package configuration, using filter_stdout will be useful. All the logs including errors can be found at /etc/fluent/fluentd.log.

<filter **>
  @type stdout
</filter>

<match **>
  @type elasticsearch
  host logsene-receiver.sematext.com
  # for EU
  # host logsene-receiver.eu.sematext.com
  port 443
  scheme https
  index_name <LOGS_TOKEN>
  <buffer>
    flush_interval 5s # for testing
  </buffer>
</match>

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

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.