From 3dea12bf1a77eeb7b25b95118c4d68a742aba5f2 Mon Sep 17 00:00:00 2001
From: Andrea Cosentino <ancosen@gmail.com>
Date: Mon, 30 Mar 2026 18:24:45 +0200
Subject: [PATCH 1/2] CAMEL-23184: Deprecate camel-splunk component

The Splunk Java SDK that camel-splunk depends on is no longer actively
maintained, and the ServiceMix bundle wrapping it is also stale.
This marks the component as deprecated in 4.19, to be removed in a
future release.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .../org/apache/camel/catalog/components/splunk.json    |  2 +-
 components/camel-splunk/pom.xml                        |  2 +-
 .../org/apache/camel/component/splunk/splunk.json      |  2 +-
 .../services/org/apache/camel/component.properties     |  2 +-
 .../camel-splunk/src/main/docs/splunk-component.adoc   | 10 ++++++++--
 .../apache/camel/component/splunk/ConsumerType.java    |  1 +
 .../splunk/DefaultSplunkConfigurationFactory.java      |  1 +
 .../apache/camel/component/splunk/ProducerType.java    |  1 +
 .../apache/camel/component/splunk/SplunkComponent.java |  1 +
 .../camel/component/splunk/SplunkConfiguration.java    |  1 +
 .../component/splunk/SplunkConfigurationFactory.java   |  1 +
 .../component/splunk/SplunkConnectionFactory.java      |  1 +
 .../apache/camel/component/splunk/SplunkConsumer.java  |  1 +
 .../apache/camel/component/splunk/SplunkEndpoint.java  |  1 +
 .../apache/camel/component/splunk/SplunkProducer.java  |  1 +
 .../camel/component/splunk/event/SplunkEvent.java      |  1 +
 .../camel/component/splunk/support/DataWriter.java     |  1 +
 .../component/splunk/support/SplunkDataReader.java     |  1 +
 .../component/splunk/support/SplunkDataWriter.java     |  1 +
 .../splunk/support/SplunkResultProcessor.java          |  1 +
 .../component/splunk/support/StreamDataWriter.java     |  1 +
 .../component/splunk/support/SubmitDataWriter.java     |  1 +
 .../camel/component/splunk/support/TcpDataWriter.java  |  1 +
 .../ROOT/pages/camel-4x-upgrade-guide-4_19.adoc        |  4 ++++
 .../camel/builder/endpoint/StaticEndpointBuilders.java |  2 ++
 .../endpoint/dsl/SplunkEndpointBuilderFactory.java     |  2 ++
 26 files changed, 38 insertions(+), 6 deletions(-)

diff --git a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/splunk.json b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/splunk.json
index 2122b7245d5b7..64f6eb4d9dc63 100644
--- a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/splunk.json
+++ b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/splunk.json
@@ -4,7 +4,7 @@
     "name": "splunk",
     "title": "Splunk",
     "description": "Publish or search for events in Splunk.",
-    "deprecated": false,
+    "deprecated": true,
     "firstVersion": "2.13.0",
     "label": "iot,monitoring",
     "javaType": "org.apache.camel.component.splunk.SplunkComponent",
diff --git a/components/camel-splunk/pom.xml b/components/camel-splunk/pom.xml
index 2c7c2504dffa3..021a099a2cecf 100644
--- a/components/camel-splunk/pom.xml
+++ b/components/camel-splunk/pom.xml
@@ -26,7 +26,7 @@
         <version>4.19.0-SNAPSHOT</version>
     </parent>
 
-    <name>Camel :: Splunk</name>
+    <name>Camel :: Splunk (deprecated)</name>
     <artifactId>camel-splunk</artifactId>
     <description>Camel :: Splunk component</description>
     <packaging>jar</packaging>
diff --git a/components/camel-splunk/src/generated/resources/META-INF/org/apache/camel/component/splunk/splunk.json b/components/camel-splunk/src/generated/resources/META-INF/org/apache/camel/component/splunk/splunk.json
index 2122b7245d5b7..64f6eb4d9dc63 100644
--- a/components/camel-splunk/src/generated/resources/META-INF/org/apache/camel/component/splunk/splunk.json
+++ b/components/camel-splunk/src/generated/resources/META-INF/org/apache/camel/component/splunk/splunk.json
@@ -4,7 +4,7 @@
     "name": "splunk",
     "title": "Splunk",
     "description": "Publish or search for events in Splunk.",
-    "deprecated": false,
+    "deprecated": true,
     "firstVersion": "2.13.0",
     "label": "iot,monitoring",
     "javaType": "org.apache.camel.component.splunk.SplunkComponent",
diff --git a/components/camel-splunk/src/generated/resources/META-INF/services/org/apache/camel/component.properties b/components/camel-splunk/src/generated/resources/META-INF/services/org/apache/camel/component.properties
index ff9c759696771..e515256d4b189 100644
--- a/components/camel-splunk/src/generated/resources/META-INF/services/org/apache/camel/component.properties
+++ b/components/camel-splunk/src/generated/resources/META-INF/services/org/apache/camel/component.properties
@@ -3,5 +3,5 @@ components=splunk
 groupId=org.apache.camel
 artifactId=camel-splunk
 version=4.19.0-SNAPSHOT
-projectName=Camel :: Splunk
+projectName=Camel :: Splunk (deprecated)
 projectDescription=Camel :: Splunk component
diff --git a/components/camel-splunk/src/main/docs/splunk-component.adoc b/components/camel-splunk/src/main/docs/splunk-component.adoc
index cb670fd0253c3..56dbc082e9108 100644
--- a/components/camel-splunk/src/main/docs/splunk-component.adoc
+++ b/components/camel-splunk/src/main/docs/splunk-component.adoc
@@ -1,10 +1,11 @@
-= Splunk Component
+= Splunk Component (deprecated)
 :doctitle: Splunk
 :shortname: splunk
 :artifactid: camel-splunk
 :description: Publish or search for events in Splunk.
 :since: 2.13
-:supportlevel: Stable
+:supportlevel: Stable-deprecated
+:deprecated: *deprecated*
 :tabs-sync-option:
 :component-header: Both producer and consumer are supported
 //Manually maintained attributes
@@ -14,6 +15,11 @@
 
 *{component-header}*
 
+[NOTE]
+====
+This component is deprecated since Camel 4.19 and will be removed in a future release.
+====
+
 The Splunk component provides access to
 http://docs.splunk.com/Documentation/Splunk/latest[Splunk] using the
 Splunk provided https://github.com/splunk/splunk-sdk-java[client] api,
diff --git a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/ConsumerType.java b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/ConsumerType.java
index d949bcfc4f1ad..0423e91046bf8 100644
--- a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/ConsumerType.java
+++ b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/ConsumerType.java
@@ -16,6 +16,7 @@
  */
 package org.apache.camel.component.splunk;
 
+@Deprecated(since = "4.19")
 public enum ConsumerType {
     NORMAL,
     REALTIME,
diff --git a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/DefaultSplunkConfigurationFactory.java b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/DefaultSplunkConfigurationFactory.java
index f0b10575a64d4..d0f87302e7dbb 100644
--- a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/DefaultSplunkConfigurationFactory.java
+++ b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/DefaultSplunkConfigurationFactory.java
@@ -20,6 +20,7 @@
 
 import org.apache.camel.util.ObjectHelper;
 
+@Deprecated(since = "4.19")
 public class DefaultSplunkConfigurationFactory implements SplunkConfigurationFactory {
 
     @Override
diff --git a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/ProducerType.java b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/ProducerType.java
index 1b659252d6c15..ea7c1b6289fd5 100644
--- a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/ProducerType.java
+++ b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/ProducerType.java
@@ -16,6 +16,7 @@
  */
 package org.apache.camel.component.splunk;
 
+@Deprecated(since = "4.19")
 public enum ProducerType {
     TCP,
     SUBMIT,
diff --git a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkComponent.java b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkComponent.java
index b4e46948b212d..146654d1094ec 100644
--- a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkComponent.java
+++ b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkComponent.java
@@ -27,6 +27,7 @@
  * Represents the component that manages {@link SplunkEndpoint}.
  */
 @Component("splunk")
+@Deprecated(since = "4.19")
 public class SplunkComponent extends HealthCheckComponent {
 
     @Metadata(label = "advanced")
diff --git a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkConfiguration.java b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkConfiguration.java
index 1ab38c48ed10b..bea3549ad99b1 100644
--- a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkConfiguration.java
+++ b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkConfiguration.java
@@ -25,6 +25,7 @@
 import org.apache.camel.util.ObjectHelper;
 
 @UriParams
+@Deprecated(since = "4.19")
 public class SplunkConfiguration {
 
     private SplunkConnectionFactory connectionFactory;
diff --git a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkConfigurationFactory.java b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkConfigurationFactory.java
index 17b93fd36a0ec..5b58e6a6ad04f 100644
--- a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkConfigurationFactory.java
+++ b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkConfigurationFactory.java
@@ -18,6 +18,7 @@
 
 import java.util.Map;
 
+@Deprecated(since = "4.19")
 public interface SplunkConfigurationFactory {
 
     SplunkConfiguration parseMap(Map<String, Object> parameters);
diff --git a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkConnectionFactory.java b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkConnectionFactory.java
index c9119d3b4b0f7..8c48f1e945839 100644
--- a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkConnectionFactory.java
+++ b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkConnectionFactory.java
@@ -32,6 +32,7 @@
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+@Deprecated(since = "4.19")
 public class SplunkConnectionFactory {
     private static final Logger LOG = LoggerFactory.getLogger(SplunkConnectionFactory.class);
 
diff --git a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkConsumer.java b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkConsumer.java
index c97e35d048d6d..93910e59a8d19 100644
--- a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkConsumer.java
+++ b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkConsumer.java
@@ -36,6 +36,7 @@
 /**
  * The Splunk consumer.
  */
+@Deprecated(since = "4.19")
 public class SplunkConsumer extends ScheduledBatchPollingConsumer {
 
     private static final Logger LOG = LoggerFactory.getLogger(SplunkConsumer.class);
diff --git a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkEndpoint.java b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkEndpoint.java
index 1fe381a91385a..d119ea56424ce 100644
--- a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkEndpoint.java
+++ b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkEndpoint.java
@@ -40,6 +40,7 @@
  */
 @UriEndpoint(firstVersion = "2.13.0", scheme = "splunk", title = "Splunk", syntax = "splunk:name",
              category = { Category.IOT, Category.MONITORING })
+@Deprecated(since = "4.19")
 public class SplunkEndpoint extends ScheduledPollEndpoint implements EndpointServiceLocation {
 
     private static final Logger LOG = LoggerFactory.getLogger(SplunkEndpoint.class);
diff --git a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkProducer.java b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkProducer.java
index 31035849ef6d5..015cae39c6a24 100644
--- a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkProducer.java
+++ b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/SplunkProducer.java
@@ -32,6 +32,7 @@
 /**
  * The Splunk producer.
  */
+@Deprecated(since = "4.19")
 public class SplunkProducer extends DefaultProducer {
     private static final Logger LOG = LoggerFactory.getLogger(SplunkProducer.class);
     private SplunkEndpoint endpoint;
diff --git a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/event/SplunkEvent.java b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/event/SplunkEvent.java
index 72ca59756f1c5..0b20649affc0f 100644
--- a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/event/SplunkEvent.java
+++ b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/event/SplunkEvent.java
@@ -24,6 +24,7 @@
 import org.joda.time.format.DateTimeFormat;
 import org.joda.time.format.DateTimeFormatter;
 
+@Deprecated(since = "4.19")
 public class SplunkEvent implements Serializable {
 
     // ----------------------------------
diff --git a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/DataWriter.java b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/DataWriter.java
index 425e748b19214..a45e320f2c15c 100644
--- a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/DataWriter.java
+++ b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/DataWriter.java
@@ -18,6 +18,7 @@
 
 import org.apache.camel.component.splunk.event.SplunkEvent;
 
+@Deprecated(since = "4.19")
 public interface DataWriter {
     void write(SplunkEvent data) throws Exception;
 
diff --git a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/SplunkDataReader.java b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/SplunkDataReader.java
index 985bb4b6dfe1d..706281dfc3ebc 100644
--- a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/SplunkDataReader.java
+++ b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/SplunkDataReader.java
@@ -50,6 +50,7 @@
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+@Deprecated(since = "4.19")
 public class SplunkDataReader {
     private static final Logger LOG = LoggerFactory.getLogger(SplunkDataReader.class);
     private static final String DATE_FORMAT = "MM/dd/yy HH:mm:ss:SSS";
diff --git a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/SplunkDataWriter.java b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/SplunkDataWriter.java
index 36b8d28aaf280..0ef0ad019f0d4 100644
--- a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/SplunkDataWriter.java
+++ b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/SplunkDataWriter.java
@@ -32,6 +32,7 @@
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+@Deprecated(since = "4.19")
 public abstract class SplunkDataWriter implements DataWriter {
     private static final Logger LOG = LoggerFactory.getLogger(SplunkDataWriter.class);
 
diff --git a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/SplunkResultProcessor.java b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/SplunkResultProcessor.java
index 8e67aaacedcd5..01946e320d02f 100644
--- a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/SplunkResultProcessor.java
+++ b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/SplunkResultProcessor.java
@@ -21,6 +21,7 @@
 /**
  * Processes splunk results
  */
+@Deprecated(since = "4.19")
 public interface SplunkResultProcessor {
     void process(SplunkEvent splunkData);
 }
diff --git a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/StreamDataWriter.java b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/StreamDataWriter.java
index 55d7bef0141df..bbebbc459ef30 100644
--- a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/StreamDataWriter.java
+++ b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/StreamDataWriter.java
@@ -28,6 +28,7 @@
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+@Deprecated(since = "4.19")
 public class StreamDataWriter extends SplunkDataWriter {
     private static final Logger LOG = LoggerFactory.getLogger(StreamDataWriter.class);
 
diff --git a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/SubmitDataWriter.java b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/SubmitDataWriter.java
index 1d773ed8400a6..754c062c94888 100644
--- a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/SubmitDataWriter.java
+++ b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/SubmitDataWriter.java
@@ -25,6 +25,7 @@
 import com.splunk.Service;
 import org.apache.camel.component.splunk.SplunkEndpoint;
 
+@Deprecated(since = "4.19")
 public class SubmitDataWriter extends SplunkDataWriter {
     private String index;
 
diff --git a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/TcpDataWriter.java b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/TcpDataWriter.java
index f60f7228f6219..3f74d827aa472 100644
--- a/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/TcpDataWriter.java
+++ b/components/camel-splunk/src/main/java/org/apache/camel/component/splunk/support/TcpDataWriter.java
@@ -25,6 +25,7 @@
 import com.splunk.TcpInput;
 import org.apache.camel.component.splunk.SplunkEndpoint;
 
+@Deprecated(since = "4.19")
 public class TcpDataWriter extends SplunkDataWriter {
     private int port;
     private Optional<Integer> localPort;
diff --git a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_19.adoc b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_19.adoc
index 2e505a6ecd73e..1be95d53eb4de 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_19.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_19.adoc
@@ -554,6 +554,10 @@ All properties default to `0`, which means the Apache MINA SSHD defaults are use
 
 The older logic used for MDC (enabled via `camel.main.useMdcLogging = true`) is deprecated in favor of `camel-mdc` component.
 
+=== camel-splunk (Deprecation)
+
+The `camel-splunk` component is deprecated. The Splunk Java SDK it depends on is no longer actively maintained.
+
 === camel-tracing (Deprecation)
 
 The `camel-tracing` and related components (`camel-opentelemetry` and `camel-observation`) are now deprecated. You should move your implementation to the newer `camel-telemetry` components (`camel-opentelemetry2` and `camel-micrometer-observability`). We have implemented these new components in order to fix certain design flaws (mainly, span duplications) identified in the older components.
diff --git a/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/StaticEndpointBuilders.java b/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/StaticEndpointBuilders.java
index 408f13ccb8c84..f4adbc3469de7 100644
--- a/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/StaticEndpointBuilders.java
+++ b/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/StaticEndpointBuilders.java
@@ -15149,6 +15149,7 @@ public static SolrEndpointBuilderFactory.SolrEndpointBuilder solr(String compone
      * @param path name
      * @return the dsl builder
      */
+    @Deprecated
     public static SplunkEndpointBuilderFactory.SplunkEndpointBuilder splunk(String path) {
         return splunk("splunk", path);
     }
@@ -15170,6 +15171,7 @@ public static SplunkEndpointBuilderFactory.SplunkEndpointBuilder splunk(String p
      * @param path name
      * @return the dsl builder
      */
+    @Deprecated
     public static SplunkEndpointBuilderFactory.SplunkEndpointBuilder splunk(String componentName, String path) {
         return SplunkEndpointBuilderFactory.endpointBuilder(componentName, path);
     }
diff --git a/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/SplunkEndpointBuilderFactory.java b/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/SplunkEndpointBuilderFactory.java
index 29a9d07289edc..b3e9176e03c13 100644
--- a/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/SplunkEndpointBuilderFactory.java
+++ b/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/SplunkEndpointBuilderFactory.java
@@ -1860,6 +1860,7 @@ public interface SplunkBuilders {
          * @param path name
          * @return the dsl builder
          */
+        @Deprecated
         default SplunkEndpointBuilder splunk(String path) {
             return SplunkEndpointBuilderFactory.endpointBuilder("splunk", path);
         }
@@ -1881,6 +1882,7 @@ default SplunkEndpointBuilder splunk(String path) {
          * @param path name
          * @return the dsl builder
          */
+        @Deprecated
         default SplunkEndpointBuilder splunk(String componentName, String path) {
             return SplunkEndpointBuilderFactory.endpointBuilder(componentName, path);
         }

From f18dcfbc8e5e65c167d0287ce16db47a3feb5f65 Mon Sep 17 00:00:00 2001
From: Andrea Cosentino <ancosen@gmail.com>
Date: Tue, 31 Mar 2026 09:05:29 +0200
Subject: [PATCH 2/2] CAMEL-23184: Add migration guidance from camel-splunk to
 camel-splunk-hec

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .../src/main/docs/splunk-component.adoc        |  3 +++
 .../pages/camel-4x-upgrade-guide-4_19.adoc     | 18 ++++++++++++++++++
 2 files changed, 21 insertions(+)

diff --git a/components/camel-splunk/src/main/docs/splunk-component.adoc b/components/camel-splunk/src/main/docs/splunk-component.adoc
index 56dbc082e9108..cbf2a6f009806 100644
--- a/components/camel-splunk/src/main/docs/splunk-component.adoc
+++ b/components/camel-splunk/src/main/docs/splunk-component.adoc
@@ -18,6 +18,9 @@
 [NOTE]
 ====
 This component is deprecated since Camel 4.19 and will be removed in a future release.
+For event ingestion (producer) use cases, consider migrating to xref:splunk-hec-component.adoc[Splunk HEC],
+which uses the standard HTTP Event Collector and has no dependency on the unmaintained Splunk Java SDK.
+Note that Splunk HEC is producer-only and does not support consumer (search) operations.
 ====
 
 The Splunk component provides access to
diff --git a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_19.adoc b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_19.adoc
index 1be95d53eb4de..b53ad5698b1cd 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_19.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_19.adoc
@@ -558,6 +558,24 @@ The older logic used for MDC (enabled via `camel.main.useMdcLogging = true`) is
 
 The `camel-splunk` component is deprecated. The Splunk Java SDK it depends on is no longer actively maintained.
 
+Users who only need to **send events to Splunk** can migrate to `camel-splunk-hec`, which uses the
+Splunk HTTP Event Collector (HEC) over standard HTTPS with no dependency on the Splunk Java SDK.
+
+However, `camel-splunk-hec` is a **producer-only** component. The following `camel-splunk` capabilities
+have no equivalent in `camel-splunk-hec`:
+
+* **Consumer (search)**: normal searches, real-time searches, and saved-search execution are not supported.
+* **TCP streaming**: the `tcp` producer publish type (raw socket streaming to a Splunk TCP input) is not available.
+* **SUBMIT and STREAM publish types**: only HEC-based ingestion is supported.
+
+If your routes only produce events to Splunk (using the `submit` or `stream` publish types), switching
+to `camel-splunk-hec` is straightforward — configure the HEC token, index, sourceType, and source on
+the endpoint. If your routes consume (search) data from Splunk, there is currently no direct replacement
+within Apache Camel, and you will need to use the Splunk REST API directly or keep using `camel-splunk`
+until it is removed.
+
+NOTE: `camel-splunk-hec` is NOT deprecated and remains actively maintained.
+
 === camel-tracing (Deprecation)
 
 The `camel-tracing` and related components (`camel-opentelemetry` and `camel-observation`) are now deprecated. You should move your implementation to the newer `camel-telemetry` components (`camel-opentelemetry2` and `camel-micrometer-observability`). We have implemented these new components in order to fix certain design flaws (mainly, span duplications) identified in the older components.