mirror of
https://github.com/apache/druid.git
synced 2025-03-02 15:29:10 +00:00
d007477742
* Docusaurus build framework + ingestion doc refresh. * stick to npm instead of yarn * fix typos * restore some _bin * Adjustments. * detect and fix redirect anchors * update anchor lint * Web-console: remove specific column filters (#8343) * add clear filter * update tool kit * remove usless check * auto run * add % * Fix resource leak (#8337) * Fix resource leak * Patch comments * Enable Spotbugs NP_NONNULL_RETURN_VIOLATION (#8234) * Fixes from PR review. * Fix more anchors. * Preamble nix. * Fix more anchors, headers * clean up placeholder page * add to website lint to travis config * better broken link checking * travis fix * Fixed more broken links * better redirects * unfancy catch * fix LGTM error * link fixes * fix md issues * Addl fixes
68 lines
2.7 KiB
Markdown
68 lines
2.7 KiB
Markdown
---
|
|
id: influx
|
|
title: "InfluxDB Line Protocol Parser"
|
|
---
|
|
|
|
<!--
|
|
~ Licensed to the Apache Software Foundation (ASF) under one
|
|
~ or more contributor license agreements. See the NOTICE file
|
|
~ distributed with this work for additional information
|
|
~ regarding copyright ownership. The ASF licenses this file
|
|
~ to you under the Apache License, Version 2.0 (the
|
|
~ "License"); you may not use this file except in compliance
|
|
~ with the License. You may obtain a copy of the License at
|
|
~
|
|
~ http://www.apache.org/licenses/LICENSE-2.0
|
|
~
|
|
~ Unless required by applicable law or agreed to in writing,
|
|
~ software distributed under the License is distributed on an
|
|
~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
~ KIND, either express or implied. See the License for the
|
|
~ specific language governing permissions and limitations
|
|
~ under the License.
|
|
-->
|
|
|
|
|
|
To use this Apache Druid (incubating) extension, make sure to [include](../../development/extensions.md#loading-extensions) `druid-influx-extensions`.
|
|
|
|
This extension enables Druid to parse the [InfluxDB Line Protocol](https://docs.influxdata.com/influxdb/v1.5/write_protocols/line_protocol_tutorial/), a popular text-based timeseries metric serialization format.
|
|
|
|
## Line Protocol
|
|
|
|
A typical line looks like this:
|
|
|
|
```cpu,application=dbhost=prdb123,region=us-east-1 usage_idle=99.24,usage_user=0.55 1520722030000000000```
|
|
|
|
which contains four parts:
|
|
|
|
- measurement: A string indicating the name of the measurement represented (e.g. cpu, network, web_requests)
|
|
- tags: zero or more key-value pairs (i.e. dimensions)
|
|
- measurements: one or more key-value pairs; values can be numeric, boolean, or string
|
|
- timestamp: nanoseconds since Unix epoch (the parser truncates it to milliseconds)
|
|
|
|
The parser extracts these fields into a map, giving the measurement the key `measurement` and the timestamp the key `_ts`. The tag and measurement keys are copied verbatim, so users should take care to avoid name collisions. It is up to the ingestion spec to decide which fields should be treated as dimensions and which should be treated as metrics (typically tags correspond to dimensions and measurements correspond to metrics).
|
|
|
|
The parser is configured like so:
|
|
|
|
```json
|
|
"parser": {
|
|
"type": "string",
|
|
"parseSpec": {
|
|
"format": "influx",
|
|
"timestampSpec": {
|
|
"column": "__ts",
|
|
"format": "millis"
|
|
},
|
|
"dimensionsSpec": {
|
|
"dimensionExclusions": [
|
|
"__ts"
|
|
]
|
|
},
|
|
"whitelistMeasurements": [
|
|
"cpu"
|
|
]
|
|
}
|
|
```
|
|
|
|
The `whitelistMeasurements` field is an optional list of strings. If present, measurements that do not match one of the strings in the list will be ignored.
|