MongoDB Source Kamelet Improvements

docs/modules/ROOT/pages/mongodb-source.adoc

@@ -5,7 +5,11 @@
 
 *Support Level for this Kamelet is: "Preview"*
 
-Consume documents from MongoDB
+Consume documents from MongoDB.
+
+If the persistentTailTracking option will be enabled, the consumer will keep track of the last consumed message and on the next restart, the consumption will restart from that message. In case of persistentTailTracking enabled, the tailTrackIncreasingField must be provided (by default it is optional).
+
+If the persistentTailTracking option won't be enabled, the consumer will consume the whole collection and wait in idle for new documents to consume.
 
 == Configuration Options
 
@@ -18,6 +22,8 @@ The following table summarizes the configuration options available for the `mong
 | *hosts {empty}* *| MongoDB Hosts| Comma separated list of MongoDB Host Addresses in host:port format.| string| | 
 | *password {empty}* *| MongoDB Password| User password for accessing MongoDB.| string| | 
 | *username {empty}* *| MongoDB Username| Username for accessing MongoDB.| string| | 
+| persistentTailTracking| MongoDB Persistent Tail Tracking| Enable persistent tail tracking, which is a mechanism to keep track of the last consumed message across system restarts. The next time the system is up, the endpoint will recover the cursor from the point where it last stopped slurping records.| boolean| `false`| 
+| tailTrackIncreasingField| MongoDB Tail Track Increasing Field| Correlation field in the incoming record which is of increasing nature and will be used to position the tailing cursor every time it is generated.| string| | 
 |===
 
 NOTE: Fields marked with ({empty}*) are mandatory.

library/camel-kamelets-catalog/src/main/resources/kamelets/mongodb-source.kamelet.yaml

@@ -14,7 +14,11 @@ spec:
   definition:
     title: "MongoDB Source"
     description: |-
-      Consume documents from MongoDB
+      Consume documents from MongoDB.
+
+      If the persistentTailTracking option will be enabled, the consumer will keep track of the last consumed message and on the next restart, the consumption will restart from that message. In case of persistentTailTracking enabled, the tailTrackIncreasingField must be provided (by default it is optional).
+
+      If the persistentTailTracking option won't be enabled, the consumer will consume the whole collection and wait in idle for new documents to consume.
     required:
       - hosts
       - collection
@@ -46,6 +50,17 @@ spec:
         title: MongoDB Database
         description: Sets the name of the MongoDB database to target.
         type: string
+      persistentTailTracking:
+        title: MongoDB Persistent Tail Tracking
+        description: Enable persistent tail tracking, which is a mechanism to keep track of the last consumed message across system restarts. The next time the system is up, the endpoint will recover the cursor from the point where it last stopped slurping records.
+        type: boolean
+        x-descriptors:
+        - 'urn:alm:descriptor:com.tectonic.ui:checkbox'
+        default: false
+      tailTrackIncreasingField:
+        title: MongoDB Tail Track Increasing Field
+        description: Correlation field in the incoming record which is of increasing nature and will be used to position the tailing cursor every time it is generated. 
+        type: string
   dependencies:
     - "camel:kamelet"
     - "camel:mongodb"
@@ -62,6 +77,8 @@ spec:
         password: "{{password}}"
         username: "{{username}}"
         database: "{{database}}"
+        persistentTailTracking: "{{persistentTailTracking}}"
+        tailTrackIncreasingField: "{{?tailTrackIncreasingField}}"
       steps:
       - marshal:
           json: {}

mongodb-source.kamelet.yaml

@@ -14,7 +14,11 @@ spec:
   definition:
     title: "MongoDB Source"
     description: |-
-      Consume documents from MongoDB
+      Consume documents from MongoDB.
+
+      If the persistentTailTracking option will be enabled, the consumer will keep track of the last consumed message and on the next restart, the consumption will restart from that message. In case of persistentTailTracking enabled, the tailTrackIncreasingField must be provided (by default it is optional).
+
+      If the persistentTailTracking option won't be enabled, the consumer will consume the whole collection and wait in idle for new documents to consume.
     required:
       - hosts
       - collection
@@ -46,6 +50,17 @@ spec:
         title: MongoDB Database
         description: Sets the name of the MongoDB database to target.
         type: string
+      persistentTailTracking:
+        title: MongoDB Persistent Tail Tracking
+        description: Enable persistent tail tracking, which is a mechanism to keep track of the last consumed message across system restarts. The next time the system is up, the endpoint will recover the cursor from the point where it last stopped slurping records.
+        type: boolean
+        x-descriptors:
+        - 'urn:alm:descriptor:com.tectonic.ui:checkbox'
+        default: false
+      tailTrackIncreasingField:
+        title: MongoDB Tail Track Increasing Field
+        description: Correlation field in the incoming record which is of increasing nature and will be used to position the tailing cursor every time it is generated. 
+        type: string
   dependencies:
     - "camel:kamelet"
     - "camel:mongodb"
@@ -62,6 +77,8 @@ spec:
         password: "{{password}}"
         username: "{{username}}"
         database: "{{database}}"
+        persistentTailTracking: "{{persistentTailTracking}}"
+        tailTrackIncreasingField: "{{?tailTrackIncreasingField}}"
       steps:
       - marshal:
           json: {}