A structured logger for Fluentd (PHP)
Clone or download
Latest commit fb8e4e6 Apr 3, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples remove Autoloader.php Oct 8, 2015
src Add unregisterErrorHandler() method Feb 6, 2017
tests add test Feb 7, 2017
.gitignore remove entries for Vagrant and Chef Apr 21, 2015
.travis.yml Merge branch 'master' into DQNEO-patch-1 Apr 3, 2018
LICENSE add author Oct 16, 2015
README.md Update README.md Apr 14, 2016
composer.json improve description Oct 16, 2015
phpunit.xml.dist set Test Execution Timeout Sep 24, 2015

README.md

Fluent Logger PHP

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

Build Status

Requirements

  • PHP 5.3 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