cron-eu/flow-syslog

Implements a Flow LogBackend for the local syslog daemon

Installs: 4 977

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 5

Forks: 0

Open Issues: 1

Type:neos-package

v1.0 2018-03-01 18:06 UTC

This package is auto-updated.

Last update: 2024-06-25 01:54:31 UTC


README

Flow Syslog Backend

Abstract

This Flow package allows you to use the local syslog daemon for logging and is a replacement for the TYPO3\Flow\Log\Backend\FileBackend.

This is especially useful while integrating external services for log-management, like e.g. Papertrail, which are using the syslog protocol for (securely) access.

Install

composer require cron-eu/flow-syslog:dev-master --update-no-dev

Setup

Configure the Backend for the e.g. systemLogger and securityLogger:

TYPO3:
  Flow:
    log:
      systemLogger:
        backend: CRON\Flow\Log\Backend\SyslogBackend
        backendOptions:
          # identifies the application
          name: 'my-awesome-flow-app'
          # log all 
          severityThreshold: '%LOG_DEBUG%'
          # syslog facility code, default is LOG_LOCAL1
          facility: '%LOG_LOCAL3%'
      securityLogger:
        backend: CRON\Flow\Log\Backend\SyslogBackend
        backendOptions:
          # identifies the application
          name: 'my-awesome-flow-app'
          severityThreshold: '%LOG_DEBUG%'
          facility: '%LOG_LOCAL3%'

Syslog Severity Levels

Value Code Description
0 LOG_EMERG system is unusable
1 LOG_ALERT action must be taken immediately
2 LOG_CRIT critical conditions
3 LOG_ERR error conditions
4 LOG_WARNING warning conditions
5 LOG_NOTICE normal, but significant, condition
6 LOG_INFO informational message
7 LOG_DEBUG debug-level message

I do recommend to disable the severityThreshold, setting it to LOG_DEBUG and setup syslog for the filtering/routing.

References

License

MIT