tray-labs/laravel-influxdb

A service made to provide, set up and use the library from influxdata influxphp in Laravel.

Laravel Influxdb

A service made to provide, set up and use the library from influxdata influxdb-php in Laravel., _(*1)

Installing

• Install by composer command:

composer require tray-labs/laravel-influxdb

• Or add this line to require section of composer.json and execute on your terminal $ composer install

"require": {
    "tray-labs/laravel-influxdb": "^1.0"
}

Register service provider(pick one of two).

• Laravel: in config/app.php file, Laravel 5.5+ supports package discovery automatically, you should skip this step php 'providers' => [ // ... TrayLabs\InfluxDB\Providers\ServiceProvider::class, ] php 'aliases' => [ // ... 'InfluxDB' => TrayLabs\InfluxDB\Facades\InfluxDB::class, ]

• Lumen: in bootstrap/app.php file, _(*2)

  // config
  $app->configure('InfluxDB');
  
  $app->register(TrayLabs\InfluxDB\Providers\LumenServiceProvider::class);
  $app->alias('InfluxDB', TrayLabs\InfluxDB\Facades\InfluxDB::class);
  

• Define env variables to connect to InfluxDB, _(*3)

INFLUXDB_HOST=localhost
INFLUXDB_PORT=8086
INFLUXDB_USER=some_user
INFLUXDB_PASSWORD=some_password
INFLUXDB_SSL=false
INFLUXDB_VERIFYSSL=false
INFLUXDB_TIMEOUT=0
INFLUXDB_DBNAME=some_database
INFLUXDB_UDP_ENABLED=false # Activate UDP
INFLUXDB_UDP_PORT=4444 # Port for UDP

• Write this into your terminal inside your project
  • Laravel ini php artisan vendor:publish
  • Lumen ini cp vendor/TrayLabs/lumen-influxdb/config/InfluxDB.php config/InfluxDB.php

Reading Data

<?php

// executing a query will yield a resultset object
$result = InfluxDB::query('select * from test_metric LIMIT 5');

// get the points from the resultset yields an array
$points = $result->getPoints();

Writing Data

<?php

// create an array of points
$points = array(
    new InfluxDB\Point(
        'test_metric', // name of the measurement
        null, // the measurement value
        ['host' => 'server01', 'region' => 'us-west'], // optional tags
        ['cpucount' => 10], // optional additional fields
        time() // Time precision has to be set to seconds!
    ),
    new InfluxDB\Point(
        'test_metric', // name of the measurement
        null, // the measurement value
        ['host' => 'server01', 'region' => 'us-west'], // optional tags
        ['cpucount' => 10], // optional additional fields
        time() // Time precision has to be set to seconds!
    )
);

$result = InfluxDB::writePoints($points, \InfluxDB\Database::PRECISION_SECONDS);

License

This project is licensed under the MIT License, _(*4)