logstash

README

Logstash monitoring with Netdata

Logstash is an open-source data processing pipeline that allows you to collect, process, and load data into Elasticsearch.

This module will monitor one or more Logstash instances, depending on your configuration.

Metrics

All metrics have "logstash." prefix.

Metric	Scope	Dimensions	Units
jvm_threads	global	threads	count
jvm_mem_heap_used	global	in_use	percentage
jvm_mem_heap	global	committed, used	KiB
jvm_mem_pools_eden	global	committed, used	KiB
jvm_mem_pools_survivor	global	committed, used	KiB
jvm_mem_pools_old	global	committed, used	KiB
jvm_gc_collector_count	global	eden, old	counts/s
jvm_gc_collector_time	global	eden, old	ms
open_file_descriptors	global	open	fd
event	global	in, filtered, out	events/s
event_duration	global	event, queue	seconds
uptime	global	uptime	seconds
pipeline_event	piepeline	in, filtered, out	events/s
pipeline_event	piepeline	event, queue	seconds

Configuration

Edit the go.d/logstash.conf configuration file using edit-config from the Netdata config directory, which is typically at /etc/netdata.

cd /etc/netdata # Replace this path with your Netdata config directory
sudo ./edit-config go.d/logstash.conf

Here is a simple example for local and remote server:

jobs:
  - name: local
    url: http://localhost:9600

  - name: remote
    url: http://203.0.113.10:9600

For all available options please see module configuration file.

Troubleshooting

To troubleshoot issues with the logstash collector, run the go.d.plugin with the debug option enabled. The output should give you clues as to why the collector isn't working.

• Navigate to the plugins.d directory, usually at /usr/libexec/netdata/plugins.d/. If that's not the case on your system, open netdata.conf and look for the plugins setting under [directories].

  cd /usr/libexec/netdata/plugins.d/
  

• Switch to the netdata user.

  sudo -u netdata -s
  

• Run the go.d.plugin to debug the collector:

  ./go.d.plugin -d -m logstash
  

Documentation

Index

• type Charts
• type Config
• type Dims
• type Logstash
  • func New() *Logstash
  • func (l *Logstash) Charts() *Charts
  • func (l *Logstash) Check() bool
  • func (Logstash) Cleanup()
  • func (l *Logstash) Collect() map[string]int64
  • func (l *Logstash) Init() bool

Types

type Charts

type Charts = module.Charts

Charts is an alias for module.Charts

type Config

type Config struct {
	web.HTTP `yaml:",inline"`
}

Config is the Logstash module configuration.

type Dims

type Dims = module.Dims

Dims is an alias for module.Dims

type Logstash

type Logstash struct {
	module.Base
	Config `yaml:",inline"`
	// contains filtered or unexported fields
}

func New

func New() *Logstash

New creates Logstash with default values.

func (*Logstash) Charts

func (l *Logstash) Charts() *Charts

Charts creates Charts.

func (*Logstash) Check

func (l *Logstash) Check() bool

Check makes check.

func (Logstash) Cleanup

func (Logstash) Cleanup()

Cleanup makes cleanup.

func (*Logstash) Collect

func (l *Logstash) Collect() map[string]int64

Collect collects metrics.

func (*Logstash) Init

func (l *Logstash) Init() bool

Init makes initialization.