---
name: "logster"
section: "1"
platform: "linux"
package: "logster"
version: "0.0.1-2"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/logster"
---

# logster(1)

generate metrics from logfiles

## NAME

logster - generate metrics from logfiles

## SYNOPSIS

**logster** \[*options*\] *parser logfile*

## DESCRIPTION

Tail a log file and filter each line to generate metrics that can be sent to common monitoring packages.

## OPTIONS

- **-h**, **--help**

  show this help message and exit

- **--logtail**=*LOGTAIL*

  Specify location of logtail.  Default */usr/sbin/logtail2*

- **-p** METRIC\_PREFIX, **--metric-prefix**=*METRIC\_PREFIX*

  Add prefix to all published metrics. This is for people that may multiple instances of same service on same host.

- **-x** METRIC\_SUFFIX, **--metric-suffix**=*METRIC\_SUFFIX*

  Add suffix to all published metrics. This is for people that may add suffix at the end of their metrics.

- **--parser-help**

  Print usage and options for the selected parser

- **--parser-options**=*PARSER\_OPTIONS*

  Options to pass to the logster parser such as "-o VALUE **--option2** VALUE". These are parser-specific and passed directly to the parser.

- **--gmetric-options**=*GMETRIC\_OPTIONS*

  Options to pass to gmetric such as "-d 180 **-c** */etc/ganglia/gmond*.conf" (default). These are passed directly to gmetric.

- **--graphite-host**=*GRAPHITE\_HOST*

  Hostname and port for Graphite collector, e.g. graphite.example.com:2003

- **-s** STATE\_DIR, **--state-dir**=*STATE\_DIR*

  Where to store the logtail state file.  Default location */var/run*

- **-o** OUTPUT, **--output**=*OUTPUT*

  Where to send metrics (can specify multiple times). Choices are 'graphite', 'ganglia', or 'stdout'.

- **-d**, **--dry-run**

  Parse the log file but send stats to standard output.

- **-D**, **--debug**

  Provide more verbose logging for debugging.

## SEE ALSO

**logtail**(1)

## AUTHOR

logster was written by Etsy, Inc.

This manual page was written by Andreas Rütten \<AndreasRuetten@gmx.de\>, for the Debian project (and may be used by others).