From 092451fff34878bc297dfba9c9c2caf9aba0fcdf Mon Sep 17 00:00:00 2001
From: soumyadeepm04 <84105194+soumyadeepm04@users.noreply.github.com>
Date: Mon, 1 Jul 2024 08:10:52 -0400
Subject: [PATCH] Create BUILD_OPENTELEMETRY-COLLECTOR.md (#4)

---
 BUILD_OPENTELEMETRY-COLLECTOR.md | 48 ++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 BUILD_OPENTELEMETRY-COLLECTOR.md

diff --git a/BUILD_OPENTELEMETRY-COLLECTOR.md b/BUILD_OPENTELEMETRY-COLLECTOR.md
new file mode 100644
index 0000000..6af9346
--- /dev/null
+++ b/BUILD_OPENTELEMETRY-COLLECTOR.md
@@ -0,0 +1,48 @@
+## Build OpenTelemetry Collector on z/OS
+You can build the collector on z/OS from the source by following the steps below:
+
+### Requirements
+To build the collector, you need GNU make and go v1.21.11. You can find and install them using the links below:
+1. [GNU Make](https://github.com/ZOSOpenTools/makeport)
+2. [Go v1.21.11](https://www.ibm.com/docs/en/sdk-go-zos/1.22?topic=go-installing-configuring-pax-edition)
+
+### Compiling the collector
+Compile the opentelemetry collector repository using the following commands:
+```
+git clone https://github.com/open-telemetry/opentelemetry-collector.git
+cd opentelemetry-collector
+gmake install-tools
+gmake otelcorecol
+```
+
+This will generate the collector executable in the `bin` directory.
+
+### Configuring the collector
+Currently, the collector does not run without turning off metric collection. To disable metric collection, set the metrics level to `none` in the config file. An example config file is shown below:
+```
+receivers:
+  otlp:
+    protocols:
+      grpc:
+      http:
+
+exporters:
+  logging:
+    verbosity: detailed
+
+service:
+  pipelines:
+    traces:
+      receivers: [otlp]
+      exporters: [logging]
+  telemetry:
+    metrics:
+      level: none
+```
+
+### Running the collector
+Run the collector using the executable and the config file:
+
+` ./bin/<name of the executable> --config=<path to config file>`
+
+Replace '<path to config file>' with the path to your config file.