diff --git a/_includes/gdi/otel-receivers-table.rst b/_includes/gdi/otel-receivers-table.rst index 689973c60..974c57c8d 100644 --- a/_includes/gdi/otel-receivers-table.rst +++ b/_includes/gdi/otel-receivers-table.rst @@ -7,6 +7,7 @@ * :ref:`elasticsearch-receiver` * :ref:`filelog-receiver` * :ref:`fluentd-receiver` +* :ref:`haproxy-receiver` * :ref:`host-metrics-receiver` * :ref:`http-check-receiver` * :ref:`jaeger-receiver` diff --git a/gdi/monitors-hosts/haproxy.rst b/gdi/monitors-hosts/haproxy.rst index 032388901..81b8e9835 100644 --- a/gdi/monitors-hosts/haproxy.rst +++ b/gdi/monitors-hosts/haproxy.rst @@ -6,10 +6,12 @@ HAProxy .. meta:: :description: Use this Splunk Observability Cloud integration for the HAProxy monitor. See benefits, install, configuration, and metrics -The Splunk Distribution of OpenTelemetry Collector uses the Smart Agent receiver with the +The Splunk Distribution of the OpenTelemetry Collector uses the Smart Agent receiver with the HAProxy monitor type to monitor an HAProxy instance. This monitor requires HAProxy 1.5+. +.. note:: To monitor your HAProxy instances you can instead use the native OpenTelemetry HAProxy receiver. To learn more, see :ref:`haproxy-receiver`. + Benefits -------- diff --git a/gdi/opentelemetry/components.rst b/gdi/opentelemetry/components.rst index d1f7ff9f8..862837d53 100644 --- a/gdi/opentelemetry/components.rst +++ b/gdi/opentelemetry/components.rst @@ -76,6 +76,9 @@ The Splunk Distribution of the OpenTelemetry Collector includes and supports the * - :ref:`fluentd-receiver` (``fluentforward``) - Runs a TCP server that accepts events through the Fluentd Forward protocol. - Logs + * - :ref:`haproxy-receiver` (``haproxy``) + - Generates metrics by polling periodically the HAProxy process through a dedicated socket or HTTP URL. + - Metrics * - :ref:`host-metrics-receiver` (``hostmetrics``) - Generates system metrics from various sources. Use this receiver when deploying the Collector as an agent. - Metrics diff --git a/gdi/opentelemetry/components/a-components-receivers.rst b/gdi/opentelemetry/components/a-components-receivers.rst index ed36690c3..a5f9406c4 100644 --- a/gdi/opentelemetry/components/a-components-receivers.rst +++ b/gdi/opentelemetry/components/a-components-receivers.rst @@ -21,6 +21,7 @@ Collector components: Receivers elasticsearch-receiver filelog-receiver fluentd-receiver + haproxy-receiver host-metrics-receiver http-check-receiver jaeger-receiver diff --git a/gdi/opentelemetry/components/haproxy-receiver.rst b/gdi/opentelemetry/components/haproxy-receiver.rst new file mode 100644 index 000000000..ae56465ff --- /dev/null +++ b/gdi/opentelemetry/components/haproxy-receiver.rst @@ -0,0 +1,86 @@ +.. _haproxy-receiver: + +*********************** +HAProxy receiver +*********************** + +.. meta:: + :description: The HAProxy receiver generates metrics by polling periodically the HAProxy process through a dedicated socket or HTTP URL + +The HAProxy receiver generates metrics by polling periodically the HAProxy process through a dedicated socket or HTTP URL. 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 HAProxy receiver yet, but are planned for a future release. + +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 configurations +--------------------------- + +To activate the HAProxy receiver, add ``haproxy`` to the ``receivers`` section of your configuration file, as shown in the following example: + +.. code:: yaml + + receivers: + haproxy: + endpoint: file:///var/run/haproxy.ipc + collection_interval: 1m + metrics: + +To complete the configuration, include the receiver in the ``metrics`` pipeline of the ``service`` section of your configuration file. For example: + +.. code:: yaml + + service: + pipelines: + metrics: + receivers: [haproxy] + +Configuration options +-------------------------------------------- + +You can configure the following settings: + +* ``endpoint``. :strong:`Required`. Path to the endpoint exposed by HAProxy for communications. It can be a local file socket or a HTTP URL. + +* ``collection_interval``. Optional, ``1m`` by default. The scraping collection interval. + +* ``initial_delay``. Optional, ``1s`` by default. Defines how long this receiver waits before starting. + +Settings +====================== + +The following table shows the configuration options for the HAProxy receiver: + +.. raw:: html + +
+ +.. _haproxy-receiver-metrics: + +Metrics +===================== + +The following metrics, resource attributes, and attributes are available. + +.. raw:: html + +
+ +.. include:: /_includes/activate-deactivate-native-metrics.rst + +Troubleshooting +====================== + +.. include:: /_includes/troubleshooting-components.rst