Update telegraf.rst

More edits

Author: aurbiztondo-splunk

gdi/monitors-monitoring/telegraf.rst

@@ -1,12 +1,12 @@
 .. _telegraf:
 
-Telegraf Exec (OpenTelemetry)
-==============================
+Monitor services with Telegraf and OpenTelemetry
+========================================================
 
 .. meta::
    :description: Use this Splunk Observability Cloud integration for the Telegraf monitor. See benefits, install, configuration, and metrics.
 
-To monitor your system with Telegraf Exec using native OpenTelemetry, install the Telegraf plugin independently, then push metrics to the Splunk Opentelemetry Collector
+To monitor your service with Telegraf using native OpenTelemetry in Splunk Observability Cloud, install the service's Telegraf plugin then push metrics to the Splunk Opentelemetry Collector
 via OTLP. 
 
 .. note:: This setup is designed for a Linux Ubuntu OS but should be replicable on any machines running Linux OS with Debian flavor. These instructions might not work on other OS (MacOS/Windows). 
@@ -21,11 +21,12 @@ Configuration
 
 Follow these steps to scrape Telegraf metrics with the OTel Collector:
 
-1. Install the Telegraf Exec Input plugin
-2. Set up the OpenTelemetry Output plugin
-3. Configure the OpenTelemetry Collector 
+1. Install Telegraf
+2. Set up your service's Telegraf Input plugin
+3. Set up the Telegraf OpenTelemetry Output plugin
+4. Configure the OpenTelemetry Collector
 
-1. Install the Telegraf Exec Input Plugin plugin
+1. Install Telegraf 
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Run the following commands to install Telegraf from the InfluxData repository:
@@ -40,7 +41,39 @@ Run the following commands to install Telegraf from the InfluxData repository:
    | sudo tee /etc/apt/sources.list.d/influxdata.list
    sudo apt-get update && sudo apt-get install telegraf
 
-2. Set up the OpenTelemetry Output plugin
+2. Set up your service's Telegraf Input plugin
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Next, install the Telegraf Input plugin for the service you want to monitor. Available plugins include Chrony, Consul, Docker, Elasticsearch, Fluentd, GitHub, Jenkins, RabbitMQ or SQL. Find a complete list of Input plugins at :new-page:`Telegraf Input plugins <https://github.com/influxdata/telegraf/tree/master/plugins/inputs/exec>` in GitHub.
+
+For example, if you want to monitor Exec, use a setup like: 
+
+.. code:: 
+
+  # Read metrics from one or more commands that can output to stdout
+  [[inputs.exec]]
+  
+  ## Commands array
+  commands = ["sh /etc/otelcustom/mqmscripts/fileagemonitor.sh"]
+  timeout = "30s"
+  data_format = "influx"
+
+  ## Environment variables
+  ## Array of "key=value" pairs to pass as environment variables
+  ## e.g. "KEY=value", "USERNAME=John Doe",
+  ## "LD_LIBRARY_PATH=/opt/custom/lib64:/usr/local/libs"
+  # environment = []
+
+  ## Measurement name suffix
+  ## Used for separating different commands
+  # name_suffix = ""
+
+  ## Ignore Error Code
+  ## If set to true, a non-zero error code in not considered an error and the
+  ## plugin will continue to parse the output.
+  # ignore_error = false
+
+3. Set up the Telegraf OpenTelemetry Output plugin
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Next, add the OTel Output plugin to your Telegraf configuration file:
@@ -52,26 +85,28 @@ Next, add the OTel Output plugin to your Telegraf configuration file:
 
 The config file usually resides on the ./etc/telegraf/telegraf.d directory.
 
-For detailed information on the Telegraf Opentelemetry output plugin see the :new-page:`Exec Input Plugin <https://github.com/influxdata/telegraf/blob/master/plugins/outputs/opentelemetry/README.md>` documentation in GitHub.
+For detailed information see Telegraf's :new-page:`OpenTelemetry Output plugin <https://github.com/influxdata/telegraf/blob/master/plugins/outputs/opentelemetry/README.md>` documentation in GitHub.
 
-3. Configure the OpenTelemetry Collector
+4. Configure the OpenTelemetry Collector
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Add the following configuration to the OTel Collector to retrieve metrics from the Telegraf installation:
 
 .. code:: yaml
 
-    receivers:
-    otlp:
+   receivers:
+      otlp:
         protocols:
-        http:
-        grpc:
-    signalfx:
-    exporters:
-    signalfx:
-        access_token: "SPLUNK_TOKEN"
-        realm: "us0"
-    service:
+          http:
+          grpc:
+      signalfx:
+    
+   exporters:
+      signalfx:
+         access_token: "SPLUNK_TOKEN"
+         realm: "us0"
+    
+  service:
     pipelines:
         metrics:
             receivers: [otlp]