Closed otisg closed 5 years ago
Actually, @bsmid , do we have that new how-to linked from anywhere? We should.
We have, I linked to it from root sematext-agent-java README. You can see it in commit.
Yeah, just saw it. Closing.
Btw. wouldn't it make more sense (for the developer/reader) to have that info in https://github.com/sematext/sematext-agent-java/blob/master/docs/metrics-yaml-format.md ? Doesn't the bottom of this doc already have similar sections (grouping, processing, extracting...)?
I'm asking because having this knowledge about how to handle metrics for integrations linked to only from the agent README would make it easy for people to miss this info.
I am not sure, it seemed to me this is on different level of abstraction. Metrics YAML format is low-level, describes format itself plus those few a bit more advanced sections you mention. I have a feeling we might expand How-to guides with more advanced topics in the future, so this would be just the first addition. People looking into "how to do something" may not open metrics format doc. If you think it would be better to move, I am ok with that.
This is used in Spark and Couchbase integrations and may be used in other integrations in the future, so we should document how to do this.