shazam/php-statsd

This package is abandoned and no longer maintained. No replacement package was suggested.

Sends stats to Statsd.

Maintainers

Details

github.com/shazam/php-statsd

Source

Issues

Installs: 2 850

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 1

Open Issues: 0

3.0.1 2015-04-22 10:13 UTC

Apache-2.0 445c9964932090a84ec4e2d26d6f9d2fecf8629f

  • Toni Lopez <toni.lopez.woop@shazam.com>

statsd

This package is not auto-updated.

Last update: 2023-04-19 20:51:28 UTC

README

Simple PHP library to send stats to statsd.

Installation

Add the dependency to your composer.json.

{
    "require": {
        "shazam/php-statsd": "2.*"
    }
}

Usage

An example of how to send metrics of how long it takes to load a page.

<?php

use Statsd;

// $config = array(...);
// $path = ...

// initialize client
$configuration = new Statsd\Client\Configuration();
$configuration->setHost($config['host'])
    ->setNamespace($config['namespace']);

$statsClient = new Statsd\Client($configuration);

// add stats (you can also add an array of stats with addStats())
$statsClient->addStat(
    array(
        'namespace' => 'endpoints.' . $path, // that will be your stat namespace
        'value' => $executionTime, // calculate it in microseconds
        'type' => 'ms'
    )
);

// send them
$statsClient->sendStats();

You can use TIME_MS, COUNT, GAUGE or SET (ms, c, g, s) as type of stats.

Configuration

  • A host to push metrics (use 127.0.0.1 if you have netpipes installed in your box).
  • A port (by default, 8126).
  • A namespace (where all your metrics will be added. Use "." to separate folders.
  • Optionally, a Monolog\Logger object, to log the metrics.

An example of a config file for that client could be:

stats:
  enable: true
  client:
    host: 127.0.0.1
    namespace: shazam.twitterhose