NAME

Mojo::InfluxDB - Super simple InfluxDB async cappable client with a nice interface

VERSION

version 0.1

SYNOPSIS

    use Mojo::InfluxDB;

    my $client = Mojo::InfluxDB->new( database => 'telegraf' );

    my $result = $client->query('
        SELECT last(state) AS state
        FROM telegraf.thirty_days.mongodb
        WHERE time > now() - 5h
        GROUP BY time(1h), host
    ');

    $result->first->points;

DESCRIPTION

We needed to do some async queries on our company InfluxDB instance and with some time this module has been growing. As it's useful for Us, it might also be useful for others so here I am releasing it.

This is not yet a full implementation of an InfluxDB driver. I will be very happy to accept contributions and to modify anything about this group of classes, so be warned that this is "beta" quality and the interface will change if it's needed to implement new features or if me or someone else found a nicer way.

ATTRIBUTES

host

Host of your InfluxDB instance: 'localhost' by default.

port

Port of your InfluxDB instance: 8086 by default.

database

The name of the database you want this client to send the queries. You can change it at any time.

time_zone

An optional time_zone to be passed into results which will finally allow InfluxDB::Point to build DateTime objects on your requested time_zone.

METHODS

query

will run queries synchronously. See query_p().

query_p

will run queries asynchronously and return a promise to get a Mojo::Collection of Mojo::InfluxDB::Result objects.

raw_query_p

will run a query and return a Mojo::Transaction::HTTP.

BUGS

As in any piece of software there might be bugs around. If you found one, please report it at the github repo:

https://github.com/gonzalo-radio/mojo-influxdb

Pull requests to fix bugs or add functionality are very welcomed, but please include an explanation of what you want to achieve.

TODO

SEE ALSO

AUTHOR

Gonzalo Radio <gonzalo@gnzl.net>

COPYRIGHT AND LICENSE

This software is copyright (c) 2020 by Gonzalo Radio.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.