docs-v2/content/platform/_index.md

160 lines
6.4 KiB
Markdown
Raw Normal View History

---
title: Introduction to the InfluxData platform
description: The InfluxData platform is the leading modern time-series platform built for metrics and events.
aliases:
2020-08-10 16:37:47 +00:00
- /platform/introduction
menu:
platform:
name: Introduction
weight: 1
---
**InfluxData platform** is the leading modern [time series](/platform/faq/#what-is-time-series-data) platform, built for metrics and events. Explore both versions of our platform below--[**InfluxDB 2.0**](#influxdb-2-0) and [**InfluxData 1.x**](#influxdata-1-x).
## InfluxDB 2.0
The **InfluxDB 2.0 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.0](/influxdb/v2.0/get-started/): open source platform solution in a single binary
- [InfluxDB Cloud](/influxdb/cloud/get-started/) (**commercial offering**): hosted cloud solution
- [Telegraf](#telegraf): collect data
{{% note %}}
#### Integrate InfluxDB 2.0 applications with InfluxDB Enterprise 1.8+
Use [InfluxDB 2.0 API compatibility endpoints](/enterprise_influxdb/v1.9/tools/api/#influxdb-20-api-compatibility-endpoints) to integrate applications built on InfluxDB 2.0 or InfluxDB Cloud with InfluxDB Enterprise 1.8+:
- Query data in InfluxDB Enterprise using `api/v2/query` and Flux.
- Write data to InfluxDB Enterprise using `api/v2/write` (compatible with InfluxDB 2.0 client libraries).
{{% /note %}}
## InfluxData 1.x
2020-09-01 14:19:51 +00:00
The **InfluxData 1.x platform** includes the following open source components ([TICK stack](#influxdata-1-x-tick-stack)):
- [Telegraf](#telegraf): collect data
- [InfluxDB](#influxdb): store data
- [Chronograf](#chronograf): visualize data
- [Kapacitor](#kapacitor): process data and alerts
**InfluxData 1.x** also includes the following **commercial offerings**:
- [InfluxDB Enterprise](#influxdb-enterprise)
- [Kapacitor Enterprise](#kapacitor-enterprise)
- [InfluxCloud 1.x](https://help.influxcloud.net) (hosted cloud solution)
## InfluxData 1.x TICK stack
### Telegraf
Telegraf is a data collection agent that captures data from a growing list of sources
and translates it into [InfluxDB line protocol format](/{{< latest "influxdb" "v1" >}}/write_protocols/line_protocol_reference/)
for storage in InfluxDB. Telegraf's extensible architecture makes it easy to
create [plugins](/{{< latest "telegraf" >}}/plugins/) that both pull data (input plugins) and push data (output plugins)
to and from different sources and endpoints.
### InfluxDB
InfluxDB stores data for any use case involving large amounts of timestamped data, including
DevOps monitoring, log data, application metrics, IoT sensor data, and real-time analytics.
It provides functionality that allows you to conserve space on your machine by keeping
data for a defined length of time, then automatically downsampling or expiring and deleting
unneeded data from the system.
### Chronograf
Chronograf is the user interface for the TICK stack that provides customizable dashboards,
data visualizations, and data exploration. It also allows you to view and manage
[Kapacitor](#kapacitor) tasks.
### Kapacitor
Kapacitor is a data processing framework that enables you to process and act on data
as it is written to InfluxDB. This includes detecting anomalies, creating alerts
based on user-defined logic, and running ETL jobs.
## InfluxData 1.x Enterprise versions
InfluxDB Enterprise and Kapacitor Enterprise provide clustering, access control, and incremental backup functionality for production infrastructures at scale. You'll also receive direct support from the InfluxData support team.
{{% note %}}
InfluxDB Enterprise and Kapacitor Enterprise are compatible with open source versions of Telegraf and Chronograf.
{{% /note %}}
### InfluxDB Enterprise
InfluxDB Enterprise provides functionality necessary to run a high-availability (HA) InfluxDB cluster, providing clustering, horizontal scale out, and advanced access controls, including:
- Hinted handoff
- Anti-entropy
- Fine-grained authorization
- Cluster profiling
- Incremental backups
#### Hinted handoff
Data is written across nodes using an eventually consistent write model.
All writes are added to the [Hinted Handoff Queue (HHQ)](/{{< latest "enterprise_influxdb" >}}/concepts/clustering/#hinted-handoff),
then written to other nodes in the cluster.
#### Anti-Entropy
InfluxDB Enterprise's
[Anti-Entropy (AE)](/{{< latest "enterprise_influxdb" >}}/administration/anti-entropy/)
process ensures data shards in the cluster are in sync. When "entropy" (out-of-sync
data) is detected, AE will repair the affected shards, syncing the missing data.
#### Fine-grained authorization
In InfluxDB Enterprise, fine-grained authorization can be used to control access
at the measurement or series levels rather than just the database level.
#### Cluster profiling
Enterprise meta nodes expose the `/debug/pprof` API endpoint that allows you to
profile and potentially diagnose performance bottlenecks in your cluster.
#### Incremental backups
InfluxDB Enterprise allows for incremental backups that write only newly added
data to existing backup files rather than backing up all data in a new backup.
### Kapacitor Enterprise
Kapacitor Enterprise provides functionality necessary to run a high-availability
Kapacitor cluster, including:
- Kapacitor cluster management
- Alert deduplication
- Secure communication
#### Kapacitor cluster management
Kapacitor Enterprise is packaged with `kapactorctl`, a command line client for creating
and managing Kapacitor clusters.
#### Alert deduplication
As alerts are triggered in a multi-node Kapacitor cluster, Kapacitor Enterprise
deduplicates alert data to prevent duplicate alert notifications from being sent.
#### Secure communication
Data is passed between InfluxDB and Kapacitor via subscriptions.
Kapacitor Enterprise includes configuration options that let you encrypt
communication between your Kapacitor Enterprise and InfluxDB Enterprise clusters.
2020-08-10 16:37:47 +00:00
<a class="btn" href="https://portal.influxdata.com/" target="\_blank">Try InfluxData Platform Enterprise</a>
## Get started
To get started with the **InfluxData 1.x** platform, see
2020-10-02 01:10:53 +00:00
[Installation and Configuration](/platform/install-and-deploy/)
[Getting Started](/platform/introduction/getting-started)
2.0 GA and separate Cloud from OSS (#1805) * WIP separate cloud docs, duplicate content shortcode * WIP cloud-separation * WIP separate cloud * duplicated oss into cloud and am making updates * moved cloud updates to cloud * reimplemented duplicate-oss shortcode * separate Cloud and OSS content in Tools & integ... * Split OSS and Cloud content for Security & auth * Split OSS and Cloud content for Manage org * Split OSS and Cloud - Manage Orgs add'l updates * various updates, primarily in oss and cloud reference * split content for notification endpoints * Move InfluxQL doc to Cloud - Remove the "Query with InfluxQL" page from OSS docs - Re-incorporate changes made in https://github.com/influxdata/docs-v2/pull/1506 * removed product tags from nav and articles * WIP separate cloud docs, duplicate content shortcode * WIP cloud-separation * WIP separate cloud * duplicated oss into cloud and am making updates * moved cloud updates to cloud * reimplemented duplicate-oss shortcode * separate Cloud and OSS content in Tools & integ... * Split OSS and Cloud content for Security & auth * Split OSS and Cloud content for Manage org * Split OSS and Cloud - Manage Orgs add'l updates * various updates, primarily in oss and cloud reference * split content for notification endpoints * Move InfluxQL doc to Cloud - Remove the "Query with InfluxQL" page from OSS docs - Re-incorporate changes made in https://github.com/influxdata/docs-v2/pull/1506 * removed product tags from nav and articles * New URL switcher (#1720) * restructured url modal * rearchitected the url switcher functionality * add influxdb preference management to url switcher * create separate pages for querying data * update weight * Update flux-repl.md * Update influx-query.md * edits f Scott * move content from explore-metrics to data-explorer * edits; delete explore-metrics * edits * delete file * remove duplicate content * add InfluxQLquery examples * Remove references to "security script" * draft updates for Band Plot vis * WIP separate cloud docs, duplicate content shortcode * WIP cloud-separation * WIP separate cloud * duplicated oss into cloud and am making updates * moved cloud updates to cloud * reimplemented duplicate-oss shortcode * separate Cloud and OSS content in Tools & integ... * Split OSS and Cloud content for Security & auth * Split OSS and Cloud content for Manage org * Split OSS and Cloud - Manage Orgs add'l updates * various updates, primarily in oss and cloud reference * split content for notification endpoints * Move InfluxQL doc to Cloud - Remove the "Query with InfluxQL" page from OSS docs - Re-incorporate changes made in https://github.com/influxdata/docs-v2/pull/1506 * removed product tags from nav and articles * WIP separate cloud docs, duplicate content shortcode * WIP cloud-separation * WIP separate cloud * duplicated oss into cloud and am making updates * moved cloud updates to cloud * reimplemented duplicate-oss shortcode * separate Cloud and OSS content in Tools & integ... * Split OSS and Cloud content for Manage org * Split OSS and Cloud - Manage Orgs add'l updates * various updates, primarily in oss and cloud reference * split content for notification endpoints * Move InfluxQL doc to Cloud - Remove the "Query with InfluxQL" page from OSS docs - Re-incorporate changes made in https://github.com/influxdata/docs-v2/pull/1506 * New URL switcher (#1720) * restructured url modal * rearchitected the url switcher functionality * add influxdb preference management to url switcher * URL validation on custom URL (#1763) * added url validation to custom url form, resolves #1739 * removed placeholder message from custom url form * updated styles for url selector modal * Move restore command to `influx` cli, update flags * Update table for backup * Remove RC information, update paths for restore, change `backup-path` flag to `input` * WIP separate cloud docs, duplicate content shortcode * WIP cloud-separation * WIP separate cloud * duplicated oss into cloud and am making updates * moved cloud updates to cloud * reimplemented duplicate-oss shortcode * separate Cloud and OSS content in Tools & integ... * Split OSS and Cloud content for Security & auth * Split OSS and Cloud content for Manage org * Split OSS and Cloud - Manage Orgs add'l updates * various updates, primarily in oss and cloud reference * split content for notification endpoints * Move InfluxQL doc to Cloud - Remove the "Query with InfluxQL" page from OSS docs - Re-incorporate changes made in https://github.com/influxdata/docs-v2/pull/1506 * removed product tags from nav and articles * WIP separate cloud docs, duplicate content shortcode * WIP cloud-separation * WIP separate cloud * duplicated oss into cloud and am making updates * moved cloud updates to cloud * reimplemented duplicate-oss shortcode * separate Cloud and OSS content in Tools & integ... * Split OSS and Cloud content for Manage org * Split OSS and Cloud - Manage Orgs add'l updates * various updates, primarily in oss and cloud reference * Move InfluxQL doc to Cloud - Remove the "Query with InfluxQL" page from OSS docs - Re-incorporate changes made in https://github.com/influxdata/docs-v2/pull/1506 * New URL switcher (#1720) * restructured url modal * rearchitected the url switcher functionality * add influxdb preference management to url switcher * WIP separate cloud docs, duplicate content shortcode * WIP cloud-separation * WIP separate cloud * duplicated oss into cloud and am making updates * moved cloud updates to cloud * reimplemented duplicate-oss shortcode * Split OSS and Cloud content for Manage org * Split OSS and Cloud - Manage Orgs add'l updates * various updates, primarily in oss and cloud reference * Move InfluxQL doc to Cloud - Remove the "Query with InfluxQL" page from OSS docs - Re-incorporate changes made in https://github.com/influxdata/docs-v2/pull/1506 * WIP separate cloud docs, duplicate content shortcode * WIP cloud-separation * WIP separate cloud * duplicated oss into cloud and am making updates * moved cloud updates to cloud * reimplemented duplicate-oss shortcode * separate Cloud and OSS content in Tools & integ... * Split OSS and Cloud content for Manage org * Split OSS and Cloud - Manage Orgs add'l updates * various updates, primarily in oss and cloud reference * Move InfluxQL doc to Cloud - Remove the "Query with InfluxQL" page from OSS docs - Re-incorporate changes made in https://github.com/influxdata/docs-v2/pull/1506 * URL validation on custom URL (#1763) * added url validation to custom url form, resolves #1739 * removed placeholder message from custom url form * updated styles for url selector modal * WIP updating InfluxDB OSS naming throughout * updated canonical shortcode for oss vs cloud, updated 2.0 version numbers on homepage * updated swagger file to rc4 for 2.0 and cloud * fixed canonical partial * Update multi-user Cloud docs Also adds a heading the note on permissions. Closes #1764 * Fix table for backup flags * Update input flag, remove TSI references * Address PR feedback * Remove product tag * Fix DBRP mapping examples (#1776) * updated dbrp mapping examples in influxql query guide, closes #1774 * removed unnecessarily escaped newline from dbrp mapping example * add draft rc4 and GA RNs * cloud and oss name updates * emphasis production ready * update curl example * duplicate oss pages in cloud * Address PR feedback * added new aws us east region, resolves #1777 (#1782) * Add steps for script editor * Add cloud version * moved and updated upgrade guides (#1783) * Fix typos * update upgrade links * edits * Clarify 1m cardinality is initial limit only * fix typo * fix date * Add note on `_internal` database to v1-to-v2 upgrade guide Closes #1775. * Update influxdb.md * fixed broken links throughout cloud docs * fixed broken links in 2.0 oss * Address PR feedback * remove window pushdowns * updated oss pushdown list * Add instructions for verifying InfluxDB 2.0 download * updated latest versions in edge.js * added flux-0.94.0 to flux release notes (#1790) * update date and add Flux .94.0 link * delete broken link to image * remove auto refresh; not currently in UI * add duplicate-oss tag to Cloud execute-queries * highlight diff between Flux and InfluxQL example * delete extra header * Generate v1 compatibility API docs (#1789) * updated swagger generation to generate v1 compat api docs * restructured api docs * updated restore flags table * updated infludb binary urls in oss and cloud * Address PR feedback * Make contact support a mailto link * Add --log-level flag to `influxd upgrade` Closes #1795 * add release note about api/v2/delete * update delete data note for 2.0 * edit * Fix URLs and filenames in OSS 2.0 Get Started * update version for GA * Add color to Flux example for Flux documentation (addresses #1724 ) * Change versions to 2.0.1 in GS * Replace 2.0.0 with 2.0.1 * Revert Docker updates to 2.0.0 * Add release notes for 2.0.0 * edits; add known issue * clarify DB is 1.x * updated influxdb versions in cloud and oss getting started * updated influxdb oss urls doc * remove rc and upd upgrade link in back up data * Edit `influxd upgrade` docs (#1798) * Edit `influxd upgrade` guide Major revision of existing docs. Add "Before you begin: important considerations" section. * Address PR feedback * Edit backup instructions * More work on kap * Rm comment * Rm sentence * Add note on Docker * Edit intro * Edit link * Work on PR feedback * Continue PR feedback * More PR feedback * More edits * more edits * Edits * more edits * rm word * updates to address PR feedback for the upgrade guide Co-authored-by: pierwill <pierwill@users.noreply.github.com> Co-authored-by: Scott Anderson <scott@influxdata.com> Co-authored-by: Kelly <kelly@influxdata.com> Co-authored-by: pierwill <pierwill@users.noreply.github.com> Co-authored-by: pierwill <19642016+pierwill@users.noreply.github.com> Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com> Co-authored-by: noramullen1 <42354779+noramullen1@users.noreply.github.com>
2020-11-11 16:52:14 +00:00
To get started with the **InfluxDB 2.0** platform, see [**InfluxDB Cloud**](/influxdb/cloud/get-started/) or [**InfluxDB OSS 2.0**](/influxdb/v2.0/get-started/).