# cnBolt-Extensions-RemoteLog

This extension catches log events from the system log and relays it to a configurable type of remote logging server using the sentry or gelf protocols.
The **FilteredHandler** handler in this extension extends the normal **MonologHandler** and adds the ability to filter
events before relaying them.

You need to also install the Sentry or Gelf bundles (into bolt, not extensions) before using this extension.
```
composer require sentry/sentry
```
```
composer require graylog2/gelf-php
```

## Installation

1.) Edit your extensions/composer.json file and add the **cnd-remotelog** repository:
```
    "repositories": {
        "packagist": false,
        "bolt": {
            "type": "composer",
            "url": "https://extensions.bolt.cm/satis/"
        },
        "cnd-remotelog": {
            "type": "vcs",
            "no-api": true,
            "url": "https://github.com/CondeNastDigital/cnBolt-Extensions-RemoteLog.git"
        }
    },
```
2.) Change to the extensions folder and install via composer.
```
composer require cnd/remotelog
```
Installing or updating via the Bolt admin interface is also possible but would require the web-server's user to have proper access to the GitHup repository. This is usually not the case.

## Configuration
The extension is configured inside the **app/config/extensions/remotelog.cnd.yml**. The file contains instructions on the needed values.