Skip to content
This repository was archived by the owner on Aug 23, 2023. It is now read-only.

better documentation for our input formats #1071

Merged
merged 4 commits into from
Oct 3, 2018
Merged

Conversation

Dieterbe
Copy link
Contributor

No description provided.

@Dieterbe Dieterbe requested a review from woodsaj September 29, 2018 08:14
docs/inputs.md Outdated
This format is a hand-written binary format that is much more compact and fast to encode/decode compared to MetricData.
See the [MetricPoint](https://godoc.org/github.com/raintank/schema#MetricPoint) documentation for format and implementation details.
It is a minimal format that only contains the series identifier, value and timestamp.
As such, it is paramount that MetricPoint messages for each series has been preceded by a MetricData message for that series.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/has been preceded/have been preceded/

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The true requirement is just that an entry exists in the index for the id of the metricPoint.

docs/inputs.md Outdated
See the [MetricPoint](https://godoc.org/github.com/raintank/schema#MetricPoint) documentation for format and implementation details.
It is a minimal format that only contains the series identifier, value and timestamp.
As such, it is paramount that MetricPoint messages for each series has been preceded by a MetricData message for that series.
Otherwise metrictank will not recognize the ID and will not be able handle it and discard the message.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Otherwise metrictank will not recognize the ID and the point will be discarded.

Copy link
Member

@woodsaj woodsaj left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

minor tweaks needed, otherwise lgtm

docs/inputs.md Outdated
As such, it is paramount that MetricPoint messages for each series has been preceded by a MetricData message for that series.
Otherwise metrictank will not recognize the ID and will not be able handle it and discard the message.
As such, it is paramount that MetricPoint messages for each series have been preceded by a MetricData message for that series, so
that metrictank has had the change to add the metric information into its index.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

change -> chance?

Copy link
Contributor

@replay replay left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

@Dieterbe Dieterbe merged commit 6f2b598 into master Oct 3, 2018
@Dieterbe Dieterbe deleted the better-input-format-doc branch October 29, 2018 09:06
@Dieterbe Dieterbe added this to the 0.11.0 milestone Dec 20, 2018
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants