Skip to main content

Send syslog messages to Sentry as events

Project description

https://github.com/rpatterson/sentry-syslog/workflows/Run%20linter,%20tests%20and,%20and%20release/badge.svg

The sentry-syslog command-line script sends RFC 5424 IETF Syslog Protocol message to Sentry as events as follows:

  1. Initializes Sentry’s Python logging integration

  2. Accepts one message per-line

  3. Converts each message into a Python logging message

  4. Logs the Python message to be handled by the Sentry’s Python logging integration

Installation

Install using any tool for installing standard Python 3 distributions such as pip:

$ sudo pip3 install sentry-syslog

Usage

See the command-line help for details on options and arguments:

$ sentry-syslog --help
usage: sentry-syslog [-h] [--input-file INPUT_FILE]
                     [--event-level EVENT_LEVEL]
                     sentry_dsn

Send syslog messages to Sentry as events.

positional arguments:
  sentry_dsn            The DSN for your sentry DSN or client key.

optional arguments:
  -h, --help            show this help message and exit
  --input-file INPUT_FILE, -i INPUT_FILE
                        Take the syslog messages from this file, one per-line.
                        (default: stdin)
  --event-level EVENT_LEVEL, -e EVENT_LEVEL
                        Capture log messages of this level and above as Sentry
                        events. All other events are captured as Sentry
                        breadcrumbs. (default: ERROR)

The script expects all the syslog lines it receives to be already filtered down to those that should be captured in Sentry. The level setting only determines which lines are captured as breadcrumbs or events.

The correct invocation can then be used, for example, with Rsyslog’s omprog output module as the binary to selectively forward a system’s syslog messages to Sentry as events. See the example omprog configuration which might be installed as follows (will require adapting to the system):

$ sudo curl https://raw.githubusercontent.com/rpatterson/sentry-syslog/master/src/sentry_syslog/etc/rsyslog.d/99-sentry.conf >/etc/rsyslog.d/99-sentry.conf
$ sudo editor /etc/rsyslog.d/99-sentry.conf
$ sudo systemctl restart rsyslog.service

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sentry-syslog-0.1.5.tar.gz (10.0 kB view details)

Uploaded Source

Built Distribution

sentry_syslog-0.1.5-py3-none-any.whl (9.6 kB view details)

Uploaded Python 3

File details

Details for the file sentry-syslog-0.1.5.tar.gz.

File metadata

  • Download URL: sentry-syslog-0.1.5.tar.gz
  • Upload date:
  • Size: 10.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.3 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.7

File hashes

Hashes for sentry-syslog-0.1.5.tar.gz
Algorithm Hash digest
SHA256 2ccbdff6893405df7daec2f10ded66c31488afa6f6668e1762619ea75cc5a21d
MD5 1a8b90833db8394f2142346b4bf83285
BLAKE2b-256 cf266ce1a7108d6210e221fd0faf3a6515d97ed2cfe9447ac36b435e36378446

See more details on using hashes here.

File details

Details for the file sentry_syslog-0.1.5-py3-none-any.whl.

File metadata

  • Download URL: sentry_syslog-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 9.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.3 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.7

File hashes

Hashes for sentry_syslog-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 34a186650ff932d7fac8c40a35f3be85f7641f5ec23439c74e26ab34b2425969
MD5 5d16d8ed67840381323503f608a6ff4e
BLAKE2b-256 04ad6e32420fd1112958a93032905aa790d81f6d96cc419a0d6cc3cc93599bd4

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page