Influxdata
/
docs-v2
mirror of https://github.com/influxdata/docs-v2.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

New version of quick start page

pull/35/head
stevebang 2019-02-05 22:54:58 -08:00
parent 4fe166e56d
commit 309e2a9789
1 changed files with 33 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

53
content/v2.0/collect-data/scraper-quickstart.md
View File

@ -1,35 +1,48 @@
---
title: Use a scraper to collect InfluxDB 2.0 metrics
seotitle: Use a scraper to collect InfluxDB 2.0 metrics
title: Quick start to data collection
seotitle: Quick start to data collection
description: >
Use a scraper defined in the InfluxDB 2.0 UI to collect system statistics into a bucket.
Use Quick Start to create a scraper to collect InfluxDB metrics into a bucket.
menu:
v2_0:
name: Use a scraper to collect InfluxDB 2.0 metrics
name: Quick start to data collection
parent: Collect data
weight: 1
---
You can use the InfluxDB 2.0 user interface (UI) to quickly define a scraper that can capture hardware and OS metrics from third-party systems and translate the data into the popular Prometheus format, which is supported by InfluxDB.
>**Note:** The steps below only apply during your initial configuration and usage of your InfluxDB 2.0 instance. The page described below is not available after clicking one of the three options. For steps on configuring a scraper yourself, see [Scrape data using the /metrics endpoint](influxdb/v2.0/scraper-endpoint/).
Follow the steps below to configure an InfluxDB 2.0 scraper to collect metrics generated by InfluxDB 2.0 into a bucket.
## Use **Quick Start** to collect InfluxDB metrics
## Configure an InfluxDB scraper to collect InfluxDB 2.0 metrics
When you start InfluxDB 2.0 for the first time, you are guided to configure a user, organization, and a bucket.
After you complete this initial configuration, the next page includes "Let's start collecting data!" and three options.
This page guides you on using the **Quick Start** option.
Follow the steps here to capture Prometheus format data into an InfluxDB 2.0 bucket.
On the page that includes "Let's start collecting data!" and three options, click **Quick Start**. The following message appears in a popup alert:
1. Open a web browser to your InfluxDB 2.0 instance
[localhost:9999](http://localhost:9999). The login screen for the UI (user interface) appears.
2. Log in using your username and password. The **Getting started with InfluxDB 2.0** screen appears.
3. In the navigation bar on the left, click **Organizations** and then click the name of your organization. The **Organization** page appears for the selected organization.
4. Click the **Scrapers** tab. A listing of any existing scrapers appears, listing the **URL** and the **BUCKET** name.
5. Click **Create Scraper**. The **Data Loading** page appears with **Add Scraper Target** options to define a scraper.
6. From the **Bucket** listing, select the bucket that you wan to be use to collect data.
7. Enter the **Target URL** to use for the Prometheus `/metrics` HTTP endpoint. The default URL value is `http://localhost:9100/metrics`.
8. Click **Finish**. Your new scraper appears in the scraper listing, displaying the values you specified for the **URL** and the **BUCKET**.
`The InfluxDB Scraper has been configured for http://localhost:9999/metrics.`
The new scraper for is now collecting data into the InfluxDB bucket you specified.
Behind the scenes, here's what happened:
For information on creating InfluxDB 2.0 dashboards that use the Node Exporter data, see [Visualize data with InfluxDB](http://v2.dpcs.influxdata.com/v2.0/visualize-data/).
* InfluxDB 2.0 configured a scraper named "InfluxDB Scraper"
- The target URL points to the `/metrics` HTTP endpoint of your
local InfluxDB instance: http://localhost:9999/metrics. The `/metrics` HTTP endpoint monitors your InfluxDB instance, collects metrics from it, and provides the data in the [Prometheus data format](https://prometheus.io/docs/instrumenting/exposition_formats/).
- The bucket configured to collect the scraped data is the initial
bucket you named on the previous page.
* The InfluxDB Scraper immediately started collecting InfluxDB data and
writing it into your bucket.
To learn more about
To see a sample of the data being collected in Prometheus format, you can use one of the following methods to display a sample of the exposed InfluxDB metrics in the Prometheus text-based format:
* Open the InfluxDB Scraper URL (http://localhost:9999/metrics) in a web browser. A sample of the data appears in a text file, with the data in the Prometheus format.
* In a terminal window, run the following cURL command: `curl http://localhost:9999/metrics`.
## Next steps
Now that you have a bucket of data ready for exploration, you can:
* **Query data.** To get started querying the data stored in InfluxDB buckets using the InfluxDB user interface (UI) and the `influx` command line interface (CLI), see [Query data in InfluxDB](/v2.0/query-data).
* **Visualize data.** To learn how to build dashboards for visualizing your data, see [Visualize data with the InfluxDB UI](/v2.0/visualize-data).