instream
An Elixir driver for InfluxDB supporting both v1.x and v2.x versions with Flux and InfluxQL query capabilities.
What is instream?
Instream is an Elixir driver for InfluxDB that enables Elixir applications to interact with InfluxDB time-series databases. It provides a clean API for executing queries, writing data, and managing connections, supporting both InfluxDB v1.x and v2.x versions. The driver handles authentication, series definitions, and batch operations, simplifying time-series data management in Elixir projects.
Elixir developers building applications that require time-series data storage, monitoring, or analytics using InfluxDB. It's particularly useful for teams integrating InfluxDB into Elixir-based systems, IoT platforms, or real-time monitoring tools.
Developers choose Instream for its comprehensive InfluxDB version support, idiomatic Elixir design, and flexibility in query languages (Flux and InfluxQL). Its integration with Elixir's supervision trees and configurable connection management makes it a reliable and maintainable choice for production environments.
Overview
InfluxDB driver for Elixir
Use Cases
Best For
- Building Elixir applications that store and query time-series data in InfluxDB
- Migrating between InfluxDB v1.x and v2.x within Elixir codebases
- Executing Flux queries from Elixir for InfluxDB 2.x analytics
- Writing batched sensor or monitoring data to InfluxDB efficiently
- Structuring time-series data with predefined measurement schemas
- Integrating InfluxDB into Elixir supervision trees for robust connection handling
Not Ideal For
- Projects using Erlang or other BEAM languages without Elixir adoption
- Teams needing out-of-the-box support for InfluxDB administrative tasks like database creation or user management
- Applications that prioritize a configuration-free, drop-in driver for simple time-series logging
Pros & Cons
Pros
Tested on InfluxDB versions from 1.7.11 through 2.7.6 and Cloud, ensuring compatibility across major releases as listed in the README.
Supports both Flux for InfluxDB 2.x and InfluxQL for 1.x, allowing flexible query execution without driver switching, as shown in usage examples.
Enables pre-defining measurement schemas with tags and fields using series modules, promoting consistent data writing and reducing errors.
Connection modules integrate into Elixir supervision trees for robust connection management and fault tolerance, detailed in the connection setup section.
Cons
Requires editing mix.exs, defining connection modules, and managing numerous environment variables for testing, making setup cumbersome for quick projects.
Does not provide built-in functions for InfluxDB administrative tasks like creating databases or managing retention policies, limiting it to data operations.
Only guarantees compatibility with specific InfluxDB versions listed in the README, potentially causing issues with newer or custom deployments outside this range.
Frequently Asked Questions
Related Projects
wobserverWeb based metrics, monitoring, and observer
telemetryDynamic dispatching library for metrics and instrumentations.
node-influx📈 The InfluxDB Client for Node.js and Browsers
elixometerA light Elixir wrapper around exometer.
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.