docs.influxdata.com
Open in
urlscan Pro
2600:9000:275b:f000:11:8bb1:8340:93a1
Public Scan
Submitted URL: https://v2.docs.influxdata.com/v2.0/get-started/
Effective URL: https://docs.influxdata.com/influxdb/v2/get-started/
Submission: On September 22 via api from US — Scanned from DE
Effective URL: https://docs.influxdata.com/influxdb/v2/get-started/
Submission: On September 22 via api from US — Scanned from DE
Form analysis 3 forms found in the DOM
<form onsubmit="return submitFeedbackForm("pagefeedback")" id="pagefeedback"><input type="text" name="fname" class="bowlofsweets" placeholder="First Name">
<label class="radio-btns" id="helpful"><input type="radio" name="helpful" value="true">Yes</label>
<label class="radio-btns" id="not-helpful"><input type="radio" name="helpful" value="false">No</label>
</form>#
<form action="#" id="custom-url" data-message=""><input type="text" name="custom-url-field" id="custom-url-field" placeholder="http://example.com:8080"></form><form id="pagefeedbacktext"><input type="text" name="fname" class="bowlofsweets" placeholder="First Name">
<div class="lifecycle-wrapper"><textarea name="feedback-text" placeholder="Missing information? Unclear explanations? Help us improve this page!"></textarea>
<div id="thank-you">
<p>Thank you!</p>
</div>
<div class="loader-wrapper">
<div class="loader"></div>
</div>
</div>
<div class="form-buttons">
<div id="no-thanks">No thanks</div>
<div class="submit-wrapper"><input type="submit" value="Submit" onclick="return submitLifeCycleAndClose()"></div>
</div>
</form>Text Content
Documentation
InfluxDB OSS
* InfluxDB Cloud (TSM)
* InfluxDB Cloud Serverless
* InfluxDB Cloud Dedicated
* InfluxDB Clustered
* InfluxDB OSS
* InfluxDB Enterprise
* Telegraf
* Chronograf
* Kapacitor
* Flux
v2
* v2
* v1
Search all InfluxData content
* InfluxDB v2
* Install InfluxDB
* Use Docker Compose
* Upgrade InfluxDB
* InfluxDB 2.x to 2.7
* InfluxDB 1.x to 2.7
* Automatically upgrade
* Manually upgrade
* Upgrade with Docker
* Migrate CQs
* InfluxDB 2.0 beta to 2.0
* Downgrade InfluxDB
* Get started
* Set up InfluxDB
* Write data
* Query data
* Process data
* Visualize data
* Develop with the API
* Quick start
* Client library tutorials
* Python
* JavaScript
* Client libraries
* Arduino
* C#
* Dart
* Go
* Java
* JavaScript for browsers
* Kotlin
* Node.js
* Install
* Write
* Query
* PHP
* Python
* R
* Ruby
* Scala
* Swift
* v1 compatibility
* /query
* /write
* DBRP mapping
* Write data
* Load data source in UI
* No-code solutions
* Telegraf (agent)
* Automatically configure Telegraf
* Dual write to InfluxDB OSS and InfluxDB Cloud
* Manually configure Telegraf
* Use Telegraf plugins
* HTTP input plugin
* Scrape data
* Manage scrapers
* Create a scraper
* Update a scraper
* Delete a scraper
* Create scrapable endpoints
* Third-party technologies
* Developer tools
* Third-party developer tools
* Client libraries
* Write CSV data
* Influx CLI
* Scrape Prometheus metrics
* InfluxDB API
* Best practices
* Schema design
* Resolve high cardinality
* Optimize writes to InfluxDB
* Handle duplicate points
* Write from OSS to Cloud
* Edge data replication
* Replicate data
* Migrate data
* Migrate data from OSS
* Migrate from Cloud to OSS
* Troubleshoot issues
* Delete data
* Query data
* Get started with Flux
* Query InfluxDB
* Transform data
* Query with Flux
* Query fields and tags
* Group
* Sort and limit
* Window & aggregate
* Explore your schema
* Transform data with math
* Calculate percentages
* Cumulative sum
* Fill
* First & last
* Histograms
* Increase
* Join
* Median
* Moving Average
* Percentile & quantile
* Rate
* Conditional logic
* Custom functions
* Custom aggregate functions
* Exists
* Extract scalar values
* Geo-temporal data
* Shape geo-temporal data
* Filter by region
* Group geo-temporal data
* Monitor states
* Operate on timestamps
* Query SQL data sources
* Regular expressions
* Flux version
* Query with InfluxQL
* Manage DBRP mappings
* Explore data
* SELECT statement
* WHERE clause
* GROUP BY clause
* ORDER BY clause
* LIMIT and SLIMIT clauses
* OFFSET and SOFFSET clauses
* Time and timezone
* Subqueries
* Regular expressions
* Explore your schema
* InfluxQL functions
* Aggregates
* Selectors
* Technical analysis
* Transformations
* Manage your data
* Mathematical operators
* Execute queries
* Query with Data Explorer
* Query with the InfluxDB API
* Query in the Flux REPL
* Use the influx CLI
* Query with sample data
* Common queries
* Operate on columns
* Use multiple fields in a calculation
* Compare values from different buckets
* IoT common queries
* Optimize queries
* Visualize data
* Manage dashboards
* Create a dashboard
* Control a dashboard
* Export a dashboard
* Delete a dashboard
* Use and manage variables
* Create a variable
* Update a variable
* View variables
* Export a variable
* Delete a variable
* Variable types
* Common variable queries
* Manage labels
* Use annotations
* Visualization types
* Band
* Gauge
* Graph
* Graph + Single Stat
* Heatmap
* Histogram
* Mosaic
* Scatter
* Single Stat
* Table
* Process data
* Get started with tasks
* Manage tasks
* Create a task
* View tasks
* Run a task
* View run history
* Update a task
* Export a task
* Delete a task
* Common tasks
* Downsample data
* Calculate a weekly mean
* Convert results to JSON
* Task options
* Monitor & alert
* Manage checks
* Create checks
* View checks
* Update checks
* Delete checks
* Manage notification endpoints
* Create endpoints
* View endpoint history
* Update endpoints
* Delete endpoints
* Manage notification rules
* Create notification rules
* View notification rules
* Update notification rules
* Delete notification rules
* Monitor with templates
* Monitor InfluxDB OSS
* Monitor infrastructure
* AWS CloudWatch
* Raspberry Pi
* Docker
* vSphere
* Windows
* Monitor networks
* HAproxy
* Send alert email
* Create custom checks
* Tools & integrations
* Telegraf configurations
* Clone a config
* Create a config
* View configs
* Update a config
* Remove a config
* Notebooks
* Overview of notebooks
* Create a notebook
* Manage notebooks
* Downsample data
* Normalize data
* Troubleshoot notebooks
* InfluxDB templates
* Use templates
* Create a template
* InfluxDB stacks
* Save time with stacks
* Initialize a stack
* Update a stack
* View stacks
* Remove a stack
* influx CLI
* Flux REPL
* InfluxQL shell
* Flux VS Code extension
* Flux LSP with Vim
* Grafana
* Chronograf
* Kapacitor
* Quix
* Postman
* Administer InfluxDB
* Manage organizations
* Create an organization
* View organizations
* Update an organization
* Delete an organization
* Switch organizations
* Manage members
* Add a member
* View members
* Remove a member
* Manage buckets
* Create a bucket
* Update a bucket
* View buckets
* Delete a bucket
* Manage tokens
* Create a token
* View tokens
* Update a token
* Delete a token
* Use tokens
* Manage users
* Create a user
* View users
* Delete a user
* Update a user
* Change your password
* Recover credentials
* Manage security
* Enable TLS encryption
* Enable security features
* Disable development features
* Manage secrets
* Add secrets
* View secret keys
* Update secrets
* Delete secrets
* Use secrets
* Store secrets in Vault
* Back up & restore data
* Back up data
* Restore data
* Manage internal systems
* Manage TSI indexes
* Rebuild the TSI index
* Inspect TSI indexes
* Manage logs
* Reference
* Release notes
* InfluxDB
* influx CLI
* Supported releases
* Key concepts
* Data elements
* Data schema
* Design principles
* Configuration options
* InfluxDB HTTP API
* v2 API
* v1 Compatibility API
* Command line tools
* influx
* influx apply
* influx auth
* influx auth active
* influx auth create
* influx auth delete
* influx auth inactive
* influx auth list
* influx backup
* influx bucket
* influx bucket create
* influx bucket delete
* influx bucket list
* influx bucket update
* influx bucket-schema
* influx bucket-schema create
* influx bucket-schema list
* influx bucket-schema update
* influx completion
* influx config
* influx config create
* influx config list
* influx config rm
* influx config set
* influx dashboards
* influx delete
* influx export
* influx export all
* influx export stack
* influx help
* influx org
* influx org create
* influx org delete
* influx org list
* influx org members
* influx org members add
* influx org members list
* influx org members remove
* influx org update
* influx ping
* influx query
* influx remote
* influx remote create
* influx remote delete
* influx remote list
* influx remote update
* influx replication
* influx replication create
* influx replication delete
* influx replication list
* influx replication update
* influx restore
* influx scripts
* influx scripts create
* influx scripts delete
* influx scripts invoke
* influx scripts list
* influx scripts retrieve
* influx scripts update
* influx secret
* influx secret delete
* influx secret list
* influx secret update
* influx server-config
* influx setup
* influx stacks
* influx stacks init
* influx stacks remove
* influx stacks update
* influx task
* influx task create
* influx task delete
* influx task list
* influx task log
* influx task log list
* influx task retry-failed
* influx task run
* influx task run list
* influx task run retry
* influx task update
* influx telegrafs
* influx telegrafs rm
* influx telegrafs update
* influx template
* influx template validate
* influx user
* influx user create
* influx user delete
* influx user list
* influx user password
* influx user update
* influx v1
* influx v1 auth
* influx v1 auth create
* influx v1 auth delete
* influx v1 auth list
* influx v1 auth set-active
* influx v1 auth set-inactive
* influx v1 auth set-password
* influx v1 dbrp
* influx v1 dbrp create
* influx v1 dbrp delete
* influx v1 dbrp list
* influx v1 dbrp update
* influx v1 shell
* influx write
* influx write dryrun
* influx version
* influxd
* influxd downgrade
* influxd inspect
* influxd inspect build-tsi
* influxd inspect check-schema
* influxd inspect delete-tsm
* influxd inspect dump-tsi
* influxd inspect dump-tsm
* influxd inspect dump-wal
* influxd inspect export-index
* influxd inspect export-lp
* influxd inspect merge-schema
* influxd inspect report-db
* influxd inspect report-tsi
* influxd inspect report-tsm
* influxd inspect verify-seriesfile
* influxd inspect verify-tombstone
* influxd inspect verify-tsm
* influxd inspect verify-wal
* influxd recovery
* influxd recovery auth
* influxd recovery auth create-operator
* influxd recovery auth list
* influxd recovery org
* influxd recovery org create
* influxd recovery org list
* influxd recovery user
* influxd recovery user create
* influxd recovery user list
* influxd recovery user update
* influxd run
* influxd upgrade
* influxd version
* Syntax
* Flux
* Flux vs InfluxQL
* InfluxQL
* InfluxQL 2.x specification
* InfluxQL internals
* Line protocol
* Annotated CSV
* Extended annotated CSV
* Delete predicate
* InfluxDB URLs
* InfluxDB internals
* Storage engine
* File system layout
* Data retention
* Runtime
* Shards & shard groups
* System buckets
* Metrics
* Sample data
* Prometheus metrics
* Frequently asked questions
* Glossary
* Contribute to InfluxDB
GET STARTED WITH INFLUXDB
InfluxDB 2.7 is the platform purpose-built to collect, store, process and
visualize time series data. Time series data is a sequence of data points
indexed in time order. Data points typically consist of successive measurements
made from the same source and are used to track changes over time. Examples of
time series data include:
* Industrial sensor data
* Server performance metrics
* Heartbeats per minute
* Electrical activity in the brain
* Rainfall measurements
* Stock prices
This multi-part tutorial walks you through writing time series data to InfluxDB
2.7, querying that data, processing and alerting on the data, and then
visualizing the data.
KEY CONCEPTS BEFORE YOU GET STARTED
Before you get started using InfluxDB, it’s important to understand how time
series data is organized and stored in InfluxDB and some key definitions that
are used throughout this documentation.
DATA ORGANIZATION
The InfluxDB data model organizes time series data into buckets and
measurements. A bucket can contain multiple measurements. Measurements contain
multiple tags and fields.
* Bucket: Named location where time series data is stored. A bucket can contain
multiple measurements.
* Measurement: Logical grouping for time series data. All points in a given
measurement should have the same tags. A measurement contains multiple tags
and fields.
* Tags: Key-value pairs with values that differ, but do not change often.
Tags are meant for storing metadata for each point–for example, something
to identify the source of the data like host, location, station, etc.
* Fields: Key-value pairs with values that change over time–for example:
temperature, pressure, stock price, etc.
* Timestamp: Timestamp associated with the data. When stored on disk and
queried, all data is ordered by time.
For detailed information and examples of the InfluxDB data model, see Data
elements.
IMPORTANT DEFINITIONS
The following are important definitions to understand when using InfluxDB:
* Point: Single data record identified by its measurement, tag keys, tag
values, field key, and timestamp.
* Series: A group of points with the same measurement, tag keys, and tag
values.
EXAMPLE INFLUXDB QUERY RESULTS
_time_measurement
Tag Key
city
Tag Key
country_field_value
Timestamp
2022-01-01T12:00:00Z
Measurement
weather
Tag Value
London
Tag Value
UK
Field Key
temperature
Field Value
12.02022-02-01T12:00:00ZweatherLondonUKtemperature12.12022-03-01T12:00:00ZweatherLondonUKtemperature11.52022-04-01T12:00:00ZweatherLondonUKtemperature5.9
_time_measurementcitycountry_field_value2022-01-01T12:00:00ZweatherCologneDEtemperature13.22022-02-01T12:00:00ZweatherCologneDEtemperature11.52022-03-01T12:00:00ZweatherCologneDEtemperature10.22022-04-01T12:00:00ZweatherCologneDEtemperature7.9
TOOLS TO USE
Throughout this tutorial, there are multiple tools you can use to interact with
InfluxDB 2.7. Examples are provided for each of the following:
* InfluxDB user interface (UI)
* influx CLI
* InfluxDB HTTP API
INFLUXDB USER INTERFACE (UI)
The InfluxDB UI provides a web-based visual interface for interacting with and
managing InfluxDB. The UI is packaged with InfluxDB and runs as part of the
InfluxDB service. To access the UI, with InfluxDB running, visit localhost:8086
in your browser.
INFLUX CLI
The influx CLI lets you interact with and manage InfluxDB 2.7 from a command
line. The CLI is packaged separately from InfluxDB and must be downloaded and
installed separately. For detailed CLI installation instructions, see Use the
influx CLI.
INFLUXDB HTTP API
The InfluxDB API provides a simple way to interact with the InfluxDB 2.7 using
HTTP(S) clients. Examples in this tutorial use cURL, but any HTTP(S) client will
work.
INFLUXDB CLIENT LIBRARIES
InfluxDB client libraries are language-specific clients that interact with the
InfluxDB HTTP API. Examples for client libraries are not provided in this
tutorial, but these can be used to perform all the actions outlined in this
tutorial.
AUTHORIZATION
InfluxDB 2.7 requires authentication using API tokens. Each API token is
associated with a user and a specific set of permissions for InfluxDB resources.
Set up InfluxDB
--------------------------------------------------------------------------------
INFLUXDB ESSENTIALS
Learn how to write, query, and visualize data in InfluxDB in this free InfluxDB
University course.
Take the course
get-started
--------------------------------------------------------------------------------
Was this page helpful?
Yes No
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 InfluxDB and this documentation. To find support,
use the following resources:
* InfluxData Community
* InfluxDB Community Slack
Customers with an annual or support contract can contact InfluxData Support.
Edit this page Submit docs issue Submit InfluxDB issue
© 2024 InfluxData, Inc.
WHAT IS YOUR INFLUXDB OSS URL?
Customize your InfluxDB OSS URL and we’ll update code examples for you.
DEFAULT
* localhost:8086
CUSTOM
*
For more information, see InfluxDB OSS URLs.
THANK YOU FOR YOUR FEEDBACK!
Let us know what we can do better:
Thank you!
No thanks
THE FUTURE OF FLUX
Flux is going into maintenance mode. You can continue using it as you currently
are without any changes to your code.
Read more
INFLUXDB V3 ENHANCEMENTS AND INFLUXDB CLUSTERED IS NOW GENERALLY AVAILABLE
New capabilities, including faster query performance and management tooling
advance the InfluxDB v3 product line. InfluxDB Clustered is now generally
available.
INFLUXDB V3 PERFORMANCE AND FEATURES
The InfluxDB v3 product line has seen significant enhancements in query
performance and has made new management tooling available. These enhancements
include an operational dashboard to monitor the health of your InfluxDB cluster,
single sign-on (SSO) support in InfluxDB Cloud Dedicated, and new management
APIs for tokens and databases.
Learn about the new v3 enhancements
--------------------------------------------------------------------------------
INFLUXDB CLUSTERED GENERAL AVAILABILITY
InfluxDB Clustered is now generally available and gives you the power of
InfluxDB v3 in your self-managed stack.
Talk to us about InfluxDB Clustered
By clicking “Accept All Cookies”, you agree to the storing of cookies on your
device to enhance site navigation, analyze site usage, and assist in our
marketing efforts. Cookie PolicyPrivacy Policy
Accept All Cookies
Reject All
Cookies Settings
PRIVACY PREFERENCE CENTER
When you visit any website, it may store or retrieve information on your
browser, mostly in the form of cookies. This information might be about you,
your preferences or your device and is mostly used to make the site work as you
expect it to. The information does not usually directly identify you, but it can
give you a more personalized web experience. Because we respect your right to
privacy, you can choose not to allow some types of cookies. Click on the
different category headings to find out more and change our default settings.
However, blocking some types of cookies may impact your experience of the site
and the services we are able to offer.
More information
Allow All
MANAGE CONSENT PREFERENCES
PERFORMANCE COOKIES
Performance Cookies
These cookies allow us to count visits and traffic sources so we can measure and
improve the performance of our site. They help us to know which pages are the
most and least popular and see how visitors move around the site. All
information these cookies collect is aggregated and therefore anonymous. If you
do not allow these cookies we will not know when you have visited our site, and
will not be able to monitor its performance.
FUNCTIONAL COOKIES
Functional Cookies
These cookies enable the website to provide enhanced functionality and
personalisation. They may be set by us or by third party providers whose
services we have added to our pages. If you do not allow these cookies then some
or all of these services may not function properly.
TARGETING COOKIES
Targeting Cookies
These cookies may be set through our site by our advertising partners. They may
be used by those companies to build a profile of your interests and show you
relevant adverts on other sites. They do not store directly personal
information, but are based on uniquely identifying your browser and internet
device. If you do not allow these cookies, you will experience less targeted
advertising.
SOCIAL MEDIA COOKIES
Social Media Cookies
These cookies are set by a range of social media services that we have added to
the site to enable you to share our content with your friends and networks. They
are capable of tracking your browser across other sites and building up a
profile of your interests. This may impact the content and messages you see on
other websites you visit. If you do not allow these cookies you may not be able
to use or see these sharing tools.
STRICTLY NECESSARY COOKIES
Always Active
These cookies are necessary for the website to function and cannot be switched
off in our systems. They are usually only set in response to actions made by you
which amount to a request for services, such as setting your privacy
preferences, logging in or filling in forms. You can set your browser to block
or alert you about these cookies, but some parts of the site will not then work.
These cookies do not store any personally identifiable information.
Back Button
COOKIE LIST
Search Icon
Filter Icon
Clear
checkbox label label
Apply Cancel
Consent Leg.Interest
checkbox label label
checkbox label label
checkbox label label
Reject All Confirm My Choices