Make edits to the demo data section (#3020)
* WIP edits. * more WIP edits made. * minor edit. * WIP edits. * Update content/influxdb/cloud/get-started.md Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com> * More WIP edits. * misc edits. * Added possible section, might be uneeded. * removed demo data. * issue 2952 first bullet * misc edits. * move load data under no-code. * Update content/influxdb/cloud/get-started.md Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com> * Update content/influxdb/cloud/get-started.md Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com> * Update content/influxdb/cloud/get-started.md Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com> * WIP edits. * wip edit. * last edit was a mistake. * Update content/influxdb/cloud/write-data/developer-tools/line-protocol.md Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com> * Update content/influxdb/cloud/write-data/developer-tools/line-protocol.md Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com> * Update content/influxdb/cloud/write-data/developer-tools/line-protocol.md Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com> * Update content/influxdb/cloud/write-data/developer-tools/line-protocol.md Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com> * Update content/influxdb/cloud/write-data/developer-tools/line-protocol.md Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com> * Update content/influxdb/cloud/write-data/developer-tools/line-protocol.md Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com> * getting started and sample data edits. * wip edits. * add more info to noaa sample * edits. * WIP edits. * Re-added demo data info. * Update content/influxdb/cloud/get-started.md Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com> * Update content/influxdb/cloud/get-started.md Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com> * Update content/influxdb/cloud/get-started.md Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com> * Update content/influxdb/cloud/get-started.md Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com> * Update content/influxdb/cloud/get-started.md Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com> * Update content/influxdb/cloud/get-started.md Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com> * Update content/influxdb/cloud/get-started.md Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com> * Update content/influxdb/cloud/get-started.md Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com> * Update content/influxdb/cloud/get-started.md Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com> * Committed Scott's changes that didn't work on git * Small edits. * Added flux sample package info. * Small edit. * fix numbering; add verb overview * fix numbering; last commit simplify write data * move load data up in write data list * add link to load csv in UI * add load csv in UI to annotated CSV ref * add section for upload file in ui * reference how to upload csv in UI * rmv UI proc from developer tools * paste csv or lp data manually into UI * clarify paste lp data in ui * simplify heading and add intro sentence to clarify * clarify data in lieu of file re manually paste * minor edits * clarify manual paste for csv doc * minor edits * fix link * remove redundant sample data sets sect * add link to demo data to explore data for free * WIP edits at 5. * WIP edits. * Update content/influxdb/cloud/get-started.md Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com> Co-authored-by: kelseiv <47797004+kelseiv@users.noreply.github.com> Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com> Co-authored-by: Kelly <kelly@influxdata.com>pull/3189/head
parent
7ebfed80ab
commit
27d79b05c9
|
@ -11,66 +11,136 @@ weight: 2
|
|||
influxdb/cloud/tags: [get-started, install]
|
||||
---
|
||||
|
||||
After you've [signed up for InfluxDB Cloud](/influxdb/cloud/sign-up/), you're ready to start writing, querying, and visualizing data.
|
||||
After you've [signed up for InfluxDB Cloud](/influxdb/cloud/sign-up/), you're ready to get started:
|
||||
|
||||
To get started working in Cloud, we recommend using demo data and notebooks.
|
||||
1. Do one of the following:
|
||||
- Add [demo data](#add-demo-data).
|
||||
- Add [sample data](#add-sample-data).
|
||||
- [Use your own data](/influxdb/cloud/write-data/) to explore InfluxDB Cloud.
|
||||
2. [Create a notebook](#create-a-notebook):
|
||||
1. Clicking **Books > Create Notebook** in the navigation menu on the left.
|
||||
{{< nav-icon "books" >}}
|
||||
2. [Select metrics](#select-metrics)
|
||||
3. [Visualize data](#visualize-data)
|
||||
4. (Optional) [Process data](#process-data)
|
||||
5. (Optional) [Monitor data](#monitor-data)
|
||||
6. (Optional) [Output to a new bucket and export as a task](#output-to-a-new-bucket-and-export-as-a-task)
|
||||
|
||||
## Add demo data
|
||||
|
||||
This example uses InfluxDB Cloud's Website Monitoring demo data bucket. To add the demo data bucket:
|
||||
|
||||
1. In the navigation menu on the left, click **Data (Load Data)** > **Buckets**.
|
||||
1. Click **Data (Load Data)** > **Buckets** in the navigation menu on the left.
|
||||
|
||||
{{< nav-icon "data" >}}
|
||||
|
||||
2. Click **{{< icon "plus" >}} Add Demo Data**, and then select the **Website Monitoring** bucket.
|
||||
3. The Demo Data bucket appears in your list of buckets.
|
||||
|
||||
## Select metrics
|
||||
## Add sample data
|
||||
|
||||
Now that we've added the demo data bucket, we're ready to create our notebook.
|
||||
{{% note %}}
|
||||
The examples below use the [NOAA NDBC sample data](/influxdb/v2.0/reference/sample-data/#noaa-ndbc-data), but we provide other [sample data sets](/influxdb/cloud/reference/sample-data/#sample-datasets) as well.
|
||||
{{% /note %}}
|
||||
|
||||
Use [sample data](/influxdb/cloud/reference/sample-data/) to quickly populate InfluxDB with sample time series data. Sample data sets delivered with Cloud are used throughout this documentation site to provide context, best practices, and clear examples for how InfluxDB Cloud features and functions work.
|
||||
|
||||
1. Click **Data > Bucket** and click **Create Bucket** to create a bucket and name it **noaa**.
|
||||
2. Do one of the following to download sample data:
|
||||
- [Install community templates](#add-sample-data-with-community-templates)
|
||||
- [Write sample data with an InfluxDB task](#write-sample-data-with-an-influxdb-task)
|
||||
|
||||
### Add sample data with community templates
|
||||
|
||||
1. Visit the **InfluxDB templates page** in the InfluxDB Cloud UI. Click **Settings** > **Templates** in the navigation menu on the left.
|
||||
|
||||
{{< nav-icon "settings" >}}
|
||||
|
||||
2. Paste the Sample Data community temple URL in **resource manifest file** field:
|
||||
|
||||
```
|
||||
https://github.com/influxdata/community-templates/blob/master/sample-data/sample-data.yml
|
||||
```
|
||||
|
||||
The sample data template installs a task that collects sample data and dashboards to visualize the sample data.
|
||||
After installing the template, sample data is downloaded and stored in the sample data bucket at regular intervals.
|
||||
|
||||
### Write sample data with an InfluxDB task
|
||||
|
||||
Use the [Flux InfluxDB sample package](/{{< latest "flux" >}}/stdlib/influxdata/influxdb/sample/) to download and write sample data to InfluxDB.
|
||||
|
||||
Add the following as an [InfluxDB task](/influxdb/cloud/process-data/manage-tasks/create-task/).
|
||||
|
||||
```js
|
||||
import "influxdata/influxdb/sample"
|
||||
option task = {
|
||||
name: "Collect NOAA NDBC data"
|
||||
every: 15m,
|
||||
}
|
||||
sample.data(set: "noaa")
|
||||
|> to(bucket: "noaa" )
|
||||
```
|
||||
|
||||
For more information about this and other InfluxDB sample datasets, see [InfluxDB sample data](/influxdb/cloud/reference/sample-data/).
|
||||
|
||||
## Create a notebook
|
||||
|
||||
Now that we've added the sample data bucket, we're ready to create our notebook. Notebooks can build and annotate processes and data flows for your time series data, including writing to, querying from, and visualizing your data. For more information, see [Notebooks](/influxdb/cloud/notebooks/).
|
||||
|
||||
### Select metrics
|
||||
|
||||
1. In the navigation menu on the left, click **Notebooks**.
|
||||
|
||||
{{< nav-icon "notebooks" >}}
|
||||
2. Click **+Create Notebook**.
|
||||
3. Enter a name for your notebook in the **Name this notebook** field.
|
||||
4. By default, a **Metric Selector** and **Visualization** cell appear (see [Cell types](#cell-types) below for details.)
|
||||
5. In the **Metric Selector** cell, click the **Select a bucket** dropdown and choose **Website Monitoring Bucket**.
|
||||
2. Click **+New Notebook**. By default, a **Metric Selector** and **Visualization** cell appear. For an overview of cell types, see [Overview of notebooks](/influxdb/cloud/notebooks/overview/#notebook-cell-types).
|
||||
3. Enter a name for your notebook in the **Name this notebook** field.
|
||||
5. In the **Metric Selector** cell, click the **Select a bucket** dropdown and chooose the bucket you want to explore data from. A list of measurements, fields, and tags from the bucket appear.
|
||||
6. Select a column value to analyze.
|
||||
7. Click **Preview** to preview the raw data in a table.
|
||||
|
||||
{{< img-hd src="/img/influxdb/cloud-gs-select-bucket.png" alt="Select bucket" />}}
|
||||
### Visualize data
|
||||
|
||||
A list of measurements, fields, and tags for the Website Monitoring bucket appear.
|
||||
Next, we'll make it easier to visualize the raw data by viewing it in a graph. For more information on how to visualize data, see [here](/influxdb/cloud/visualize-data/).
|
||||
|
||||
6. For this example, click the `response_time` field.
|
||||
7. Click **Preview** to preview the raw response time data in a table.
|
||||
By default, a visualization cell appears below your initial metric selector cell showing the mean values on a graph.
|
||||
|
||||
## Visualize data
|
||||
|
||||
Next, we'll make it easier to visualize the raw data by viewing it in a graph.
|
||||
|
||||
1. By default, a visualization cell appears below your initial metric selector cell showing the mean `response_time` values on a graph:
|
||||
2. Use the function dropdown menu to view different functions to apply to your data. For this response time data, the mean function is a good fit.
|
||||
3. Use the visualization type dropdown to view different visualization types available.
|
||||
1. Use the function dropdown menu to view different functions to apply to your data. By default, the visualization is set to the mean function.
|
||||
2. Use the visualization type dropdown to view different visualization types available.
|
||||
For a complete list of options, see [Visualization types](/influxdb/cloud/visualize-data/visualization-types/).
|
||||
4. Click the gear icon ({{< icon "gear" >}}) to edit specific settings for the visualization type, such as colors, orientation, and labels.
|
||||
3. Click the gear icon ({{< icon "gear" >}}) to edit specific settings for the visualization type, such as colors, orientation, and labels.
|
||||
|
||||
## Process data
|
||||
### Process data
|
||||
|
||||
A common processing task is downsampling data to view it at different levels of granularity and reduce overall data disk usage over time. The following steps use a Flux script to downsample the website monitoring sample data to every 12 hours.
|
||||
A common processing task is downsampling data to view it at different levels of granularity and reduce overall data disk usage over time. The following steps use a Flux script to downsample your data to every 3 hours 30 seconds.
|
||||
|
||||
For more information on how to process data, see [here](/influxdb/cloud/process-data/).
|
||||
|
||||
1. Click **+** to add a cell, then select **Transform > Downsample**.
|
||||
2. In the **Apply aggregate** field, select **mean**.
|
||||
3. In the **Every Window Period** field, enter a value. For this example, we'll use `12h`.
|
||||
3. In the **Every Window Period** field, enter a value. For this example, we'll use `3h30s`, but any duration is supported by InfluxDB Cloud. For more information, see [duration literals](/{{< latest "flux" >}}/spec/lexical-elements/#duration-literals).
|
||||
4. Click **Preview** to view the downsampled data.
|
||||
|
||||
## Output to a new bucket and export as a task
|
||||
### Monitor data
|
||||
|
||||
Get notifications every time your data crosses a threshold. Specify your alerts by time and decide how the information will be sent to you.
|
||||
|
||||
1. In your notebook, click **{{< icon "plus" >}}** to add a cell, then select **Output > Alert**.
|
||||
2. Customize the conditions to send an alert.
|
||||
3. Enter a time range to automatically check the data and enter your query offset.
|
||||
4. Select an endpoint to receive an alert:
|
||||
- Slack and a Slack Channel
|
||||
- HTTP post
|
||||
- Pager Duty
|
||||
5. (Optional) Personalize your message. By default, the message is “${strings.title(v: r._type)} for ${r._source_measurement} triggered at ${time(v: r._source_timestamp)}!”
|
||||
6. Click **Export as Alert Task** to save your alarm.
|
||||
|
||||
### Output to a new bucket and export as a task
|
||||
|
||||
After processing, send the downsampled data to a new bucket to store and view it. You can write it to the bucket a single time, or export it as a task, which is a scheduled Flux script, for it write to the bucket continuously.
|
||||
|
||||
1. Click **+** to add a cell, then select an **Output to Bucket** cell.
|
||||
2. In the **Choose a bucket** dropdown, choose **+Create a Bucket**.
|
||||
3. Enter a name for your bucket, such as Website monitoring downsampled, and click **Create**.
|
||||
3. Enter a name for your bucket and click **Create**.
|
||||
4. Click **Run** from the **Preview** dropdown list to run the notebook and write to the output bucket a single time.
|
||||
5. To write continuously, click **Export as Task** in the upper right corner of the **Output to Bucket** cell. For details about working with tasks, see [Manage tasks](/influxdb/cloud/process-data/manage-tasks/).
|
||||
|
||||
|
|
|
@ -0,0 +1,68 @@
|
|||
---
|
||||
title: Query demo data
|
||||
description: >
|
||||
Explore InfluxDB Cloud with our demo data buckets.
|
||||
menu:
|
||||
influxdb_cloud:
|
||||
name: Query with demo data
|
||||
parent: Execute queries
|
||||
weight: 10
|
||||
aliases:
|
||||
- /influxdb/cloud/write-data/#demo-data-for-influxdb-cloud
|
||||
- influxdb/cloud/query-data/query-demo-data/
|
||||
---
|
||||
|
||||
Use **InfluxDB Cloud** demo data buckets for quick and easy access to different
|
||||
types of demo data that let you explore and familiarize yourself with InfluxDB Cloud.
|
||||
|
||||
{{< youtube GSaByPC1Bdc >}}
|
||||
|
||||
- [Add a demo data bucket](#add-a-demo-data-bucket)
|
||||
- [Explore demo data](#explore-demo-data)
|
||||
- [View demo data dashboards](#view-demo-data-dashboards)
|
||||
|
||||
{{% note %}}
|
||||
#### Free to use and read-only
|
||||
- InfluxDB Cloud demo data buckets are **free to use** and are **_not_ subject to
|
||||
[Free Plan](/influxdb/cloud/account-management/pricing-plans/#free-plan) rate limits**.
|
||||
- Demo data buckets are **read-only**. You cannot write data into demo data buckets.
|
||||
{{% /note %}}
|
||||
|
||||
## Demo data sets
|
||||
Choose from the following demo data sets:
|
||||
|
||||
- **Website Monitoring**
|
||||
Explore, visualize, and monitor HTTP response metrics from InfluxData websites.
|
||||
|
||||
|
||||
## Add a demo data bucket
|
||||
1. In the navigation menu on the left, click **Data (Load Data)** > **Buckets**.
|
||||
|
||||
{{< nav-icon "data" >}}
|
||||
|
||||
2. Click **{{< icon "plus" >}} Add Demo Data**, and then select the demo data bucket to add.
|
||||
3. The Demo Data bucket appears in your list of buckets.
|
||||
|
||||
## Explore demo data
|
||||
Use the [Data Explorer](/influxdb/cloud/visualize-data/explore-metrics/)
|
||||
to query and visualize data in demo data buckets.
|
||||
|
||||
In the navigation menu on the left, click **Explore (Data Explorer)**.
|
||||
|
||||
{{< nav-icon "explore" >}}
|
||||
|
||||
## View demo data dashboards
|
||||
After adding a demo data bucket, view the pre-built dashboard specific to the demo data set:
|
||||
|
||||
1. In the navigation menu on the left, click **Boards (Dashboards)**.
|
||||
|
||||
{{< nav-icon "dashboards" >}}
|
||||
|
||||
2. Click the name of the dashboard that corresponds to your demo data bucket.
|
||||
|
||||
{{% note %}}
|
||||
#### Other sample data sets
|
||||
See [Sample data](/influxdb/cloud/reference/sample-data) for more sample InfluxDB data sets.
|
||||
{{% /note %}}
|
||||
|
||||
|
|
@ -0,0 +1,89 @@
|
|||
---
|
||||
title: Query sample data
|
||||
description: >
|
||||
Explore InfluxDB Cloud with our sample data buckets.
|
||||
menu:
|
||||
influxdb_cloud:
|
||||
name: Query with sample data
|
||||
parent: Execute queries
|
||||
weight: 10
|
||||
---
|
||||
|
||||
Use **InfluxDB Cloud** sample datasets to quickly access data that lets you explore and familiarize yourself with InfluxDB Cloud without requiring you to have or write your own data.
|
||||
|
||||
- [Choose sample data](#choose-sample-data)
|
||||
- [Explore sample data](#explore-sample-data)
|
||||
- [create sample data dashboards](#create-sample-data-dashboards)
|
||||
|
||||
{{% note %}}
|
||||
#### Network bandwidth
|
||||
|
||||
Each execution of `sample.data()` downloads the specified dataset from **Amazon S3**.
|
||||
If using [InfluxDB Cloud](/influxdb/cloud/) or a hosted InfluxDB OSS instance,
|
||||
you may see additional network bandwidth costs when using this function.
|
||||
Approximate sample dataset sizes are listed for each [sample dataset](/influxdb/cloud/reference/sample-data/#sample-datasets) and in the output of [`sample.list()`](/influxdb/v2.0/reference/flux/stdlib/influxdb-sample/list/). To explore data without incurring network bandwidth costs, see how to [query demo data](/influxdb/cloud/query-data/execute-queries/query-demo-data/).
|
||||
{{% /note %}}
|
||||
|
||||
## Choose sample data
|
||||
|
||||
1. Choose from the following sample datasets:
|
||||
- **Air sensor sample data**: Explore, visualize, and monitor humidity, temperature, and carbon monoxide levels in the air.
|
||||
- **Bird migration sample data**: Explore, visualize, and monitor the latitude and longitude of bird migration patterns.
|
||||
- **NOAA NDBC sample data**: Explore, visualize, and monitor NDBC's observations from their buoys. This data observes air temperature, wind speed, and more from specific locations.
|
||||
- **NOAA water sample data**: Explore, visualize, and monitor temperature, water level, pH, and quality from specific locations.
|
||||
- **USGS Earthquake data**: Explore, visualize, and monitor earthquake monitoring data. This data includes alerts, cdi, quarry blast, magnitide, and more.
|
||||
2. Do one of the following to download sample data:
|
||||
- [Add sample data with community template](#add-sample-data-with-community-templates)
|
||||
- [Add sample data using the InfluxDB UI](#add-sample-data)
|
||||
|
||||
### Add sample data with community template
|
||||
|
||||
1. Visit the **InfluxDB templates page** in the InfluxDB Cloud UI. Click **Settings** > **Templates** in the navigation menu on the left.
|
||||
|
||||
{{< nav-icon "settings" >}}
|
||||
|
||||
2. Paste the Sample Data community temple URL in **resource manifest file** field:
|
||||
|
||||
```
|
||||
https://github.com/influxdata/community-templates/blob/master/sample-data/sample-data.yml
|
||||
```
|
||||
|
||||
## Explore sample data
|
||||
Use the [Data Explorer](/influxdb/cloud/visualize-data/explore-metrics/)
|
||||
to query and visualize data in sample data buckets.
|
||||
|
||||
In the navigation menu on the left, click **Explore (Data Explorer)**.
|
||||
|
||||
{{< nav-icon "explore" >}}
|
||||
|
||||
### Add sample data
|
||||
|
||||
1. In the navigation menu on the left, click **Data (Load Data)** > **Buckets**.
|
||||
|
||||
{{< nav-icon "data" >}}
|
||||
|
||||
2. Click **{{< icon "plus" >}} Create bucket**, and then name your bucket. The bucket will appear in your list of buckets.
|
||||
3. View the [sample datasets document](/influxdb/cloud/reference/sample-data/#sample-datasets) and choose a sample data to query.
|
||||
4. Copy the `sample.data()` function listed underneath.
|
||||
5. Click **Explore** on the left navigation of InfluxDB Cloud and click your bucket, and then click **Script Editor**.
|
||||
6. Paste the `sample.data()` function.
|
||||
7. Click **Submit** to run the query.
|
||||
|
||||
For more information about querying in the Script Editor, see how to [Query data with Flux and the Data Explorer](/influxdb/cloud/query-data/execute-queries/data-explorer/#query-data-with-flux-and-the-data-explorer).
|
||||
|
||||
## Create sample data dashboards
|
||||
|
||||
After adding a sample data bucket, create a dashboard specific to the sample dataset:
|
||||
|
||||
1. Click **Boards (Dashboards)** in the navigation menu on the left.
|
||||
|
||||
{{< nav-icon "dashboards" >}}
|
||||
|
||||
2. Click **Create Dashboard > New Dashboard**, and name the dashboard after your bucket.
|
||||
3. Click **Add Cell**, and select your sample data bucket.
|
||||
4. Click **Script Editor**.
|
||||
5. Copy and paste the `sample.data()` function into the script editor.
|
||||
6. Click **Submit** to run the query.
|
||||
6. Define the variables of your sample data.
|
||||
|
||||
|
|
@ -0,0 +1,65 @@
|
|||
---
|
||||
title: Query demo data
|
||||
description: >
|
||||
Explore InfluxDB Cloud with our demo data buckets.
|
||||
menu:
|
||||
influxdb_cloud:
|
||||
name: Query with demo data
|
||||
parent: Execute queries
|
||||
weight: 10
|
||||
aliases:
|
||||
- /influxdb/cloud/write-data/#demo-data-for-influxdb-cloud
|
||||
---
|
||||
|
||||
Use **InfluxDB Cloud** demo data buckets for quick and easy access to different
|
||||
types of demo data that let you explore and familiarize yourself with InfluxDB Cloud.
|
||||
|
||||
{{< youtube GSaByPC1Bdc >}}
|
||||
|
||||
- [Add a demo data bucket](#add-a-demo-data-bucket)
|
||||
- [Explore demo data](#explore-demo-data)
|
||||
- [View demo data dashboards](#view-demo-data-dashboards)
|
||||
|
||||
{{% note %}}
|
||||
#### Free to use and read-only
|
||||
- InfluxDB Cloud demo data buckets are **free to use** and are **_not_ subject to
|
||||
[Free Plan](/influxdb/cloud/account-management/pricing-plans/#free-plan) rate limits**.
|
||||
- Demo data buckets are **read-only**. You cannot write data into demo data buckets.
|
||||
{{% /note %}}
|
||||
|
||||
## Demo data sets
|
||||
Choose from the following demo data sets:
|
||||
|
||||
- **Website Monitoring**
|
||||
Explore, visualize, and monitor HTTP response metrics from InfluxData websites.
|
||||
|
||||
|
||||
## Add a demo data bucket
|
||||
1. In the navigation menu on the left, click **Data (Load Data)** > **Buckets**.
|
||||
|
||||
{{< nav-icon "data" >}}
|
||||
|
||||
2. Click **{{< icon "plus" >}} Add Demo Data**, and then select the demo data bucket to add.
|
||||
3. The Demo Data bucket appears in your list of buckets.
|
||||
|
||||
## Explore demo data
|
||||
Use the [Data Explorer](/influxdb/cloud/visualize-data/explore-metrics/)
|
||||
to query and visualize data in demo data buckets.
|
||||
|
||||
In the navigation menu on the left, click **Explore (Data Explorer)**.
|
||||
|
||||
{{< nav-icon "explore" >}}
|
||||
|
||||
## View demo data dashboards
|
||||
After adding a demo data bucket, view the pre-built dashboard specific to the demo data set:
|
||||
|
||||
1. In the navigation menu on the left, click **Boards (Dashboards)**.
|
||||
|
||||
{{< nav-icon "dashboards" >}}
|
||||
|
||||
2. Click the name of the dashboard that corresponds to your demo data bucket.
|
||||
|
||||
{{% note %}}
|
||||
#### Other sample data sets
|
||||
See [Sample data](/influxdb/cloud/reference/sample-data) for more sample InfluxDB data sets.
|
||||
{{% /note %}}
|
|
@ -11,32 +11,32 @@ weight: 7
|
|||
---
|
||||
|
||||
Use **demo data** and **sample data** to familiarize yourself with time series data and InfluxDB Cloud.
|
||||
InfluxDB Cloud lets you access **Demo data buckets** that contain real-time time
|
||||
InfluxDB Cloud lets you access **Demo data buckets** and **Sample datasets** that contain time
|
||||
series data without having to write data to InfluxDB.
|
||||
Sample datasets are also available for download and can be written to InfluxDB
|
||||
or loaded at query time.
|
||||
|
||||
- [InfluxDB Cloud demo data](#influxdb-cloud-demo-data)
|
||||
- [Sample datasets](#sample-datasets)
|
||||
|
||||
## InfluxDB Cloud demo data
|
||||
Use [InfluxDB Cloud demo data buckets](/influxdb/cloud/reference/sample-data/#influxdb-cloud-demo-data) for quick,
|
||||
free access to different time series datasets.
|
||||
|
||||
{{< youtube GSaByPC1Bdc >}}
|
||||
The sample data below contains both static and live datasets. A static sample dataset is not updated regularly and has fixed timestamps. A "live" sample dataset is updated regularly.
|
||||
|
||||
{{% note %}}
|
||||
Demo data is not available for use with third-party integrations such as Grafana.
|
||||
If writing a static sample dataset to a bucket with a limited retention period, use [sample.alignToNow()](/{{< latest "flux" >}}/stdlib/influxdata/influxdb/sample/aligntonow/) to shift timestamps to align the last point in the set to now. This will prevent writing points with timestamps beyond the bucket's retention period.
|
||||
{{% /note %}}
|
||||
|
||||
- [Sample datasets](#sample-datasets)
|
||||
- [InfluxDB Cloud demo data](#influxdb-cloud-demo-data)
|
||||
|
||||
## Sample datasets
|
||||
|
||||
- [Air sensor sample data](#air-sensor-sample-data)
|
||||
- [Bird migration sample data](#bird-migration-sample-data)
|
||||
- [NOAA sample data](#noaa-sample-data)
|
||||
- [NOAA NDBC data](#noaa-ndbc-data)
|
||||
- [NOAA water sample data](#noaa-water-sample-data)
|
||||
- [USGS Earthquake data](#usgs-earthquake-data)
|
||||
Do one of the following:
|
||||
|
||||
- Run the sample data query in the **Script Editor** found in **Explore** from the left-hand navigation bar:
|
||||
- [Air sensor sample data](#air-sensor-sample-data)
|
||||
- [Bird migration sample data](#bird-migration-sample-data)
|
||||
- [NOAA sample data](#noaa-sample-data)
|
||||
- [NOAA NDBC data](#noaa-ndbc-data)
|
||||
- [NOAA water sample data](#noaa-water-sample-data)
|
||||
- [USGS Earthquake data](#usgs-earthquake-data)
|
||||
- [Write sample data with InfluxDB task](#write-sample-data-with-influxdb-task)
|
||||
|
||||
### Air sensor sample data
|
||||
|
||||
|
@ -183,3 +183,29 @@ import "influxdata/influxdb/sample"
|
|||
|
||||
sample.data(set: "usgs")
|
||||
```
|
||||
|
||||
### Write sample data with an InfluxDB task
|
||||
|
||||
Use the [Flux InfluxDB sample package](/{{< latest "flux" >}}/stdlib/influxdata/influxdb/sample/) to download and write sample data to InfluxDB.
|
||||
|
||||
Add the following as an [InfluxDB task](/influxdb/cloud/process-data/manage-tasks/create-task/).
|
||||
|
||||
```js
|
||||
import "influxdata/influxdb/sample"
|
||||
option task = {
|
||||
name: "Collect NOAA NDBC data"
|
||||
every: 15m,
|
||||
}
|
||||
sample.data(set: "noaa")
|
||||
|> to(bucket: "noaa" )
|
||||
```
|
||||
|
||||
## InfluxDB Cloud demo data
|
||||
Use [InfluxDB Cloud demo data buckets](/influxdb/cloud/reference/sample-data/#influxdb-cloud-demo-data) for quick,
|
||||
free access to different time series datasets.
|
||||
|
||||
{{< youtube GSaByPC1Bdc >}}
|
||||
|
||||
{{% note %}}
|
||||
Demo data is not available for use with third-party integrations such as Grafana.
|
||||
{{% /note %}}
|
|
@ -12,160 +12,23 @@ menu:
|
|||
name: Write data
|
||||
influxdb/cloud/tags: [write, line protocol]
|
||||
related:
|
||||
- /influxdb/cloud/write-data/no-code/use-telegraf/
|
||||
- /influxdb/cloud/api/#tag/Write, InfluxDB API /write endpoint
|
||||
- /influxdb/cloud/reference/syntax/line-protocol
|
||||
- /influxdb/cloud/reference/syntax/annotated-csv
|
||||
- /influxdb/cloud/reference/cli/influx/write
|
||||
---
|
||||
|
||||
Discover what you'll need to write data into InfluxDB Cloud. Learn how to quickly start collecting data, and then explore ways to write data, best practices, and what we recommend if you're migrating a large amount of historical data.
|
||||
|
||||
- [What you'll need](#what-youll-need)
|
||||
- [Quickly start collecting data](#quickly-start-collecting-data)
|
||||
- [Demo data for InfluxDB Cloud](#demo-data-for-influxdb-cloud)
|
||||
- [Sample data](#sample-data)
|
||||
- [Load data from sources in the InfluxDB UI](/influxdb/cloud/write-data/no-code/load-data/)
|
||||
- [Use no-code solutions](/influxdb/cloud/write-data/no-code)
|
||||
- [Use developer tools](/influxdb/cloud/write-data/developer-tools)
|
||||
- [Best practices for writing data](/influxdb/cloud/write-data/best-practices/)
|
||||
- [Next steps](#next-steps)
|
||||
|
||||
### What you'll need
|
||||
|
||||
To write data into InfluxDB, you need the following:
|
||||
|
||||
- **organization** – _See [View organizations](/influxdb/cloud/organizations/view-orgs/#view-your-organization-id)
|
||||
for instructions on viewing your organization ID._
|
||||
- **bucket** – _See [View buckets](/influxdb/cloud/organizations/buckets/view-buckets/) for
|
||||
instructions on viewing your bucket ID._
|
||||
- **API token** – _See [View tokens](/influxdb/cloud/security/tokens/view-tokens/)
|
||||
for instructions on viewing your API token._
|
||||
- **InfluxDB Cloud region URL** – _See [InfluxDB Cloud regions](/influxdb/cloud/reference/regions/)_.
|
||||
|
||||
Use _line protocol_ format to write data into InfluxDB.
|
||||
Each line represents a data point.
|
||||
Each point requires a [*measurement*](/influxdb/cloud/reference/syntax/line-protocol/#measurement)
|
||||
and [*field set*](/influxdb/cloud/reference/syntax/line-protocol/#field-set) and may also include
|
||||
a [*tag set*](/influxdb/cloud/reference/syntax/line-protocol/#tag-set) and a [*timestamp*](/influxdb/cloud/reference/syntax/line-protocol/#timestamp).
|
||||
|
||||
Line protocol data looks like this:
|
||||
|
||||
```sh
|
||||
mem,host=host1 used_percent=23.43234543 1556892576842902000
|
||||
cpu,host=host1 usage_user=3.8234,usage_system=4.23874 1556892726597397000
|
||||
mem,host=host1 used_percent=21.83599203 1556892777007291000
|
||||
```
|
||||
|
||||
#### Timestamp precision
|
||||
|
||||
When writing data to InfluxDB, we [recommend including a timestamp](/influxdb/cloud/reference/syntax/line-protocol/#timestamp) with each point.
|
||||
If a data point does not include a timestamp when it is received by the database,
|
||||
InfluxDB uses the current system time (UTC) of its host machine.
|
||||
|
||||
The default precision for timestamps is in nanoseconds.
|
||||
If the precision of the timestamps is anything other than nanoseconds (`ns`),
|
||||
you must **specify the precision in your write request**.
|
||||
InfluxDB accepts the following precisions:
|
||||
|
||||
- `ns` - Nanoseconds
|
||||
- `us` - Microseconds
|
||||
- `ms` - Milliseconds
|
||||
- `s` - Seconds
|
||||
|
||||
_For more details about line protocol, see the [Line protocol reference](/influxdb/cloud/reference/syntax/line-protocol)
|
||||
and [Best practices for writing data](/influxdb/cloud/write-data/best-practices/)._
|
||||
|
||||
## Quickly start collecting data
|
||||
|
||||
Familiarize yourself with querying, visualizing, and processing data in InfluxDB Cloud by collecting data right away. The following options are available:
|
||||
|
||||
- [Demo data for InfluxDB Cloud](#demo-data-for-influxdb-cloud)
|
||||
- [Sample data](#sample-data)
|
||||
|
||||
## Demo data for InfluxDB Cloud
|
||||
Use **InfluxDB Cloud** demo data buckets for quick and easy access to different
|
||||
types of demo data that let you explore and familiarize yourself with InfluxDB Cloud.
|
||||
|
||||
{{< youtube GSaByPC1Bdc >}}
|
||||
|
||||
- [Add a demo data bucket](#add-a-demo-data-bucket)
|
||||
- [Explore demo data](#explore-demo-data)
|
||||
- [View demo data dashboards](#view-demo-data-dashboards)
|
||||
|
||||
{{% note %}}
|
||||
#### Free to use and read-only
|
||||
- InfluxDB Cloud demo data buckets are **free to use** and are **_not_ subject to
|
||||
[Free Plan](/influxdb/cloud/account-management/pricing-plans/#free-plan) rate limits**.
|
||||
- Demo data buckets are **read-only**. You cannot write data into demo data buckets.
|
||||
To explore InfluxDB using existing data (*without writing your own data*), see how to [add sample data](/influxdb/cloud/query-data/execute-queries/query-sample-data/#add-sample) or [add a demo data bucket](/influxdb/cloud/query-data/execute-queries/query-demo-data/#add-a-demo-data-bucket).
|
||||
{{% /note %}}
|
||||
|
||||
## Demo data sets
|
||||
Choose from the following demo data sets:
|
||||
|
||||
- **Website Monitoring**
|
||||
Explore, visualize, and monitor HTTP response metrics from InfluxData websites.
|
||||
|
||||
|
||||
## Add a demo data bucket
|
||||
1. In the navigation menu on the left, click **Data (Load Data)** > **Buckets**.
|
||||
|
||||
{{< nav-icon "data" >}}
|
||||
|
||||
2. Click **{{< icon "plus" >}} Add Demo Data**, and then select the demo data bucket to add.
|
||||
3. The Demo Data bucket appears in your list of buckets.
|
||||
|
||||
## Explore demo data
|
||||
Use the [Data Explorer](/influxdb/cloud/visualize-data/explore-metrics/)
|
||||
to query and visualize data in demo data buckets.
|
||||
|
||||
In the navigation menu on the left, click **Explore (Data Explorer)**.
|
||||
|
||||
{{< nav-icon "explore" >}}
|
||||
|
||||
## View demo data dashboards
|
||||
After adding a demo data bucket, view the pre-built dashboard specific to the demo data set:
|
||||
|
||||
1. In the navigation menu on the left, click **Boards (Dashboards)**.
|
||||
|
||||
{{< nav-icon "dashboards" >}}
|
||||
|
||||
2. Click the name of the dashboard that corresponds to your demo data bucket.
|
||||
|
||||
{{% note %}}
|
||||
#### Other sample data sets
|
||||
See [Sample data](/influxdb/cloud/reference/sample-data) for more sample InfluxDB data sets.
|
||||
{{% /note %}}
|
||||
|
||||
## Sample data
|
||||
Use [sample data sets](/influxdb/cloud/reference/sample-data/#sample-datasets)
|
||||
to quickly populate InfluxDB with sample time series data.
|
||||
|
||||
---
|
||||
|
||||
## Other ways to write data
|
||||
|
||||
There are multiple options for writing data into InfluxDB, including both no-code and developer solutions.
|
||||
|
||||
- [No-code solutions](/influxdb/cloud/write-data/no-code)
|
||||
- [Developer tools](/influxdb/cloud/write-data/developer-tools)
|
||||
|
||||
---
|
||||
|
||||
## Next steps
|
||||
With your data in InfluxDB, you're ready to do one or more of the following:
|
||||
|
||||
### Query and explore your data
|
||||
Query data using Flux, the UI, and the `influx` command line interface.
|
||||
See [Query data](/influxdb/cloud/query-data/).
|
||||
|
||||
### Process your data
|
||||
Use InfluxDB tasks to process and downsample data. See [Process data](/influxdb/cloud/process-data/).
|
||||
|
||||
### Visualize your data
|
||||
Build custom dashboards to visualize your data.
|
||||
See [Visualize data](/influxdb/cloud/visualize-data/).
|
||||
|
||||
### Monitor your data and send alerts
|
||||
Monitor your data and sends alerts based on specified logic.
|
||||
See [Monitor and alert](/influxdb/cloud/monitor-alert/).
|
||||
1. Learn the [best practices](/influxdb/cloud/write-data/best-practices/) for writing data.
|
||||
2. (Optional) Migrate a large amount of historical data, by [writing data in bulk](/influxdb/cloud/write-data/bulk-ingest-cloud/).
|
||||
3. Discover how to write data [without coding](/influxdb/cloud/write-data/no-code), by [loading data source in the UI](/influxdb/cloud/write-data/load-data/), or using [developer tools](/influxdb/cloud/write-data/developer-tools).
|
||||
4. Do any of the following:
|
||||
- [Troubleshoot the most common issues writing data](/influxdb/cloud/write-data/troubleshoot/)
|
||||
- [Delete data you no longer need](/influxdb/cloud/write-data/delete-data/)
|
||||
- [Query and explore data](/influxdb/cloud/query-data/)
|
||||
- [Process data](/influxdb/cloud/process-data/)
|
||||
- [Visualize data](/influxdb/cloud/visualize-data/)
|
||||
- [Monitor and alert](/influxdb/cloud/monitor-alert/)
|
||||
|
|
|
@ -14,27 +14,9 @@ related:
|
|||
|
||||
Use line protocol to write data to InfluxDB Cloud. Line protocol is a text-based format that provides the measurement, tag set, field set, and timestamp of a data point. Learn more about [line protocol](/influxdb/v2.0/reference/syntax/line-protocol/).
|
||||
|
||||
Write data using line protocol with the following methods:
|
||||
- [UI](#write-line-protocol-with-ui)
|
||||
- [Influx write command](#influx-write-command)
|
||||
|
||||
## Write line protocol with UI
|
||||
|
||||
To write data using Cloud's line protocol file upload, do the following:
|
||||
|
||||
1. Verify the line protocol adheres to the following conventions:
|
||||
- Each line represents a data point.
|
||||
- Each data point requires a:
|
||||
- [*measurement*](/influxdb/cloud/reference/syntax/line-protocol/#measurement)
|
||||
- [*field set*](/influxdb/cloud/reference/syntax/line-protocol/#field-set)
|
||||
- (Optional) [*tag set*](/influxdb/cloud/reference/syntax/line-protocol/#tag-set)
|
||||
- [*timestamp*](/influxdb/cloud/reference/syntax/line-protocol/#timestamp)
|
||||
2. Click **Data** in your left navigation bar.
|
||||
3. Select **Line Protocol** and choose your bucket.
|
||||
4. Select your **Precision** in the dropdown menu. By default, the precision is set to nanoseconds.
|
||||
5. Do one of the following:
|
||||
- Upload your line protocol file.
|
||||
- Write your line protocol manually, and then click **Submit**.
|
||||
Write data using line protocol with the following methods:
|
||||
- [Upload a file or manually paste data in the UI](/influxdb/cloud/write-data/no-code/load-data/#load-csv-or-line-protocol-in-ui)
|
||||
- [Use influx write command](#influx-write-command)
|
||||
|
||||
## Write line protocol using the influx write command
|
||||
|
||||
|
@ -130,6 +112,7 @@ influx write \
|
|||
influx write \
|
||||
--bucket example-bucket \
|
||||
--file path/to/line-protocol.txt.gz
|
||||
|
||||
# Specify gzip compression for gzipped files without the .gz extension
|
||||
influx write \
|
||||
--bucket example-bucket \
|
||||
|
@ -153,5 +136,5 @@ InfluxDB accepts the following precisions:
|
|||
- `ms` - Milliseconds
|
||||
- `s` - Seconds
|
||||
|
||||
_For more details about line protocol, see the [Line protocol reference](/influxdb/cloud/reference/syntax/line-protocol)
|
||||
and [Best practices for writing data](/influxdb/cloud/write-data/best-practices/)._
|
||||
_For more details about line protocol, see the [Line protocol reference](/influxdb/cloud/reference/syntax/line-protocol) and [Best practices for writing data](/influxdb/cloud/write-data/best-practices/)._
|
||||
|
||||
|
|
|
@ -31,15 +31,15 @@ The [template](https://influxdata-lambda.s3.amazonaws.com/GeoLambda.yml) contain
|
|||
2. Click **Create Stack**.
|
||||
3. In the **Prerequisite - Prepare Template** section, select **Template is ready**.
|
||||
4. In the **Specify template** section:
|
||||
- Under **Template source**, select **Amazon S3 URL**.
|
||||
- In the **Amazon S3 URL** field, enter the CloudFormation template URL: `https://influxdata-lambda.s3.amazonaws.com/GeoLambda.yml`
|
||||
- Under **Template source**, select **Amazon S3 URL**.
|
||||
- In the **Amazon S3 URL** field, enter the CloudFormation template URL: `https://influxdata-lambda.s3.amazonaws.com/GeoLambda.yml`
|
||||
5. Click **Next**.
|
||||
6. Enter a name in the **Stack name** field.
|
||||
7. Enter the following InfluxDB details:
|
||||
- Organization ID
|
||||
- Bucket ID of the bucket the Lambda writes to
|
||||
- Token with permission to write to the bucket
|
||||
- InfluxDB URL
|
||||
- Organization ID
|
||||
- Bucket ID of the bucket the Lambda writes to
|
||||
- Token with permission to write to the bucket
|
||||
- InfluxDB URL
|
||||
8. Do not alter or add to any other fields. Click **Next**.
|
||||
9. Select the **I acknowledge that AWS CloudFormation might create IAM resources** check box.
|
||||
10. Click **Create Stack**.
|
||||
|
|
|
@ -2,7 +2,7 @@
|
|||
title: Load data from sources in the InfluxDB user interface (UI)
|
||||
seotitle: Load data source in UI
|
||||
list_title: Load data source in UI
|
||||
weight: 105
|
||||
weight: 101
|
||||
description: >
|
||||
Load data from sources in the InfluxDB user interface (UI). Choose from popular client libraries (such as Python, Ruby, Scala, and more!) or load data with a Telegraf plugin (like MQTT Consumer, MySQL, File, and many more!).
|
||||
menu:
|
||||
|
|
|
@ -14,25 +14,21 @@ A number of third-party technologies can be configured to send line protocol dir
|
|||
|
||||
If you're using any of the following technologies, check out the handy links below to configure these technologies to write data to InfluxDB (**no additional software to download or install**):
|
||||
|
||||
- (Write metrics and log events only) [Vector 0.9 or later](#configure-vector)
|
||||
|
||||
- [Apache NiFi 1.8 or later](#configure-apache-nifi)
|
||||
|
||||
- [OpenHAB 3.0 or later](#configure-openhab)
|
||||
|
||||
- [Apache JMeter 5.2 or later](#configure-apache-jmeter)
|
||||
|
||||
- [FluentD 1.x or later](#configure-fluentd)
|
||||
- (Write metrics and log events only) [Configure Vector 0.9 or later](#configure-vector)
|
||||
- [Configure Apache NiFi 1.8 or later](#configure-apache-nifi)
|
||||
- [Configure OpenHAB 3.0 or later](#configure-openhab)
|
||||
- [Configure Apache JMeter 5.2 or later](#configure-apache-jmeter)
|
||||
- [Configure FluentD 1.x or later](#configure-fluentd)
|
||||
|
||||
#### Configure Vector
|
||||
|
||||
1. View the **Vector documentation**:
|
||||
- For write metrics, [InfluxDB Metrics Sink](https://vector.dev/docs/reference/sinks/influxdb_metrics/)
|
||||
- For log events, [InfluxDB Logs Sink](https://vector.dev/docs/reference/sinks/influxdb_logs/)
|
||||
- For write metrics, [InfluxDB Metrics Sink](https://vector.dev/docs/reference/sinks/influxdb_metrics/)
|
||||
- For log events, [InfluxDB Logs Sink](https://vector.dev/docs/reference/sinks/influxdb_logs/)
|
||||
2. Under **Configuration**, click **v2** to view configuration settings.
|
||||
3. Scroll down to **How It Works** for more detail:
|
||||
- [InfluxDB Metrics Sink – How It Works ](https://vector.dev/docs/reference/sinks/influxdb_metrics/#how-it-works)
|
||||
- [InfluxDB Logs Sink – How It Works](https://vector.dev/docs/reference/sinks/influxdb_logs/#how-it-works)
|
||||
- [InfluxDB Metrics Sink – How It Works ](https://vector.dev/docs/reference/sinks/influxdb_metrics/#how-it-works)
|
||||
- [InfluxDB Logs Sink – How It Works](https://vector.dev/docs/reference/sinks/influxdb_logs/#how-it-works)
|
||||
|
||||
#### Configure Apache NiFi
|
||||
|
||||
|
|
|
@ -0,0 +1,89 @@
|
|||
---
|
||||
title: Query sample data
|
||||
description: >
|
||||
Explore InfluxDB OSS with our sample data buckets.
|
||||
menu:
|
||||
influxdb_2_0::
|
||||
name: Query with sample data
|
||||
parent: Execute queries
|
||||
weight: 10
|
||||
---
|
||||
|
||||
Use **InfluxDB OSS** sample datasets to quickly access data that lets you explore and familiarize yourself with InfluxDB Cloud without requiring you to have or write your own data.
|
||||
|
||||
- [Choose sample data](#choose-sample-data)
|
||||
- [Explore sample data](#explore-sample-data)
|
||||
- [Create sample data dashboards](#create-sample-data-dashboards)
|
||||
|
||||
{{% note %}}
|
||||
#### Network bandwidth
|
||||
|
||||
Each execution of `sample.data()` downloads the specified dataset from **Amazon S3**.
|
||||
If using [InfluxDB Cloud](/influxdb/cloud/) or a hosted InfluxDB OSS instance,
|
||||
you may see additional network bandwidth costs when using this function.
|
||||
Approximate sample dataset sizes are listed for each [sample dataset](/influxdb/2.0/reference/sample-data/#sample-datasets) and in the output of [`sample.list()`](/influxdb/v2.0/reference/flux/stdlib/influxdb-sample/list/).
|
||||
|
||||
If you also want to explore Cloud, we offer a way to explore data without incurring network bandwidth costs, using [demo data](/influxdb/cloud/query-data/execute-queries/query-demo-data/).
|
||||
{{% /note %}}
|
||||
|
||||
## Choose sample data
|
||||
|
||||
1. Choose from the following sample datasets:
|
||||
- **Air sensor sample data**: Explore, visualize, and monitor humidity, temperature, and carbon monoxide levels in the air.
|
||||
- **Bird migration sample data**: Explore, visualize, and monitor the latitude and longitude of bird migration patterns.
|
||||
- **NOAA NDBC sample data**: Explore, visualize, and monitor NDBC's observations from their buoys. This data observes air temperature, wind speed, and more from specific locations.
|
||||
- **NOAA water sample data**: Explore, visualize, and monitor temperature, water level, pH, and quality from specific locations.
|
||||
- **USGS Earthquake data**: Explore, visualize, and monitor earthquake monitoring data. This data includes alerts, cdi, quarry blast, magnitide, and more.
|
||||
2. Do one of the following to download sample data:
|
||||
- [Add sample data with community template](#add-sample-data-with-community-templates)
|
||||
- [Add sample data using the InfluxDB UI](#add-sample-data)
|
||||
|
||||
### Add sample data with community template
|
||||
|
||||
1. Visit the **InfluxDB templates page** in the InfluxDB OSS UI. Click **Settings** > **Templates** in the navigation menu on the left.
|
||||
|
||||
{{< nav-icon "settings" >}}
|
||||
|
||||
2. Paste the Sample Data community temple URL in **resource manifest file** field:
|
||||
|
||||
```
|
||||
https://github.com/influxdata/community-templates/blob/master/sample-data/sample-data.yml
|
||||
```
|
||||
|
||||
## Explore sample data
|
||||
Use the [Data Explorer](/influxdb/cloud/visualize-data/explore-metrics/)
|
||||
to query and visualize data in sample data buckets.
|
||||
|
||||
In the navigation menu on the left, click **Explore (Data Explorer)**.
|
||||
|
||||
{{< nav-icon "explore" >}}
|
||||
|
||||
### Add sample data
|
||||
|
||||
1. In the navigation menu on the left, click **Data (Load Data)** > **Buckets**.
|
||||
|
||||
{{< nav-icon "data" >}}
|
||||
|
||||
2. Click **{{< icon "plus" >}} Create bucket**, and then name your bucket. The bucket will appear in your list of buckets.
|
||||
3. View the [sample datasets document](/influxdb/cloud/reference/sample-data/#sample-datasets) and choose a sample data to query.
|
||||
4. Copy the `sample.data()` function listed underneath.
|
||||
5. Click **Explore** on the left navigation of InfluxDB Cloud and click your bucket, and then click **Script Editor**.
|
||||
6. Paste the `sample.data()` function.
|
||||
7. Click **Submit** to run the query.
|
||||
|
||||
For more information about querying in the Script Editor, see how to [Query data with Flux and the Data Explorer](/influxdb/cloud/query-data/execute-queries/data-explorer/#query-data-with-flux-and-the-data-explorer).
|
||||
|
||||
## Create sample data dashboards
|
||||
|
||||
After adding a sample data bucket, create a dashboard specific to the sample dataset:
|
||||
|
||||
1. Click **Boards (Dashboards)** in the navigation menu on the left.
|
||||
|
||||
{{< nav-icon "dashboards" >}}
|
||||
|
||||
2. Click **Create Dashboard > New Dashboard**, and name the dashboard after your bucket.
|
||||
3. Click **Add Cell**, and select your sample data bucket.
|
||||
4. Click **Script Editor**.
|
||||
5. Copy and paste the `sample.data()` function into the script editor.
|
||||
6. Click **Submit** to run the query.
|
||||
6. Define the variables of your sample data.
|
|
@ -2,8 +2,8 @@
|
|||
title: Annotated CSV
|
||||
description: >
|
||||
InfluxDB and Flux return query results in annotated CSV format.
|
||||
You can also read annotated CSV directly from Flux with the `csv.from()` function
|
||||
or write data to InfluxDB using annotated CSV and the `influx write` command.
|
||||
You can also read annotated CSV directly from Flux with the `csv.from()` function,
|
||||
write data to InfluxDB using annotated CSV and the `influx write` command, or upload a CSV file in the UI.
|
||||
weight: 103
|
||||
menu:
|
||||
influxdb_2_0_ref:
|
||||
|
@ -15,8 +15,7 @@ related:
|
|||
---
|
||||
|
||||
InfluxDB and Flux return query results in annotated CSV format.
|
||||
You can also read annotated CSV directly from Flux with the [`csv.from()` function](/{{< latest "flux" >}}/stdlib/csv/from/)
|
||||
or write data to InfluxDB using annotated CSV and the `influx write` command.
|
||||
You can also read annotated CSV directly from Flux with the [`csv.from()` function](/{{< latest "flux" >}}/stdlib/csv/from/), write data to InfluxDB using annotated CSV and the `influx write` command, or [upload a CSV file](/influxdb/cloud/write-data/no-code/load-data/#load-data-by-uploading-a-csv-or-line-protocol-file) in the UI.
|
||||
|
||||
CSV tables must be encoded in UTF-8 and Unicode Normal Form C as defined in [UAX15](http://www.unicode.org/reports/tr15/).
|
||||
InfluxDB removes carriage returns before newline characters.
|
||||
|
|
|
@ -19,117 +19,12 @@ related:
|
|||
- /influxdb/v2.0/reference/cli/influx/write
|
||||
---
|
||||
|
||||
Discover what you'll need to write data into InfluxDB OSS (open source). Learn how to quickly start collecting data, and then explore ways to write data, best practices, and what we recommend if you're migrating a large amount of historical data.
|
||||
|
||||
- [What you'll need](#what-youll-need)
|
||||
- [Quickly start collecting data](#quickly-start-collecting-data)
|
||||
- [Quick Start for InfluxDB OSS](#quick-start-for-influxdb-oss)
|
||||
- [Sample data](#sample-data)
|
||||
- [Load data from sources in the InfluxDB UI](/influxdb/v2.0/write-data/no-code/load-data/)
|
||||
- [Use no-code solutions](/influxdb/v2.0/write-data/no-code)
|
||||
- [Use developer tools (`influx` CLI and others)](/influxdb/v2.0/write-data/developer-tools)
|
||||
- [Best practices for writing data](/influxdb/v2.0/write-data/best-practices/)
|
||||
- [Next steps](#next-steps)
|
||||
|
||||
### What you'll need
|
||||
|
||||
To write data into InfluxDB, you need the following:
|
||||
|
||||
- **organization** – _See [View organizations](/influxdb/v2.0/organizations/view-orgs/#view-your-organization-id)
|
||||
for instructions on viewing your organization ID._
|
||||
- **bucket** – _See [View buckets](/influxdb/v2.0/organizations/buckets/view-buckets/) for
|
||||
instructions on viewing your bucket ID._
|
||||
- **API token** – _See [View tokens](/influxdb/v2.0/security/tokens/view-tokens/)
|
||||
for instructions on viewing your API token._
|
||||
- **InfluxDB URL** – _See [InfluxDB URLs](/influxdb/v2.0/reference/urls/)_.
|
||||
|
||||
The [InfluxDB setup process](/influxdb/v2.0/get-started/#set-up-influxdb) creates each of these.
|
||||
|
||||
Use _line protocol_ format to write data into InfluxDB.
|
||||
Each line represents a data point.
|
||||
Each point requires a [*measurement*](/influxdb/v2.0/reference/syntax/line-protocol/#measurement)
|
||||
and [*field set*](/influxdb/v2.0/reference/syntax/line-protocol/#field-set) and may also include
|
||||
a [*tag set*](/influxdb/v2.0/reference/syntax/line-protocol/#tag-set) and a [*timestamp*](/influxdb/v2.0/reference/syntax/line-protocol/#timestamp).
|
||||
|
||||
Line protocol data looks like this:
|
||||
|
||||
```sh
|
||||
mem,host=host1 used_percent=23.43234543 1556892576842902000
|
||||
cpu,host=host1 usage_user=3.8234,usage_system=4.23874 1556892726597397000
|
||||
mem,host=host1 used_percent=21.83599203 1556892777007291000
|
||||
```
|
||||
|
||||
#### Timestamp precision
|
||||
|
||||
When writing data to InfluxDB, we [recommend including a timestamp](/influxdb/v2.0/reference/syntax/line-protocol/#timestamp) with each point.
|
||||
If a data point does not include a timestamp when it is received by the database,
|
||||
InfluxDB uses the current system time (UTC) of its host machine.
|
||||
|
||||
The default precision for timestamps is in nanoseconds.
|
||||
If the precision of the timestamps is anything other than nanoseconds (`ns`),
|
||||
you must **specify the precision in your write request**.
|
||||
InfluxDB accepts the following precisions:
|
||||
|
||||
- `ns` - Nanoseconds
|
||||
- `us` - Microseconds
|
||||
- `ms` - Milliseconds
|
||||
- `s` - Seconds
|
||||
|
||||
_For more details about line protocol, see the [Line protocol reference](/influxdb/v2.0/reference/syntax/line-protocol)
|
||||
and [Best practices for writing data](/influxdb/v2.0/write-data/best-practices/)._
|
||||
|
||||
## Quickly start collecting data
|
||||
|
||||
Familiarize yourself with querying, visualizing, and processing data in InfluxDB Cloud and InfluxDB OSS by collecting data right away. The following options are available:
|
||||
|
||||
- [Quick Start for InfluxDB OSS](#quick-start-for-influxdb-oss)
|
||||
- [Sample data](#sample-data)
|
||||
|
||||
## Quick Start for InfluxDB OSS
|
||||
|
||||
Select **Quick Start** in the last step of the InfluxDB user interface's (UI)
|
||||
[setup process](/influxdb/v2.0/get-started/#set-up-influxdb) to quickly start collecting data with InfluxDB.
|
||||
Quick Start creates a data scraper that collects metrics from the InfluxDB `/metrics` endpoint.
|
||||
The scraped data provides a robust dataset of internal InfluxDB metrics that you can query, visualize, and process.
|
||||
|
||||
### Use Quick Start to collect InfluxDB metrics
|
||||
After [setting up InfluxDB v2.0](/influxdb/v2.0/get-started/#set-up-influxdb),
|
||||
the "Let's start collecting data!" page displays options for collecting data.
|
||||
Click **Quick Start**.
|
||||
|
||||
InfluxDB creates and configures a new [scraper](/influxdb/v2.0/write-data/no-code/scrape-data/).
|
||||
The target URL points to the `/metrics` HTTP endpoint of your local InfluxDB instance
|
||||
(for example, `http://localhost:8086/metrics`), which outputs internal InfluxDB
|
||||
metrics in the [Prometheus data format](https://prometheus.io/docs/instrumenting/exposition_formats/).
|
||||
The scraper stores the scraped metrics in the bucket created during the
|
||||
[initial setup process](/influxdb/v2.0/get-started/#set-up-influxdb).
|
||||
|
||||
{{% note %}}
|
||||
Quick Start is only available in the last step of the setup process.
|
||||
If you missed the Quick Start option, you can [manually create a scraper](/influxdb/v2.0/write-data/no-code/scrape-data/)
|
||||
that scrapes data from the `/metrics` endpoint.
|
||||
{{% /note %}}
|
||||
|
||||
## Sample data
|
||||
Use [sample data sets](/influxdb/v2.0/reference/sample-data/) to quickly populate
|
||||
InfluxDB with sample time series data.
|
||||
|
||||
---
|
||||
|
||||
## Next steps
|
||||
With your data in InfluxDB, you're ready to do one or more of the following:
|
||||
|
||||
### Query and explore your data
|
||||
Query data using Flux, the UI, and the `influx` command line interface.
|
||||
See [Query data](/influxdb/v2.0/query-data/).
|
||||
|
||||
### Process your data
|
||||
Use InfluxDB tasks to process and downsample data. See [Process data](/influxdb/v2.0/process-data/).
|
||||
|
||||
### Visualize your data
|
||||
Build custom dashboards to visualize your data.
|
||||
See [Visualize data](/influxdb/v2.0/visualize-data/).
|
||||
|
||||
### Monitor your data and send alerts
|
||||
Monitor your data and sends alerts based on specified logic.
|
||||
See [Monitor and alert](/influxdb/v2.0/monitor-alert/).
|
||||
1. Learn the [best practices](/influxdb/v2.0/write-data/best-practices/) for writing data.
|
||||
2. Discover how to write data [without coding](/influxdb/v2.0/write-data/no-code/), by [loading data source in the UI](/influxdb/v2.0/write-data/load-data/), or using [developer tools](/influxdb/v2.0/write-data/developer-tools/).
|
||||
3. Do any of the following:
|
||||
- [Troubleshoot the most common issues writing data](/influxdb/v2.0/write-data/troubleshoot/)
|
||||
- [Delete data you no longer need](/influxdb/v2.0/write-data/delete-data/)
|
||||
- [Query and explore data](/influxdb/v2.0/query-data/)
|
||||
- [Process data](/influxdb/v2.0/process-data/)
|
||||
- [Visualize data](/influxdb/v2.0/visualize-data/)
|
||||
- [Monitor and alert](/influxdb/v2.0/monitor-alert/)
|
|
@ -18,11 +18,12 @@ related:
|
|||
---
|
||||
|
||||
Write CSV data with the following methods:
|
||||
|
||||
- [Upload a file or manually paste data in the UI](/influxdb/cloud/write-data/no-code/load-data/#load-data-by-uploading-a-csv-or-line-protocol-file)
|
||||
- [influx write command](#influx-write-command)
|
||||
- [Telegraf](#telegraf)
|
||||
- [Flux](#flux)
|
||||
|
||||
|
||||
## influx write command
|
||||
|
||||
Use the [`influx write` command](/influxdb/v2.0/reference/cli/influx/write/) to write CSV data
|
||||
|
|
|
@ -2,7 +2,7 @@
|
|||
title: Load data from sources in the InfluxDB user interface (UI)
|
||||
seotitle: Load data source in UI
|
||||
list_title: Load data source in UI
|
||||
weight: 105
|
||||
weight: 101
|
||||
description: >
|
||||
Load data from sources in the InfluxDB user interface (UI). Choose from popular client libraries (such as Python, Ruby, Scala, and more!) or load data with a Telegraf plugin (like MQTT Consumer, MySQL, File, and many more!).
|
||||
menu:
|
||||
|
@ -13,18 +13,34 @@ menu:
|
|||
|
||||
Load data from the following sources in the InfluxDB user interface (UI):
|
||||
|
||||
- [CSV](#load-data-using-csv)
|
||||
- [CSV or line protocol file](#load-csv-or-line-protocol-in-ui)
|
||||
- [Line protocol](#load-data-using-line-protocol)
|
||||
- [Client libraries](#load-data-from-a-client-library-in-the-ui)
|
||||
- [Telegraf plugins](#load-data-from-a-telegraf-plugin-in-the-ui)
|
||||
|
||||
### Load data using CSV
|
||||
### Load CSV or line protocol in UI
|
||||
|
||||
Use CSV data to write data to InfluxDB using the different [methods](/influxdb/cloud/write-data/developer-tools/csv/).
|
||||
Load CSV or line protocol data by uploading a file or pasting the data manually into the UI.
|
||||
|
||||
### Load data using line protocol
|
||||
1. In the navigation menu on the left, click **Data (Load Data)** > **Sources**.
|
||||
{{< nav-icon "data" >}}
|
||||
2. Under **File Upload**, select the type of data to upload:
|
||||
- **Annotated CSV**. Verify your CSV file follows the supported [annotated CSV](/influxdb/cloud/reference/syntax/annotated-csv/) syntax.
|
||||
- **Line Protocol**. Verify your line protocol file adheres to the following conventions:
|
||||
- Each line represents a data point.
|
||||
- Each data point requires a:
|
||||
- [*measurement*](/influxdb/cloud/reference/syntax/line-protocol/#measurement)
|
||||
- [*field set*](/influxdb/cloud/reference/syntax/line-protocol/#field-set)
|
||||
- (Optional) [*tag set*](/influxdb/cloud/reference/syntax/line-protocol/#tag-set)
|
||||
- [*timestamp*](/influxdb/cloud/reference/syntax/line-protocol/#timestamp)
|
||||
|
||||
For more information, see supported [line protocol](/influxdb/cloud/reference/syntax/line-protocol/) syntax.
|
||||
|
||||
Use line protocol to write data to InfluxDB using the different [methods](/influxdb/cloud/write-data/developer-tools/line-protocol/).
|
||||
2. Select the bucket to write to.
|
||||
4. Select the **Precision** in the dropdown menu. By default, the precision is set to nanoseconds.
|
||||
5. Do one of the following:
|
||||
- To upload file, drag and drop your file onto the UI, and then click **Write Data**.
|
||||
- To enter data manually, select the **Enter Manually** tab, paste your data, and then click **Write Data**.
|
||||
|
||||
### Load data from a client library in the UI
|
||||
|
||||
|
|
Binary file not shown.
After Width: | Height: | Size: 120 KiB |
Loading…
Reference in New Issue