diff --git a/content/v2.0/cloud/get-started.md b/content/v2.0/cloud/get-started.md index efd682584..ad3f2957a 100644 --- a/content/v2.0/cloud/get-started.md +++ b/content/v2.0/cloud/get-started.md @@ -7,7 +7,7 @@ menu: v2_0_cloud: name: Get started with InfluxDB Cloud --- -{{< cloud-name >}} is a fully managed and hosted version of the [InfluxDB 2.0]. +{{< cloud-name >}} is a fully managed and hosted version of the InfluxDB 2.0. To get started, complete the tasks below. {{% cloud-msg %}} @@ -16,55 +16,67 @@ InfluxDB v2.0 alpha documentation applies to {{< cloud-name "short" >}} unless o ## Sign up -1. Go to [InfluxDB Cloud 2.0]({{< cloud-link >}}), enter your email and password, and then click **Sign Up**. +1. Go to [InfluxDB Cloud 2.0]({{< cloud-link >}}), enter your email and password, + and then click **Sign Up**. -2. Open email from cloudbeta@influxdata.com (subject: Please verify your email for InfluxDB Cloud), and then click **Verify Your Email**. The Welcome to InfluxDB Cloud 2.0 page is displayed. +2. Open email from cloudbeta@influxdata.com (subject: Please verify your email for InfluxDB Cloud), + and then click **Verify Your Email**. The Welcome to InfluxDB Cloud 2.0 page is displayed. -3. Currently, {{< cloud-name >}} us-west-2 region is the only region available. To suggest regions to add, click the **Let us know** link under Regions. +3. Currently, {{< cloud-name >}} us-west-2 region is the only region available. + To suggest regions to add, click the **Let us know** link under Regions. -4. Review the terms of the beta agreement, and then select **I viewed and agree to InfluxDB Cloud 2.0 Beta Agreement**. +4. Review the terms of the beta agreement, and then select + **I viewed and agree to InfluxDB Cloud 2.0 Beta Agreement**. -5. Click **Continue**. InfluxDB Cloud 2.0 opens with a default organization (created from your email) and bucket (created from your email local-part). +5. Click **Continue**. InfluxDB Cloud 2.0 opens with a default organization + (created from your email) and bucket (created from your email local-part). ## Log in - Log in to [InfluxDB Cloud 2.0](https://us-west-2-1.aws.cloud2.influxdata.com) using the credentials created above. -## Collect data +## Collect and write data +Collect and write data to InfluxDB using Telegraf, the InfluxDB v2 API, `influx` +command line interface (CLI), the InfluxDB user interface (UI), or client libraries. -Use Telegraf to collect and write data to {{< cloud-name >}}. Create Telegraf configurations automatically in the UI or manually configure Telegraf. +### Use Telegraf +Use Telegraf to quickly write data to {{< cloud-name >}}. +Create new Telegraf configurations automatically in the UI or manually update an +existing Telegraf configuration to send data to your {{< cloud-name "short" >}} instance. -For details, see [Automatically configure Telegraf](https://v2.docs.influxdata.com/v2.0/write-data/use-telegraf/auto-config/#create-a-telegraf-configuration) and [Manually configure Telegraf](https://v2.docs.influxdata.com/v2.0/write-data/use-telegraf/manual-config/). +For details, see [Automatically configure Telegraf](/v2.0/write-data/use-telegraf/auto-config/#create-a-telegraf-configuration) +and [Manually update Telegraf configurations](/v2.0/write-data/use-telegraf/manual-config/). + +### API, CLI, and client libraries +For information about using the InfluxDB API, CLI, and client libraries to write data, +see [Write data to InfluxDB](/v2.0/write-data/). ## Query and visualize data +Once you've set up {{< cloud-name "short" >}} to collect data, you can do the following: -Once you've set up {{< cloud-name "short" >}} to collect data with Telegraf, you can do the following: - -- Query data using Flux, the UI, and the `influx` command line interface. See [Query data](https://v2.docs.influxdata.com/v2.0/query-data/). -- Build custom dashboards to visualize your data. See [Visualize data](https://v2.docs.influxdata.com/v2.0/visualize-data/). +- Query data using Flux, the UI, and the `influx` command line interface. See [Query data](/v2.0/query-data/). +- Build custom dashboards to visualize your data. See [Visualize data](/v2.0/visualize-data/). ## View data usage - Once you've set up {{< cloud-name "short" >}} to collect data, view your data usage, including: -- Writes: Total kilobytes ingested. -- Reads: Total kilobytes sent out for responses to queries. -- Total Query Duration: Sum of time spent processing queries in seconds. -- Storage: Average disk usage in gigabytes. +- **Writes:** Total kilobytes ingested. +- **Reads:** Total kilobytes sent out for responses to queries. +- **Total Query Duration:** Sum of time spent processing queries in seconds. +- **Storage:** Average disk usage in gigabytes. -You'll see sparkline data over the past 4 hours and a single value that shows usage in the last 5 minutes. To view your data, click **Usage** in the left navigation menu. +You'll see sparkline data over the past 4 hours and a single value that shows usage in the last 5 minutes. +To view your data, click **Usage** in the left navigation menu. {{< img-hd src="/img/2-0-cloud-usage.png" />}} ## Review rate limits +To optimize InfluxDB Cloud 2.0 services, [rate limits](/v2.0/cloud/rate-limits/) are in place for Free tier users. +During beta, you can check out our Paid tier for free. -To optimize InfluxDB Cloud 2.0 services, [rate limits](/v2.0/cloud/rate-limits/) are in place for Free tier users. During beta, you can check out our Paid tier for free. - -To upgrade to Paid tier for free, discuss use cases, or increase rate limits, reach out to cloudbeta@influxdata.com. +To upgrade to Paid tier for free, discuss use cases, or increase rate limits, +reach out to cloudbeta@influxdata.com. {{% note %}} #### Known issues and disabled features _See [Known issues](/v2.0/cloud/about/known-issues/) for information regarding all known issues in InfluxDB Cloud._ {{% /note %}} - - diff --git a/content/v2.0/write-data/use-telegraf/manual-config.md b/content/v2.0/write-data/use-telegraf/manual-config.md index ff7b7f2c5..1e013af5f 100644 --- a/content/v2.0/write-data/use-telegraf/manual-config.md +++ b/content/v2.0/write-data/use-telegraf/manual-config.md @@ -2,8 +2,9 @@ title: Manually configure Telegraf seotitle: Manually configure Telegraf for InfluxDB v2.0 description: > - Manually configure Telegraf to write to InfluxDB v2.0 using the Telegraf `influxdb_v2` - output plugin, and then start Telegraf using the custom configuration. + Update existing or create new Telegraf configurations to use the `influxdb_v2` + output plugin to write to InfluxDB v2.0. + Start Telegraf using the custom configuration. aliases: - /v2.0/collect-data/use-telegraf/manual-config menu: @@ -12,10 +13,9 @@ menu: weight: 202 --- -Telegraf's `influxdb_v2` output plugin pushes all metrics collected by Telegraf -into an InfluxDB v2.0 bucket. -This article describes how to enable the `influxdb_v2` output plugin, -and then start Telegraf using the custom configuration file. +Use the Telegraf `influxdb_v2` output plugin to collect and write metrics into an InfluxDB v2.0 bucket. +This article describes how to enable the `influxdb_v2` output plugin in new and existing Telegraf configurations, +then start Telegraf using the custom configuration file. {{% note %}} _View the [requirements](/v2.0/write-data/use-telegraf#requirements) @@ -32,12 +32,18 @@ To send data to an InfluxDB v2.0 instance, enable in the [`influxdb_v2` output plugin](https://github.com/influxdata/telegraf/blob/master/plugins/outputs/influxdb_v2/README.md) in the `telegraf.conf`. -The following settings are required: +Specify the following: ##### urls An array of URLs for your InfluxDB v2.0 instances. _By default, InfluxDB runs on port `9999`._ +{{% cloud-msg %}} +To write data to an {{< cloud-name "short" >}} instance, use the URL of your {{< cloud-name "short" >}} +user interface (UI). +For example: https://us-west-2-1.aws.cloud2.influxdata.com +{{% /cloud-msg %}} + ##### token Your InfluxDB v2.0 authorization token. For information about viewing tokens, see [View tokens](/v2.0/security/tokens/view-tokens/). @@ -62,6 +68,12 @@ The name of the organization that owns the target bucket. The name of the bucket to write data to. #### Example influxdb_v2 configuration +{{< code-tabs-wrapper >}} +{{% code-tabs %}} +[InfluxDB OSS](#) +[{{< cloud-name "short" >}}](#) +{{% /code-tabs %}} +{{% code-tab-content %}} ```toml # ... @@ -73,6 +85,21 @@ The name of the bucket to write data to. # ... ``` +{{% /code-tab-content %}} +{{% code-tab-content %}} +```toml +# ... + +[[outputs.influxdb_v2]] + urls = ["https://us-west-2-1.aws.cloud2.influxdata.com"] + token = "$INFLUX_TOKEN" + organization = "example-org" + bucket = "example-bucket" + +# ... +``` +{{% /code-tab-content %}} +{{< /code-tabs-wrapper >}} {{% note %}} ##### Write to InfluxDB v1.x and v2.0 diff --git a/static/img/2-0-cloud-usage.png b/static/img/2-0-cloud-usage.png index e0d7ced7e..58fcc0eb6 100644 Binary files a/static/img/2-0-cloud-usage.png and b/static/img/2-0-cloud-usage.png differ