Documentation

InfluxDB 3 Core

InfluxDB 3

  • InfluxDB 3 Core New
  • InfluxDB 3 Enterprise New
  • InfluxDB Clustered
  • InfluxDB Cloud Serverless
  • InfluxDB Cloud Dedicated
  • InfluxDB 3 Explorer New

InfluxDB 2

  • InfluxDB OSS v2
  • InfluxDB Cloud (TSM)
  • Flux

InfluxDB 1

  • InfluxDB OSS v1
  • InfluxDB Enterprise

Telegraf

  • Telegraf
  • Telegraf Controller alpha

Other products

  • Chronograf
  • Kapacitor
  • InfluxDB 3 Core
  • Install InfluxDB 3 Core
  • Get started
    • Set up Core
    • Write data
    • Query data
    • Process data
  • Write data
    • Use client libraries
    • Use the HTTP API
      • Use the v3 write_lp API
      • Use v1 and v2 compatibility APIs
    • Use Telegraf
      • Configure Telegraf
      • Dual write to InfluxDB
      • Write CSV
    • Use the influxdb3 CLI
    • Best practices
      • Schema design
      • Optimize writes
    • Troubleshoot issues
  • Processing engine and Python plugins
    • Extend plugins
    • Plugin library
      • Example plugins
        • WAL plugin
      • Official plugins
        • Basic transformation
        • Downsampler
        • Forecast error evaluator
        • InfluxDB to Iceberg
        • MAD anomaly detection
        • Notifier
        • Prophet forecasting
        • State change
        • Stateless ADTK detector
        • System metrics
        • Threshold deadman checks
  • Query data
    • Execute queries
      • Use the influxdb3 CLI
      • Use the v3 query API
      • Use the v1 query API
    • Query with SQL
      • Explore your schema
      • Basic query
      • Aggregate data
      • Cast types
      • Compare values
      • Fill gaps in data
      • Parameterized queries
    • Query with InfluxQL
      • Explore your schema
      • Basic query
      • Aggregate data
      • Troubleshoot errors
      • Parameterized queries
  • Visualize data
    • Grafana
    • Power BI
  • Administer InfluxDB
    • Identify version
    • Manage databases
      • Create a database
      • List databases
      • Delete a database
    • Manage tables
      • Create a table
      • List tables
      • Delete a table
    • Manage tokens
      • Admin tokens
        • Create an admin token
        • List admin tokens
        • Regenerate an admin token
        • Use preconfigured admin token
    • Manage the Last Value Cache
      • Create a Last Value Cache
      • Query a Last Value Cache
      • Show Last Value Caches
      • Delete a Last Value Cache
    • Manage the Distinct Value Cache
      • Create a Distinct Value Cache
      • Query a Distinct Value Cache
      • Show Distinct Value Caches
      • Delete a Distinct Value Cache
    • Configure object storage
      • MinIO
    • Query system data
    • Back up and restore
    • Performance tuning
    • Security
    • Upgrade InfluxDB
    • Use the InfluxDB MCP server
  • Reference
    • Configuration options
    • CLIs
      • influxdb3
        • influxdb3 create
          • influxdb3 create database
          • influxdb3 create distinct_cache
          • influxdb3 create last_cache
          • influxdb3 create table
          • influxdb3 create token
            • influxdb3 create token --admin
          • influxdb3 create trigger
        • influxdb3 delete
          • influxdb3 delete token
          • influxdb3 delete database
          • influxdb3 delete distinct_cache
          • influxdb3 delete last_cache
          • influxdb3 delete table
          • influxdb3 delete trigger
        • influxdb3 disable
          • influxdb3 disable trigger
        • influxdb3 enable
          • influxdb3 enable trigger
        • influxdb3 install
          • influxdb3 install package
        • influxdb3 query
        • influxdb3 serve
        • influxdb3 show
          • influxdb3 show plugins
          • influxdb3 show databases
          • influxdb3 show system
            • influxdb3 show system summary
            • influxdb3 show system table
            • influxdb3 show system table-list
          • influxdb3 show tokens
          • influxdb3 show retention
        • influxdb3 test
          • influxdb3 test wal_plugin
          • influxdb3 test schedule_plugin
        • influxdb3 update
          • influxdb3 update database
          • influxdb3 update trigger
        • influxdb3 write
    • Line protocol
    • Processing engine
    • SQL reference
      • Data types
      • SELECT statement
      • JOIN clause
      • WHERE clause
      • GROUP BY clause
      • ORDER BY clause
      • HAVING clause
      • LIMIT clause
      • UNION clause
      • EXPLAIN command
      • Information schema
      • Subqueries
      • Operators
        • Arithmetic operators
        • Comparison operators
        • Logical operators
        • Bitwise operators
        • Other operators
      • Functions
        • Aggregate
        • Selector
        • Time and date
        • Conditional
        • Math
        • String
        • Binary string
        • Array
        • Map
        • Struct
        • Regular expression
        • Hashing
        • Cache
        • Miscellaneous
        • Window
      • Table value constructor
    • InfluxQL reference
      • SELECT statement
      • WHERE clause
      • GROUP BY clause
      • ORDER BY clause
      • LIMIT and SLIMIT clauses
      • OFFSET and SOFFSET clauses
      • SHOW statements
      • Subqueries
      • InfluxQL functions
        • Aggregates
        • Selectors
        • Transformations
        • Date and time
        • Miscellaneous
      • Time and time zones
      • Regular expressions
      • Quotation
      • Math operators
      • InfluxQL internals
      • InfluxQL feature support
    • InfluxDB HTTP API
      • Authentication
      • Headers and parameters
      • Migrate from InfluxDB v1 or v2
      • Quick start
      • Auth token
        • POSTCreate admin token
        • POSTRegenerate admin token
        • DELETEDelete token
        • POSTCreate named admin token
      • Cache data
        • POSTCreate distinct cache
        • DELETEDelete distinct cache
        • POSTCreate last cache
        • DELETEDelete last cache
      • Database
        • GETList databases
        • POSTCreate a database
        • DELETEDelete a database
        • DELETERemove database retention period
      • Processing engine
        • POSTCreate processing engine trigger
        • DELETEDelete processing engine trigger
        • POSTDisable processing engine trigger
        • POSTEnable processing engine trigger
        • POSTInstall plugin packages
        • POSTInstall plugin requirements
        • POSTTest WAL plugin
        • POSTTest scheduling plugin
        • GETOn Request processing engine plugin request
        • POSTOn Request processing engine plugin request
        • PUTUpdate plugin file
        • PUTUpdate plugin directory
      • Query data
        • GETExecute SQL query
        • POSTExecute SQL query
        • GETExecute InfluxQL query
        • POSTExecute InfluxQL query
        • GETExecute InfluxQL query v1
        • POSTExecute InfluxQL query v1
      • Server information
        • GETHealth check
        • GETHealth check v1
        • GETPing the server
        • GETMetrics
      • Table
        • POSTCreate a table
        • DELETEDelete a table
      • Write data
        • POSTWrite line protocol v1
        • POSTWrite line protocol v2
        • POSTWrite line protocol
      • All endpoints
        • GET /api/v1/health
        • POST /api/v2/write
        • DELETE /api/v3/configure/database
        • GET /api/v3/configure/database
        • POST /api/v3/configure/database
        • DELETE /api/v3/configure/database/retention_period
        • DELETE /api/v3/configure/distinct_cache
        • POST /api/v3/configure/distinct_cache
        • DELETE /api/v3/configure/last_cache
        • POST /api/v3/configure/last_cache
        • POST /api/v3/configure/plugin_environment/install_packages
        • POST /api/v3/configure/plugin_environment/install_requirements
        • DELETE /api/v3/configure/processing_engine_trigger
        • POST /api/v3/configure/processing_engine_trigger
        • POST /api/v3/configure/processing_engine_trigger/disable
        • POST /api/v3/configure/processing_engine_trigger/enable
        • DELETE /api/v3/configure/table
        • POST /api/v3/configure/table
        • DELETE /api/v3/configure/token
        • POST /api/v3/configure/token/admin
        • POST /api/v3/configure/token/admin/regenerate
        • POST /api/v3/configure/token/named_admin
        • GET /api/v3/engine/{request_path}
        • POST /api/v3/engine/{request_path}
        • POST /api/v3/plugin_test/schedule
        • POST /api/v3/plugin_test/wal
        • PUT /api/v3/plugins/directory
        • PUT /api/v3/plugins/files
        • GET /api/v3/query_influxql
        • POST /api/v3/query_influxql
        • GET /api/v3/query_sql
        • POST /api/v3/query_sql
        • POST /api/v3/write_lp
        • GET /health
        • GET /metrics
        • GET /ping
        • GET /query
        • POST /query
        • POST /write
    • Client libraries
      • Arrow Flight clients
        • C# .NET
        • Go
        • Java Flight SQL
        • Python
        • Python Flight SQL
      • v3 client libraries
        • C# .NET
        • Go
        • Java
        • JavaScript
        • Python
      • v2 client libraries
        • Arduino
        • C#
        • Dart
        • Go
        • Java
        • JavaScript
          • Browsers and web clients
          • Node.js
            • Install
            • Write
        • Kotlin
        • PHP
        • Python
        • R
        • Ruby
        • Scala
        • Swift
      • v1 client libraries
    • Core internals
      • Data retention
      • Authentication and authorization
      • Data durability
    • Naming restrictions and conventions
    • Usage telemetry
    • Glossary
    • Sample data
    • Release Notes

Server information

Endpoints

GET /health Health check GET /api/v1/health Health check (v1-compatible) GET /ping Ping the server GET /metrics Metrics

Overview

Retrieve server metrics, status, and version information

ON THIS PAGE

What is your InfluxDB 3 Core URL?

Customize your InfluxDB 3 Core URL and we’ll update code examples for you.

Default
Custom

For more information, see InfluxDB Cloud regions or InfluxDB OSS URLs.

Thank you for your feedback!

Let us know what we can do better:

Thank you!

No thanks

New in InfluxDB 3.8

Key enhancements in InfluxDB 3.8 and the InfluxDB 3 Explorer 1.6.

See the Blog Post

InfluxDB 3.8 is now available for both Core and Enterprise, alongside the 1.6 release of the InfluxDB 3 Explorer UI. This release is focused on operational maturity and making InfluxDB easier to deploy, manage, and run reliably in production.

For more information, check out:

  • See the announcement blog post
  • InfluxDB 3 Core release notes
  • InfluxDB 3 Enterprise release notes

InfluxDB Docker latest tag changing to InfluxDB 3 Core

On February 3, 2026, the latest tag for InfluxDB Docker images will point to InfluxDB 3 Core. To avoid unexpected upgrades, use specific version tags in your Docker deployments.

If using Docker to install and run InfluxDB, the latest tag will point to InfluxDB 3 Core. To avoid unexpected upgrades, use specific version tags in your Docker deployments. For example, if using Docker to run InfluxDB v2, replace the latest version tag with a specific version tag in your Docker pull command–for example:

docker pull influxdb:2
Ask AI