Download the PHP package bloatless/pile without Composer
On this page you can find all versions of the php package bloatless/pile. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download bloatless/pile
More information about bloatless/pile
Files in bloatless/pile
Package pile
Short Description Dead simple centralized logging.
License MIT
Homepage https://bloatless.org
Informations about the package pile
Pile
Dead simple centralized logging.
Installation
To install Pile just clone this repository to your server:
- Point your virtual host document root to the
publicdirectory and rewrite ald requests to theindex.phpfile. - Create a new MySQL database and import the structure using the
db_stucture.sqlfile. - Copy
config/config.sample.phptoconfig/config.phpand adjust database configuration, api-keys and user-account settings.
Documentation
Log message structure
The general structure of a log message to be send to the Pile API should be as follows:
| key | type | description |
|---|---|---|
| source¹ | string | An identifier describing the source of the log message. (e.g. the project name) |
| message¹ | string | The actual log message. |
| level¹ | int | A valid log level code. (See listing below) |
| context | array | Arbitrary data passed together with the log message. |
| channel | string | The channel this message was logged to. |
| datetime | string | Date and time when the message was logged. (Format: YYYY-MM-DD HH:ii:ss) |
| extra | array | Additional data added by the processor. |
¹ = field is required
Log levels
Valid log level codes are:
| code | level name |
|---|---|
| 100 | debug |
| 200 | info |
| 250 | notice |
| 300 | warning |
| 400 | error |
| 500 | critical |
| 550 | alert |
| 600 | emergency |
Sending logs to your Pile instance
Using HTTP REST API
Log messages can be sent to your Pile instance using a simple post request:
Be sure to include an API key within the request header.
Using Monolog Handler
If you are using Monolog in your project you can also use the MonoPile package which provides a handler and formatter for Monolog to easily send error-logs to your Pile instance.
Cleanup
Old log entries can be regularly deleted using the cleanup script:
php cli/cleanup.php
This will delete old log entries from the database. The "lifetime" of log entries can be configured within the config/config.php file.
It is recommended to regularly call the cleanup script using a cronjob.
License
MIT
All versions of pile with dependencies
ext-json Version *
ext-mbstring Version *
bloatless/endocore Version v0.5.0.x-dev