Ruby
Official Ruby client library for InfluxDB 1.x, providing data writing, querying, and administrative capabilities.
What is Ruby?
influxdb-ruby is the official Ruby client library for InfluxDB 1.x, designed to integrate Ruby applications with the InfluxDB time-series database. It provides methods for writing time-series data, executing queries, and performing administrative tasks like managing databases and users. The library solves the problem of programmatically interacting with InfluxDB from Ruby code, offering a clean and efficient API.
Ruby developers building applications that require time-series data storage and analysis, such as monitoring systems, IoT platforms, or analytics dashboards. It's also suitable for DevOps engineers managing InfluxDB instances through automation scripts.
Developers choose influxdb-ruby because it's the officially maintained client for InfluxDB 1.x, ensuring compatibility and reliability. It offers a comprehensive feature set, including batch writes, async operations, and administrative functions, with a Ruby-friendly API that reduces boilerplate code.
Overview
Ruby client for InfluxDB
Use Cases
Best For
- Writing time-series data from Ruby applications to InfluxDB
- Building monitoring dashboards with Ruby backends
- Automating InfluxDB database and user management
- Ingesting IoT sensor data using Ruby scripts
- Querying InfluxDB with parameterized InfluxQL statements
- Handling large query results with streaming responses
Not Ideal For
- Projects using InfluxDB 2.x or the Flux query language
- Applications requiring UDP writes with retention policies (not supported per README)
- Teams needing nanosecond precision without meticulous timestamp handling (due to default second precision and duplicate point risks)
- Environments with legacy Ruby versions below 2.3.0 (officially unsupported)
Pros & Cons
Pros
Maintained by InfluxData with regular updates and support for Ruby >= 2.3.0, ensuring reliability and compatibility with InfluxDB 1.x.
Supports data writing (single/batch, async), querying with parameterization, administrative tasks, and connection management with load balancing and retry logic, covering most InfluxDB 1.x needs.
Offers denormalized query results by default, parameterized queries, and clean methods for common operations, reducing boilerplate code and improving developer experience.
Extensive customization for time precision, SSL, proxies, async writing with configurable queues, and UDP support, allowing fine-grained control over client behavior.
Cons
Does not support InfluxDB 2.x or the Flux query language, forcing users to migrate to influxdb-client-ruby for newer versions, as stated in the README note.
Default second precision and complex timestamp handling can lead to duplicate points if not configured correctly, requiring careful attention to avoid data corruption, as warned in the README.
Asynchronous writing requires detailed configuration of max_post_points, queue size, and worker threads, which can be overwhelming and error-prone for simple use cases.
Frequently Asked Questions
Related Projects
JavaJava client for InfluxDB
PHPinfluxdb-php: A PHP Client for InfluxDB, a time series database
C#A .NET library for efficiently sending points to InfluxDB 1.x
GoThe old clientv2 for InfluxDB 1.x
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.