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 @@ 4.19.0-SNAPSHOT - Camel :: Splunk + Camel :: Splunk (deprecated) camel-splunk Camel :: Splunk component jar 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..cbf2a6f009806 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,14 @@ *{component-header}* +[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 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 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 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..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 @@ -554,6 +554,28 @@ 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. + +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. 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); }