Skip to content

Commit 96d6dc8

Browse files
authored
Merge pull request #12 from cisco-open/add_readme
Add README
2 parents a5b66f6 + 3768e7f commit 96d6dc8

File tree

1 file changed

+30
-1
lines changed

1 file changed

+30
-1
lines changed

README.md

Lines changed: 30 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,5 +9,34 @@
99
![Open PRs](https://img.shields.io/github/issues-pr/cisco-open/test-telemetry-generator)
1010

1111
![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/cisco-open/test-telemetry-generator)
12-
<!--- Add more tags -->
12+
13+
## Purpose
14+
15+
[OpenTelemetry](https://opentelemetry.io/) is an open source collection of tools, APIs and SDKs which can be used to instrument, generate, collect, and export telemetry data (metrics, logs, and traces) to help you analyze your software's performance and behavior. If you are working on platforms that are built to ingest OpenTelemetry (OTel) data and have a need to provide OTel data as input to your platform services for testing or otherwise, either you can actually configure OTel collectors on your infrastructure to export the telemetry data (adding to your infra costs), or you will have to write code to generate hardcoded OTel packets. The issue with the former approach is that you do not know what data (metrics/logs/traces) is being actually sent and the latter would result in long term maintainability issues.
16+
17+
The test-telemetry-generator tries to solve this requirement by acting like an OpenTelemetry exporter which can generate and export OpenTelemetry data without actually monitoring anything. It provides a relatively readable and flexible way of specifying the telemetry data to be generated via YAML files which can be easily modified at any stage to tune the output OTel data without changing your code at all.
18+
19+
Although we can see that the key users of this tool would be test-engineers but this can be used by developers to perform quick checks on their platform and sales engineers to demo the platforms without having to write a lot of code or setting up OTel exporters on actual infra.
20+
21+
***
22+
23+
## How to use
24+
25+
This tools can be added to your code as a dependency or executed from the command-line. The repository [wiki](https://github.com/cisco-open/test-telemetry-generator/wiki) will help in understanding how to set up the pre-requisites and consume this tool as per your requirements.
26+
27+
***
28+
29+
## Support
30+
31+
We are continuously improving the tool and adding more feature support. Please see the [open issues](https://github.com/cisco-open/test-telemetry-generator/issues) to see the list of planned items and feel free to open a new issue in case something that you'd like to see is missing.
32+
33+
***
34+
35+
## Contributors
36+
37+
Built with :heart: by and with the support of:
38+
* [Severin Neumann](https://github.com/svrnm)
39+
* [Ashish Tyagi](https://github.com/ashish-tyagi)
40+
* [Aarushi Singh](https://github.com/AarushiSingh09)
41+
* [Manpreet Singh](https://github.com/preet-dev)
1342

0 commit comments

Comments
 (0)