Introduction to the InfluxData platform
InfluxDB is a database built to collect, process, transform, and store event and time series data, and is ideal for use cases that require real-time ingest and fast query response times to build user interfaces, monitoring, and automation solutions.
What’s my InfluxDB version?
With multiple InfluxDB deployment options available, identifying which one you’re using is important for accessing the correct documentation and features.
Identify your InfluxDB version using:
- Interactive version detector
- URL pattern recognition
- Command-line tools
- HTTP API headers
Or browse the product lineup below to find yours.
InfluxDB 3
InfluxDB 3 is InfluxDB’s next generation that unlocks series limitations present in the Time Structured Merge Tree (TSM) storage engine and allows infinite series cardinality without any impact on overall database performance. It also brings with it native SQL support and improved InfluxQL performance.
Self-hosted
- InfluxDB 3 Core: open source time series database with object storage support and built-in data processing capabilities
- InfluxDB 3 Enterprise: extends Core with clustering, high availability, and advanced security features
- InfluxDB Clustered: a highly available InfluxDB 3 cluster hosted and managed using Kubernetes on your own infrastructure
Hosted
- InfluxDB 3 Cloud: fully managed, single-tenant InfluxDB 3 Enterprise service
- InfluxDB Cloud Serverless: fully managed, multi-tenant InfluxDB 3 instance
- InfluxDB Cloud Dedicated: fully managed, single-tenant InfluxDB 3 cluster
InfluxDB 3 Explorer
InfluxDB 3 Explorer is the standalone web application designed for visualizing, querying, and managing your data stored in InfluxDB 3 Core and Enterprise.
Telegraf
Telegraf is a plugin-driven server agent for collecting and reporting metrics. It supports over 300 input and output plugins, including support for InfluxDB 3.
InfluxDB 2.x
InfluxDB Cloud (TSM) is a managed service based on InfluxDB 2. InfluxDB 1 Cloud is based on InfluxDB 1 Enterprise. Both services use the TSM storage engine.
InfluxDB Cloud (TSM) signup availability
InfluxDB Cloud (TSM) is a legacy managed service. New signups are no longer available. New signups for InfluxDB Cloud (TSM) are directed to InfluxDB Cloud Serverless (powered by InfluxDB 3).
Existing InfluxDB Cloud (TSM) customers should consider migrating to InfluxDB 3. If you are looking to use InfluxDB v2 (TSM), consider self-hosting InfluxDB OSS v2.
The InfluxDB 2 platform consolidates InfluxDB, Chronograf, and Kapacitor from the InfluxData 1.x platform into a single packaged solution, with added features and flexibility:
- InfluxDB OSS 2.x: Open source platform solution in a single binary
- InfluxDB Cloud (TSM): Legacy managed cloud service (new signups unavailable)
- Telegraf: Data collection agent
Integrate InfluxDB 2.0 applications with InfluxDB Enterprise 1.8+
Use InfluxDB 2.0 API compatibility endpoints to integrate applications built on InfluxDB 2.0 or InfluxDB Cloud (TSM) with InfluxDB Enterprise 1.8+:
- Query data in InfluxDB Enterprise using
api/v2/queryand Flux. - Write data to InfluxDB Enterprise using
api/v2/write(compatible with InfluxDB 2.0 client libraries).
InfluxDB 1
InfluxDB 1 is the family of InfluxDB products built on the InfluxDB 1.x engine. InfluxDB 1 is available and actively supported. It uses the TSM storage engine, a database and retention policy data model, and the InfluxQL query language. In the TICK stack, Telegraf collects data, Chronograf provides visualization, and Kapacitor processes data and generates alerts.
InfluxDB 1 OSS, InfluxDB 1 Enterprise, and InfluxDB 1 Cloud were previously labeled InfluxDB OSS v1, InfluxDB Enterprise v1, and InfluxDB Cloud 1.
Products:
- InfluxDB 1 OSS: Open source, self-hosted time series database. Free to download.
- InfluxDB 1 Enterprise: Commercial, self-hosted cluster with high availability and advanced features. Commercial license; contact Sales.
- InfluxDB 1 Cloud: Managed service based on InfluxDB 1 Enterprise and hosted on AWS. Available through Sales.
- Telegraf: Data collection agent
- Chronograf: Visualization and dashboarding
- Kapacitor: Data processing and alerting
When to choose InfluxDB 1
Choose InfluxDB 1 when:
- Your workloads are built on InfluxQL
- You use Kapacitor for alerting and data processing
- You run an established InfluxDB 1 deployment, including a cluster, and don’t need features only available in InfluxDB 3
Evaluate InfluxDB 3 when you need SQL, object storage, or unlimited series cardinality. For a comparison, see Which InfluxDB 3 should I use?.
Query languages
InfluxDB 1 supports InfluxQL. InfluxDB OSS v1.8 and later and InfluxDB Enterprise v1.8 and later also support Flux when enabled. InfluxDB 1 Cloud also supports Flux.
Kapacitor v1.6.0 and later can schedule and run Flux tasks against InfluxDB and other data sources. To enable and use Flux tasks, see Use Flux tasks with Kapacitor.
High availability and FIPS builds
InfluxDB 1 Enterprise adds clustering to InfluxDB 1 OSS. A cluster of meta nodes and data nodes provides high availability and eliminates a single point of failure across the cluster. For details, see InfluxDB Enterprise v1 clustering features.
FIPS-compliant builds are available for self-managed InfluxDB Enterprise v1.11.1 and later. See FIPS-compliant InfluxDB Enterprise v1 builds.
Move from InfluxDB 1 OSS to InfluxDB 1 Enterprise
To move a running InfluxDB 1 OSS instance to an InfluxDB 1 Enterprise cluster, see Migrate InfluxDB OSS instances to InfluxDB Enterprise v1 clusters.
InfluxDB 1 Cloud
InfluxDB 1 Cloud is a managed service based on InfluxDB 1 Enterprise. The original help site calls this service InfluxCloud. You might also see it called Cloud 1. It is available to new customers through Sales. To get started, contact Sales.
InfluxDB 1 Cloud is a Database as a Service (DBaaS) offering that provides fully managed, production-ready InfluxDB 1 Enterprise clusters hosted on AWS. It is designed to collect, store, and process time series data without the operational overhead of managing infrastructure.
Key characteristics
- Managed infrastructure: Production-ready clusters with multiple data and meta nodes managed by InfluxData
- TICK stack support: Full support for Telegraf, InfluxDB, Chronograf, and Kapacitor
- Database and retention policy data model: Uses databases and retention policies
- Query languages: InfluxQL and Flux
- Optional add-ons: Managed Grafana available for rich visualization and dashboarding
Documentation and support
- Technical documentation: InfluxDB 1 Cloud users should refer to InfluxDB 1 Enterprise documentation, as InfluxDB 1 Cloud is based on InfluxDB 1 Enterprise
- InfluxDB 1 Cloud support portal: For account, billing, and service questions, visit help.influxcloud.net
- API compatibility: InfluxDB 1 Cloud uses the same APIs and tools as InfluxDB 1 Enterprise
Migrate to InfluxDB 3
InfluxDB 1 users can move to InfluxDB 3 when they need its capabilities, such as SQL, object storage, and unlimited series cardinality. Migration is optional: InfluxDB 1 remains available and actively supported. InfluxDB Cloud (TSM) customers can migrate to modern InfluxDB 3 products with improved performance, scalability, and features. Migration options include:
- InfluxDB 3 Enterprise: Self-hosted with clustering, high availability, and advanced security
- InfluxDB Cloud Serverless: Fully managed, multi-tenant InfluxDB 3 with automatic scaling
- InfluxDB Cloud Dedicated: Single-tenant InfluxDB 3 cluster with dedicated resources
Questions about migrating to InfluxDB 3? Contact InfluxData Sales.
All InfluxDB 3 products provide v1 compatibility APIs and the v2 write API to ease the transition:
- Use
/writeand/queryendpoints with existing v1 client libraries and tools - Use
/api/v2/writeendpoint with existing v2 client libraries and tools - Map v1 databases and retention policies (DBRP) to InfluxDB 3 databases and InfluxDB Cloud Serverless buckets
- Authenticate using tokens or username/password schemes
- Migrate workloads incrementally without rewriting applications
Migration guides:
- Use compatibility APIs and client libraries to write data to InfluxDB 3 Enterprise
- Migrate data to InfluxDB Cloud Dedicated
- Migrate data to InfluxDB Cloud Serverless
Monitoring
“Monitoring” covers two different things:
- Monitor InfluxDB itself—track the health and performance of your InfluxDB instance or cluster.
- Monitor other systems with InfluxDB—use InfluxDB as your time series monitoring backend for infrastructure and applications.
Monitor InfluxDB itself
- InfluxDB 3 Core and Enterprise: Query system data
- InfluxDB Cloud Dedicated: Monitor your cluster
- InfluxDB OSS v2: InfluxDB OSS metrics
- InfluxDB Enterprise v1: Monitor InfluxDB Enterprise
- InfluxDB OSS v1: Monitor InfluxDB
Monitor other systems with InfluxDB
- Collect metrics from other systems with Telegraf
- InfluxDB 3 Core and Enterprise: process and alert on incoming data with the Python processing engine
- InfluxDB OSS v2 and InfluxDB Cloud (TSM): checks, notification rules, and endpoints
- InfluxDB v1.x (TICK stack): monitor Kubernetes with Telegraf
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support.