Download the PHP package sallyx/rabbitmq-logger without Composer

Rabbitmq Logger

Log error and exceptions int rabbitmq exchange.

Rabbitmq Logger provides two extensions for Nette Framework.

• RabbitMqLoggerExtension for logging errors/exceptions into rabbitmq exange. You should use this extension on all projects where you want to log error messages to rabbitmq.
• ConsumerExtension for getting messages from queue and optionally save them into database using doctrine 2. It also provide grid to show the saved messages. You should use this extension with an internal application to manage saved messages.

Installation

Requirements

sallyx/rabbitmq-logger requires PHP 5.4 or higher.

• Nette
• Kdyby/RabbitMq
• php-amqplib

Suggests

If you want to use ConsumerExtension to save logs into database:

• Kdyby/Doctrine
• Kdyby/Console

If you want to use ConsumerExtension to provide Grid to show saved messages:

• ublaboo/datagrid

Installation

The best way to install sallyx/rabbitmq-logger is using Composer:

Configuration

First you need to configure Kdyby/RabbitMq. A least the connection:

If you want to use RabbitMqLoggerExtension to log error messages, add and configure it like this:

This is the default configuration for RabbitMqLoggerExtension:

If you use direct exchange, the routing key is in form priority, where priority is error or exception. If you use topic exchange, the routing key is in form priority.guid

If you want to use ConsumerExtension, you have to add Kdyby/Console and/or Kdyby/Doctrine extensions and configure it (please have a look at the documentation for this extensions):

This is the default configuration for ConsumerExtension:

If you want to get an easy acces to your logged exceptions, you can add this to RabbitMqLoggerExtension configuration:

This create route in your web application, which provides access to your error messages saved in log in form http://example.org/get-tracy-exception-file?secret=xxx&file=name_of_the_file

To use this in the grid, add this to ConsumerExtension configuration:

Setup

You have to create exchange for RabbitMqLoggerExtension and queue for ConsumerExtension. If you want to use ConsumerExtension to save messages to database, you also have to create the schema and table.

If you have installed Kdyby/Console, you can use rabbitmq:setup-fabric command from Kdyby/RabbitMq extension to setup exchange and queue:

To create the database table, you can use structure-psql.sql for Postgresql and structure-mysql.sql for Mysql/MariaDB.

Using RabbitMqLoggerExtension

No futher action needed. Your project should log messages into rabbitmq exhange as configured.

Using ConsumerExtension

Using Console

If you installed Kdyby/Console extension, you can use this commands:

• rabbitmqLoggerConsumer:queue to add or delete other queues to exchange.
• rabbitmqLoggerConsumer:list to list and remove messages from queue.
• rabbitmqLoggerConsumer:save to list, save messages to database and remove from queue (Kdyby/Doctine extension needed).

While rabbitmqLoggerConsumer:save takes messages from queue described in configuration, rabbitmqLoggerConsumer:list require queue name as argument to avoid accidentally removing message from queue. You can use rabbitmqLoggerConsumer:queue to create new queue.

Using Grid

In a presenter:

In latte:

You need to add assets as described on https://ublaboo.org/datagrid/ page.

Result: