Skip to content

Commit 836e186

Browse files
Merge pull request #2738 from splunk/urbiz-OD7149-remove-fluentd
[7149]: Remove Fluentd in the Colector for L/W
2 parents 1f5f23b + a97c253 commit 836e186

25 files changed

+110
-537
lines changed
Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
The Collector supports the following Linux distributions and versions:
22

3-
* Amazon Linux: 2, 2023. Log collection with Fluentd is not currently supported for Amazon Linux 2023.
3+
* Amazon Linux: 2, 2023.
44
* CentOS: 7, 8, 9
55
* Red Hat: 7, 8, 9
66
* Oracle: 8, 9
77
* Debian: 11, 12
8-
* SUSE: 12, 15 for version 0.34.0 or higher. Log collection with Fluentd is not currently supported.
8+
* SUSE: 12, 15 for version 0.34.0 or higher.
99
* Ubuntu: 16.04, 18.04, 20.04, 22.04, and 24.04
1010
* Rocky Linux: 8, 9

admin/authentication/allow-services.rst

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -216,9 +216,6 @@ If you're unable to allow all URLs as described in :ref:`allow-urls`, ensure tha
216216
# RUM ingest endpoint
217217
rum-ingest.<YOUR_REALM>.signalfx.com/v1/rum
218218
219-
# For td-agent/Fluentd on Linux and Windows
220-
packages.treasuredata.com
221-
222219
# For DEB/RPM collector packages
223220
splunk.jfrog.io
224221
jfrog-prod-use1-shared-virginia-main.s3.amazonaws.com

gdi/opentelemetry/automatic-discovery/linux/linux-backend.rst

Lines changed: 0 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -89,8 +89,6 @@ Using the installer script, you can install and activate zero-code instrumentati
8989
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
9090
sudo sh /tmp/splunk-otel-collector.sh --with-instrumentation --realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN>
9191
92-
.. note:: If you wish to collect logs for the target host, make sure Fluentd is installed and enabled in your Collector instance by specifying the ``--with-fluentd`` option.
93-
9492
The system-wide zero-code instrumentation method automatically adds environment variables to ``/etc/splunk/zeroconfig/java.conf``.
9593

9694
To automatically define the optional ``deployment.environment`` resource attribute at installation time, run the installer script with the ``--deployment-environment <env>`` option. Replace ``<env>`` with the desired attribute value, for example, ``prod``, as shown in the following example:
@@ -125,8 +123,6 @@ Using the installer script, you can install and activate zero-code instrumentati
125123
126124
The ``systemd`` instrumentation automatically adds environment variables to ``/usr/lib/systemd/system.conf.d/00-splunk-otel-auto-instrumentation.conf``.
127125

128-
.. note:: If you wish to collect logs for the target host, make sure Fluentd is installed and enabled in your Collector instance by specifying the ``--with-fluentd`` option.
129-
130126
To automatically define the optional ``deployment.environment`` resource attribute at installation time, run the installer script with the ``--deployment-environment <env>`` option. Replace ``<env>`` with the desired attribute value, for example, ``prod``, as shown in the following example:
131127

132128
.. code-block:: bash
@@ -230,7 +226,6 @@ Using the installer script, you can install and activate zero-code instrumentati
230226
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
231227
sh /tmp/splunk-otel-collector.sh --with-instrumentation --realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN>
232228
233-
.. note:: If you wish to collect logs for the target host, make sure Fluentd is installed and enabled in your Collector instance by specifying the ``--with-fluentd`` option.
234229
235230
The system-wide zero-code instrumentation method automatically adds environment variables to ``/etc/splunk/zeroconfig/node.conf``.
236231

@@ -257,8 +252,6 @@ Using the installer script, you can install and activate zero-code instrumentati
257252
258253
The ``systemd`` zero-code instrumentation method automatically adds environment variables to ``/usr/lib/systemd/system.conf.d/00-splunk-otel-auto-instrumentation.conf``.
259254

260-
.. note:: If you wish to collect logs for the target host, make sure Fluentd is installed and enabled in your Collector instance by specifying the ``--with-fluentd`` option.
261-
262255
You can activate AlwaysOn Profiling for CPU and memory, as well as metrics, using additional options, as in the following example:
263256

264257
.. code-block:: bash
@@ -309,8 +302,6 @@ Using the installer script, you can install and activate zero-code instrumentati
309302
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
310303
sudo sh /tmp/splunk-otel-collector.sh --with-instrumentation --realm <SPLUNK_REALM> -- <SPLUNK_ACCESS_TOKEN>
311304
312-
.. note:: If you wish to collect logs for the target host, make sure Fluentd is installed and enabled in your Collector instance by specifying the ``--with-fluentd`` option.
313-
314305
The system-wide zero-code instrumentation method automatically adds environment variables to ``/etc/splunk/zeroconfig/dotnet.conf``.
315306

316307
To automatically define the optional ``deployment.environment`` resource attribute at installation time, run the installer script with the ``--deployment-environment <env>`` option. Replace ``<env>`` with the desired attribute value, for example, ``prod``, as shown in the following example:
@@ -345,8 +336,6 @@ Using the installer script, you can install and activate zero-code instrumentati
345336
346337
The ``systemd`` instrumentation automatically adds environment variables to ``/usr/lib/systemd/system.conf.d/00-splunk-otel-auto-instrumentation.conf``.
347338

348-
.. note:: If you wish to collect logs for the target host, make sure Fluentd is installed and enabled in your Collector instance by specifying the ``--with-fluentd`` option.
349-
350339
To automatically define the optional ``deployment.environment`` resource attribute at installation time, run the installer script with the ``--deployment-environment <env>`` option. Replace ``<env>`` with the desired attribute value, for example, ``prod``, as shown in the following example:
351340

352341
.. code-block:: bash

gdi/opentelemetry/collector-linux/collector-configuration-tutorial/collector-config-tutorial-start.rst

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,6 @@ After you've installed the Collector, navigate to /etc/otel/collector to find th
6666
.
6767
|-- agent_config.yaml
6868
|-- config.d
69-
|-- fluentd
7069
|-- gateway_config.yaml
7170
|-- splunk-otel-collector.conf
7271
|-- splunk-otel-collector.conf.example

gdi/opentelemetry/collector-linux/deployments-linux-ansible.rst

Lines changed: 0 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -96,14 +96,6 @@ The following table describes the variables that can be configured for this role
9696
- The amount of allocated memory in MiB. The default value is ``512``, or 500 x 2^20 bytes, of memory .
9797
* - ``splunk_ballast_size_mib``
9898
- ``splunk_ballast_size_mib`` is deprecated starting on Collector version 0.97.0. If you're using it, see :ref:`how to update your configuration <collector-upgrade-memory-ballast>`.
99-
* - ``install_fluentd``
100-
- The option to install or manage Fluentd and dependencies for log collection. The dependencies include ``capng_c`` for activating Linux capabilities, ``fluent-plugin-systemd`` for systemd journal log collection, and the required libraries or development tools. The default value is ``false``.
101-
* - ``td_agent_version``
102-
- The version of td-agent (Fluentd package) that is installed. The default value is ``3.3.0`` for Debian jessie, ``3.7.1`` for Debian stretch, and ``4.3.0`` for other distros.
103-
* - ``splunk_fluentd_config``
104-
- The path to the Fluentd configuration file on the remote host. The default location is ``/etc/otel/collector/fluentd/fluent.conf``.
105-
* - ``splunk_fluentd_config_source``
106-
- The source path to a Fluentd configuration file on your control host that is uploaded and set in place of the value set in ``splunk_fluentd_config`` on remote hosts. Use this variable to submit a custom Fluentd configuration, for example, ``./custom_fluentd_config.conf``. The default value is ``""``, which means that nothing is copied and the configuration file set with ``splunk_otel_collector_config`` is used.
10799

108100
.. _ansible-zero-config:
109101

gdi/opentelemetry/collector-linux/deployments-linux-chef.rst

Lines changed: 0 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -112,18 +112,6 @@ For Linux, the cookbook accepts the attributes described in the following table:
112112
* - ``package_stage``
113113
- The Collector package repository stage to use. Can be ``release``, ``beta``, or ``test``.
114114
- ``release``
115-
* - ``with_fluentd``
116-
- Whether to install or manage Fluentd and dependencies for log collection. On Linux, the dependencies include ``capng_c`` for activating Linux capabilities, ``fluent-plugin-systemd`` for systemd journal log collection, and the required libraries and development tools.
117-
- ``false``
118-
* - ``fluentd_version``
119-
- Version of the td-agent (Fluentd) package to install
120-
- ``3.7.1`` for Debian stretch and ``4.3.1`` for all other Linux distros
121-
* - ``fluentd_config_source``
122-
- Source path to the Fluentd configuration file. This file is copied to the ``$fluentd_config_dest`` path on the node. See the :new-page:`source attribute <https://puppet.com/docs/puppet/latest/types/file.html#file-attribute-source>` of the file resource for the supported value types. The default source file is provided by the Collector package. Only applicable if ``$with_fluentd`` is set to ``true``.
123-
- ``/etc/otel/collector/fluentd/fluent.conf``
124-
* - ``fluentd_config_dest``
125-
- Destination path to the Fluentd configuration file on the node. Only applicable if ``$with_fluentd`` is set to ``true``.
126-
- ``/etc/otel/collector/fluentd/fluent.conf``
127115

128116
.. _chef-zero-config:
129117

gdi/opentelemetry/collector-linux/deployments-linux-puppet.rst

Lines changed: 0 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -101,18 +101,6 @@ The class accepts the parameters described in the following table:
101101
* - ``service_user and $service_group``
102102
- Sets the user or group ownership for the Collector service. The user or group is created if they do not exist.
103103
- ``splunk-otel-collector``
104-
* - ``with_fluentd``
105-
- Whether to install or manage Fluentd and dependencies for log collection. On Linux, the dependencies include ``capng_c`` for activating Linux capabilities, ``fluent-plugin-systemd`` for systemd journal log collection, and the required libraries and development tools.
106-
- ``false``
107-
* - ``fluentd_config_source``
108-
- Source path to the Fluentd configuration file. This file is copied to the ``$fluentd_config_dest`` path on the node. See the :new-page:`source attribute <https://puppet.com/docs/puppet/latest/types/file.html#file-attribute-source>` of the file resource for the supported value types. The default source file is provided by the Collector package. Only applicable if ``$with_fluentd`` is set to ``true``.
109-
- ``/etc/otel/collector/fluentd/fluent.conf``
110-
* - ``fluentd_config_dest``
111-
- Destination path to the Fluentd configuration file on the node. Only applicable if ``$with_fluentd`` is set to ``true``.
112-
- ``/etc/otel/collector/fluentd/fluent.conf``
113-
* - ``manage_repo``
114-
- In cases where the Collector and Fluentd apt/yum repositories are managed externally, set this to ``false`` to deactivate management of the repositories by this module. If set to ``false``, the externally managed repositories should provide the ``splunk-otel-collector`` and ``td-agent`` packages. Also, the apt (``/etc/apt/sources.list.d/splunk-otel-collector.list`` and ``/etc/apt/sources.list.d/splunk-td-agent.list``) and yum (``/etc/yum.repos.d/splunk-otel-collector.repo`` and ``/etc/yum.repos.d/splunk-td-agent.repo``) repository definition files are deleted if they exist in order to avoid any conflicts.
115-
- ``true``
116104

117105
.. _puppet-zero-config:
118106

gdi/opentelemetry/collector-linux/deployments-linux-salt.rst

Lines changed: 0 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -110,21 +110,6 @@ For Linux, the formula accepts the attributes described in the following table:
110110
* - ``service_user`` and ``$service_group``
111111
- Sets the user or group ownership for the Collector service. The user or group is created if they do not exist.
112112
- ``splunk-otel-collector``
113-
* - ``install_fluentd``
114-
- Whether to install or manage Fluentd and dependencies for log collection. On Linux, the dependencies include ``capng_c`` for activating Linux capabilities, ``fluent-plugin-systemd`` for systemd journal log collection, and the required libraries and development tools.
115-
- ``false``
116-
* - ``td_agent_version``
117-
- Version of the td-agent (Fluentd) package to install
118-
- ``4.3.0``
119-
* - ``splunk_fluentd_config``
120-
- The path to the Fluentd configuration file on the remote host.
121-
- ``/etc/otel/collector/fluentd/fluent.conf``
122-
* - ``splunk_fluentd_config_source``
123-
- The source path to a Fluentd configuration file on your control host that is uploaded and set in place of the ``splunk_fluentd_config`` file on remote hosts. To use a custom Fluentd configuration file, add the configuration file into the Salt dir. For example, ``salt://templates/td_agent.conf``.
124-
- ``""`` meaning that nothing is copied and the existing ``splunk_fluentd_config`` file is used.
125-
* - ``fluentd_config_dest``
126-
- Destination path to the Fluentd configuration file on the node. Only applicable if ``$with_fluentd`` is set to ``true``.
127-
- ``/etc/otel/collector/fluentd/fluent.conf``
128113

129114
.. _salt-zero-config:
130115

gdi/opentelemetry/collector-linux/install-linux-manual.rst

Lines changed: 0 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -89,7 +89,6 @@ See also:
8989

9090
* :ref:`linux-packages-post`
9191
* :ref:`linux-packages-auto`
92-
* :ref:`linux-packages-fluentd`
9392

9493
.. _linux-packages-rpm:
9594

@@ -164,7 +163,6 @@ See also:
164163
165164
* :ref:`linux-packages-post`
166165
* :ref:`linux-packages-auto`
167-
* :ref:`linux-packages-fluentd`
168166
169167
.. _linux-packages:
170168
@@ -213,7 +211,6 @@ See also:
213211
214212
* :ref:`linux-packages-post`
215213
* :ref:`linux-packages-auto`
216-
* :ref:`linux-packages-fluentd`
217214
218215
.. _linux-packages-post:
219216
@@ -305,35 +302,6 @@ The ``splunk-otel-auto-instrumentation`` deb/rpm package installs and supports c
305302
306303
To learn more, see :ref:`linux-backend-auto-discovery`.
307304
308-
.. _linux-packages-fluentd:
309-
310-
Install and configure Fluentd for log collection
311-
--------------------------------------------------------------
312-
313-
If you require log collection, perform the following steps to install Fluentd and forward collected log events to the Collector. This requires root privileges.
314-
315-
#. Install, configure, and start the Collector as described in :ref:`linux-packages-repo`. The Collector's default configuration file listens for log events on ``127.0.0.1:8006`` and sends them to Splunk Observability Cloud.
316-
317-
#. Install the ``td-agent`` package appropriate for the Linux distribution/version of the target system. Find the package in :new-page:`Fluentd installation <https://docs.fluentd.org/installation>`.
318-
319-
* If necessary, install the ``capng_c`` plugin and dependencies to enable Linux capabilities, for example ``cap_dac_read_search`` and/or ``cap_dac_override``. This requires ``td-agent`` version 4.1 or higher. See :new-page:`Linux capabilities <https://docs.fluentd.org/deployment/linux-capability>`.
320-
321-
* If necessary, install the ``fluent-plugin-systemd`` plugin to collect log events from the systemd journal. See :new-page:`Fluent plugin systemd <https://github.com/fluent-plugin-systemd/fluent-plugin-systemd>`.
322-
323-
#. Configure Fluentd to collect log events and forward them to the Collector:
324-
325-
* Option 1: Update the default config file at /etc/td-agent/td-agent.conf provided by the Fluentd package to collect the desired log events and forward them to ``127.0.0.1:8006``.
326-
327-
* Option 2: The installed Collector package provides a custom Fluentd config file /etc/otel/collector/fluentd/fluent.conf to collect log events from many popular services and forwards them to ``127.0.0.1:8006``. To use these files, you need to override the default config file path for the Fluentd service. To do this, copy the systemd environment file from /etc/otel/collector/fluentd/splunk-otel-collector.conf to /etc/systemd/system/td-agent.service.d/splunk-otel-collector.conf.
328-
329-
#. Ensure that the ``td-agent`` service user/group has permissions to access to the config file(s) from the previous step.
330-
331-
#. Restart the Fluentd service to apply the changes by running ``systemctl restart td-agent``.
332-
333-
#. View Fluentd service logs and errors in /var/log/td-agent/td-agent.log.
334-
335-
See :new-page:`Fluentd configuration <https://docs.fluentd.org/configuration>` for general Fluentd configuration details.
336-
337305
.. _linux-docker:
338306
339307
Docker

gdi/opentelemetry/collector-linux/install-linux.rst

Lines changed: 4 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,6 @@ Included packages
4141
The installer script deploys and configures these elements:
4242

4343
* The Splunk Distribution of the OpenTelemetry Collector for Linux
44-
* Fluentd, using the td-agent. Turned off by default. See :ref:`fluentd-manual-config-linux` and :ref:`fluentd-receiver` for more information
4544
* JMX metric gatherer
4645

4746
.. _linux-scripts:
@@ -87,15 +86,15 @@ To configure proxy settings to install and run the OpenTelemetry Collector, see
8786
Use configured repos
8887
--------------------------------
8988

90-
By default, apt/yum/zypper repo definition files are created to download the package and Fluentd deb/rpm packages from
89+
By default, apt/yum/zypper repo definition files are created to download the package from
9190
:new-page:`https://splunk.jfrog.io/splunk <https://splunk.jfrog.io/splunk>` and :new-page:`https://packages.treasuredata.com <https://packages.treasuredata.com>`, respectively.
9291

93-
To skip these steps and use configured repos on the target system that provide the ``splunk-otel-collector`` and ``td-agent`` deb/rpm packages, specify the ``--skip-collector-repo`` or ``--skip-fluentd-repo`` options. For example:
92+
To skip these steps and use configured repos on the target system that provide the ``splunk-otel-collector`` packages, use the ``--skip-collector-repo`` option. For example:
9493

9594
.. code-block:: bash
9695
9796
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
98-
sudo sh /tmp/splunk-otel-collector.sh --realm $SPLUNK_REALM --skip-collector-repo --skip-fluentd-repo \
97+
sudo sh /tmp/splunk-otel-collector.sh --realm $SPLUNK_REALM --skip-collector-repo \
9998
-- $SPLUNK_ACCESS_TOKEN
10099
101100
.. _configure-auto-instrumentation-linux:
@@ -156,7 +155,7 @@ To use host bindings, run this command:
156155
Options of the installer script of the Collector for Linux
157156
==================================================================
158157

159-
The Linux installer script supports the following options for the Collector, automatic discovery with zero-code instrumentation for back-end services, and Fluentd.
158+
The Linux installer script supports the following options for the Collector, automatic discovery with zero-code instrumentation for back-end services.
160159

161160
To display all the configuration options supported by the script, use the ``-h`` flag.
162161

@@ -282,29 +281,9 @@ Automatic discovery with zero-code instrumentation for back-end services
282281
- The ``splunk-otel-auto-instrumentation`` package version to install. Note: The minimum supported version for Java and Node.js zero-code instrumentation is 0.87.0, and the minimum supported version for .NET zero-code instrumentation is 0.99.0.
283282
- ``latest``
284283

285-
Fluentd
286-
--------------------------------------------------------------------
287-
288-
.. list-table::
289-
:header-rows: 1
290-
:width: 100%
291-
:widths: 30 40 30
292-
293-
* - Option
294-
- Description
295-
- Default value
296-
* - ``--with[out]-fluentd``
297-
- Whether to install and configure fluentd to forward log events to the Collector. See :ref:`fluentd-manual-config-linux` for more information.
298-
- ``--without-fluentd``
299-
* - ``--skip-fluentd-repo``
300-
- By default, a apt/yum repo definition file will be created to download the fluentd deb/rpm package from ``https://packages.treasuredata.com``. Use this option to skip the previous step and use a pre-configured repo on the target system that provides the ``td-agent`` deb/rpm package.
301-
-
302-
303284
Next steps
304285
==================================
305286

306-
307-
308287
.. raw:: html
309288

310289
<div class="include-start" id="gdi/collector-linux-next-steps.rst"></div>

0 commit comments

Comments
 (0)