Merge pull request #226 from influxdata/telegraf-workflow

Telegraf workflow
pull/227/head
Scott Anderson 2019-05-07 13:14:21 -06:00 committed by GitHub
commit 245ddac699
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 71 additions and 32 deletions

View File

@ -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 <a href="mailto:cloudbeta@influxdata.com?subject={{ $cloudName }} Feedback">cloudbeta@influxdata.com</a>.
To upgrade to Paid tier for free, discuss use cases, or increase rate limits,
reach out to <a href="mailto:cloudbeta@influxdata.com?subject={{< cloud-name >}} Feedback">cloudbeta@influxdata.com</a>.
{{% 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 %}}

View File

@ -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: <code>https:<nolink>//us-west-2-1.aws.cloud2.influxdata.com</code>
{{% /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

Binary file not shown.

Before

Width:  |  Height:  |  Size: 549 KiB

After

Width:  |  Height:  |  Size: 185 KiB