-
Notifications
You must be signed in to change notification settings - Fork 107
better documentation for our input formats #1071
Conversation
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. |
There was a problem hiding this comment.
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/
There was a problem hiding this comment.
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. |
There was a problem hiding this comment.
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.
There was a problem hiding this 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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
change
-> chance
?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
👍
No description provided.