Add Telemetry glossary term - #3682
shashankvarma499 wants to merge 1 commit into
Conversation
✅ Deploy Preview for cncfglossary ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Signed-off-by: Shashank Varma <324153016+shashankvarma499@users.noreply.github.com>
76ab4c9 to
6e82952
Compare
hlipsig
left a comment
There was a problem hiding this comment.
Thanks for the submission! I've left some feedback for areas of improvement. Let me know if you need anything from me!
| tags: ["methodology", "", ""] | ||
| --- | ||
|
|
||
| Telemetry is the automated collection and transmission of data about a system's behavior and performance. |
There was a problem hiding this comment.
Telemetry is what is collected, not the act of the collection. Although I understand what you mean here I think we should rework this section.
|
|
||
| Telemetry is the automated collection and transmission of data about a system's behavior and performance. | ||
| This data commonly includes logs, metrics, and traces, often called the three pillars of [observability](/observability/). | ||
| Systems emit telemetry continuously so operators and developers can understand how they are running without inspecting them directly. |
There was a problem hiding this comment.
Systems don't necessarily inherently emit telemetry. The emission of telemetry is instrumented. This section would be stronger with examples of telemetry data that you can generally expect to get with lower effort, like CPU usage, and higher effort like logs and traces.
|
|
||
| Telemetry gives operators a steady, machine-readable view of a running system. | ||
| It lets them detect failures, diagnose performance issues, and understand how users experience the system. | ||
| Because telemetry is collected automatically and continuously, it supports monitoring, alerting, and [debugging](/debugging/) without requiring direct access to every component. |
There was a problem hiding this comment.
I'd rework this to state that the collection of the data can be automated and some cncf projects for doing so.
Adds a definition for "Telemetry" as a new glossary term, resolving #1164.
The entry follows the glossary style guide and template:
The definition is written to complement rather than duplicate the existing Observability term: observability describes a system property, while telemetry describes the data itself and the practice of collecting it.
Status is set to "Feedback Appreciated" for maintainer review.
Fixes #1164