WIP

Author: aurbiztondo-splunk

_includes/gdi/otel-receivers-table.rst

@@ -1,4 +1,5 @@
 * :ref:`apache-receiver`
+* :ref:`apache-spark-receiver`
 * :ref:`azureeventhub-receiver`
 * :ref:`carbon-receiver`
 * :ref:`cloudfoundry-receiver`

gdi/opentelemetry/components.rst

@@ -52,6 +52,9 @@ The Splunk Distribution of the OpenTelemetry Collector includes and supports the
    * - :ref:`apache-receiver` (``apache``) 
      - Fetches stats from a Apache Web Server.
      - Metrics
+   * - :ref:`apache-spark-receiver` (``apachespark``) 
+     - Fetches metrics for an Apache Spark cluster through the Apache Spark REST API. 
+     - Metrics
    * - :ref:`azureeventhub-receiver` (``azureeventhub``) 
      - Pulls logs from an Azure event hub.
      - Logs

gdi/opentelemetry/components/a-components-receivers.rst

@@ -13,6 +13,7 @@ Collector components: Receivers
     :hidden:
 
     apache-receiver
+    apache-spark-receiver
     azureeventhub-receiver
     carbon-receiver
     cloudfoundry-receiver

gdi/opentelemetry/components/apache-spark-receiver.rst

@@ -0,0 +1,94 @@
+.. _apache-spark-receiver:
+
+*******************************
+Apache Spark receiver
+*******************************
+
+.. meta::
+      :description: The Apache Spark receiver fetches metrics for an Apache Spark cluster through the Apache Spark REST API. 
+
+The Apache Spark receiver metrics for an Apache Spark cluster through the Apache Spark REST API. The supported pipeline type is ``metrics``. See :ref:`otel-data-processing` for more information.
+
+.. note:: Out-of-the-box dashboards and navigators aren't supported for the Apache Web Server receiver yet, but are planned for a future release.
+
+Prerequisites
+======================
+
+This receiver supports Apache Web Server version 2.4 or higher.
+
+In order to receive server statistics, you must configure the server's ``httpd.conf`` file to enable status support. Learn more at Apache's official documentation :new-page:`Module mod_status <https://httpd.apache.org/docs/2.4/mod/mod_status.html>`.
+
+Get started
+======================
+
+Follow these steps to configure and activate the component:
+
+1. Deploy the Splunk Distribution of the OpenTelemetry Collector to your host or container platform:
+   
+   - :ref:`otel-install-linux`
+   - :ref:`otel-install-windows`
+   - :ref:`otel-install-k8s`
+
+2. Configure the receiver as described in the next section.
+3. Restart the Collector.
+
+Sample configuration
+--------------------------------
+
+To activate the Apache Web Server receiver, add ``apache`` to the ``receivers`` section of your configuration file: 
+
+.. code-block:: yaml
+
+  receivers:
+    apache:
+      endpoint: "http://localhost:8080/server-status?auto"
+      collection_interval: 10s
+
+To complete the configuration, include the receiver in the ``metrics`` pipeline of the ``service`` section of your configuration file:
+
+.. code:: yaml
+
+  service:
+    pipelines:
+      metrics:
+        receivers: [apache]
+
+Configuration options
+-----------------------
+
+The following settings are required:
+
+* ``endpoint``. ``"http://localhost:8080/server-status?auto"`` by default. The URL of the httpd status endpoint.
+
+The following settings are optional:
+
+.. include:: /_includes/gdi/collector-settings-collectioninterval.rst
+
+.. include:: /_includes/gdi/collector-settings-initialdelay.rst
+
+Settings
+======================
+
+The following table shows the configuration options for the Apache Web Server receiver:
+
+.. raw:: html
+
+   <div class="metrics-standard" category="included" url="https://raw.githubusercontent.com/splunk/collector-config-tools/main/cfg-metadata/receiver/apache.yaml"></div>
+
+Metrics
+======================
+
+The following metrics, resource attributes, and attributes are available.
+
+.. note:: The SignalFx exporter excludes some available metrics by default. Learn more about default metric filters in :ref:`list-excluded-metrics`.
+
+.. raw:: html
+
+  <div class="metrics-component" category="included" url="https://raw.githubusercontent.com/splunk/collector-config-tools/main/metric-metadata/apachereceiver.yaml"></div>
+
+.. include:: /_includes/activate-deactivate-native-metrics.rst
+
+Troubleshooting
+======================
+
+.. include:: /_includes/troubleshooting-components.rst