External Logger

External Logger

TamTam External Logger module for Drupal is a module that utilizes hook_watchdog() to catch all log events on a Drupal based site. And send the events to a compatible backend. The module is designed to center log messages of multiple environments and sites in a single location. All environments can be grouped to form a practical overview. Saving the developer the time of looking up multiple logs and/or multiple machines.

Required Modules:

Composer Manager

Required libraries:

GELF-PHP

Optional Modules:

kw_environment

Supported Transports:

1. GELF-PHP
   1. HTTP(S)
   2. UDP
2. Open for suggestions..

Installation

Components to be installed/setup for the module to run properly.

Drush installation

• Run "drush en external_logger -y"
• (Composer Manager should install the composer dependencies)
• Go to: /admin/config/system/external_logger and configure your server settings
• (Optional) Run "drush external_logger test-message" to check dependencies

Settings

The settings and fields which the module utilizes.

Module Settings: /admin/config/system/external_logger

environment => (Global) The environment you're currently running. E.g: Production, Development, Acceptance, etc...
External Logger Transport Name => Name of the transport.
IP => The IP/DNS of the external server.
Transport Type => The type of transport.
Port => The port of the external server.
Basic Auth Username => The Basic Auth Username.
Basic Auth Password => The Basic Auth password.
Use SSL => Checkbox use SSL or not? (checked = yes)
Check self signed => Check self signed certificate yes/no?
Verify peer => Verify the peer yes/no?

Fields send:

facility => The facility providing the external server messages (in this case: tamtam-external-logger)
host => <Host>|<IP> The host and IP in the following format.
short Message => A short human readable message explaining the event.
timestamp => Timestamp of when the event occurred.
level => The level of severity of the event (integer).
severity_label => A human readable representation of the severity level.
type => The type (origin) of the error.
user => <ID>,<Username>,<E-mail> The user which triggered the log entry.
request_uri => The request URI for the page the event happened in.
referrer => The page that referred the user to the page where the event occurred.
request_ip => The IP address where the request for the page came from.
environment => The environment string the site is currently running on.

Development & Contributing

11-04-2016: Scheduled to be PROMOTED TO OFFICIAL MODULE 18-04-2016

03-11-2015: Remove Libraries dependency

Feel free to open issues leave behind requests and what not. This module is part of my learning/consistency process within the Drupal community. Contribution/feature requests are open and appreciated.

Be sure to include the sources, elaboration for me to learn from your changes.