fluent/logger

a logging library for Fluentd

v1.0.1 2017-02-15 07:14 UTC

README

fluent-logger-php is a PHP library to record events to fluentd from a PHP application.

Build Status

Requirements

  • PHP 5.6 or higher
  • fluentd v0.9.20 or higher

Installation

Using Composer

composer.json

{
    "require": {
        "fluent/logger": "v1.0.0"
    }
}

Backward Compatibility Changes

As of v1, all loggers but FluentLogger are removed.

Monolog is recommended in such use cases.

Usage

PHP side

<?php

require_once __DIR__.'/vendor/autoload.php';

use Fluent\Logger\FluentLogger;
$logger = new FluentLogger("localhost","24224");
$logger->post("debug.test",array("hello"=>"world"));

Fluentd side

Use in_forward.

<source>
  @type forward
</source>

Todos

  • Stabilize method signatures.
  • Improve performance and reliability.

Restrictions

  • Buffering and re-send support

PHP does not have threads. So, I strongaly recommend you use fluentd as a local fluent proxy.

apache2(mod_php)
fluent-logger-php
                 `-----proxy-fluentd
                                    `------aggregator fluentd

License

Apache License, Version 2.0

Contributors

  • Daniele Alessandri
  • Hiro Yoshikawa
  • Kazuki Ohta
  • Shuhei Tanuma
  • Sotaro KARASAWA
  • edy
  • kiyoto
  • sasezaki
  • satokoma
  • DQNEO