Skip to content

(DOCSP-43999) Promo admonition. #191

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 11 commits into from
Mar 4, 2025
5 changes: 5 additions & 0 deletions snooty.toml
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ toc_landing_pages = [
]

[constants]
atlas-sp = "Atlas Stream Processing"
connector = "MongoDB Kafka Connector"
connector-short = "Kafka Connector"
connector-long = "MongoDB Connector for Apache Kafka"
Expand All @@ -25,6 +26,8 @@ kafka-connect-long = "Confluent Kafka Connect"
avro-long = "Apache Avro"
avro = "Avro"
avro-converter = "Kafka Connect Avro Converter (Avro Converter)"
aws = ":abbr:`AWS (Amazon Web Services)`"
azure = "Microsoft Azure"
protobuf-converter = "Kafka Connect Protobuf Converter"
json-schema-converter = "Kafka Connect JSON Schema Converter"
connector_version = "1.14"
Expand All @@ -34,6 +37,7 @@ connector_version_github_tag = "master"
connector_kafka_version_major = "2"
connector_kafka_version_minor = "6"
connector_kafka_version_docs = "https://kafka.apache.org/{+connector_kafka_version_major+}{+connector_kafka_version_minor+}"
service = "Atlas"
sink-connector = "MongoDB Kafka sink connector"
source-connector = "MongoDB Kafka source connector"
sink-connector-title = "MongoDB Kafka Sink Connector"
Expand All @@ -59,3 +63,4 @@ jmx-port-mapping = "35000"
sandbox-directory = "kafka-edu/docs-examples/mongodb-kafka-base/"
win-sandbox-directory = "kafka-edu\\docs-examples\\mongodb-kafka-base\\"
cluster = "MongoDB cluster"
clusters = "MongoDB clusters"
9 changes: 9 additions & 0 deletions source/includes/atlas-sp.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
.. note::

{+atlas-sp+} provides MongoDB-native tooling to
continuously process streaming data, validate schemas, and
materialize views into either {+service+} database collections or Apache
Kafka topics.

To learn more about {+atlas-sp+}, see {+service+}
`Stream Processing <https://www.mongodb.com/docs/atlas/atlas-sp/overview/>`__.
15 changes: 2 additions & 13 deletions source/index.txt
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ MongoDB Kafka Connector
Security and Authentication </security-and-authentication>
Monitoring </monitoring>
Migrate from the Community Connector <migrate-from-kafka-connect-mongodb>
Compare Kafka Connector and Atlas Stream Processing <kafka-connector-atlas-stream-processing-comparison>
Troubleshooting </troubleshooting>
How to Contribute </contribute>
Issues & Help </issues-and-help>
Expand Down Expand Up @@ -47,19 +48,7 @@ offerings to host your {+kafka+} cluster and {+connector+}:
- To learn more about the MongoDB Source Connector, read the `documentation <https://docs.redpanda.com/current/deploy/deployment-option/cloud/managed-connectors/create-mongodb-source-connector/>`__.
- To learn more about the MongoDB Sink Connector, read the `documentation <https://docs.redpanda.com/current/deploy/deployment-option/cloud/managed-connectors/create-mongodb-sink-connector/>`__.

.. note::

You can also use Atlas Stream Processing, which is a MongoDB-native way to
process streaming data by using the MongoDB Query API. It transforms the way
that developers build modern applications.

Use Atlas Stream Processing to continuously process streaming data,
validate schemas, and materialize views into either Atlas database
collections or Apache Kafka topics.

To learn more about Atlas Stream Processing, see the
`Atlas Stream Processing <https://www.mongodb.com/products/platform/atlas-stream-processing>`__
product page or read the `docs <https://www.mongodb.com/docs/atlas/atlas-sp/overview/>`__.
.. include:: /includes/atlas-sp.rst

What's New
----------
Expand Down
2 changes: 2 additions & 0 deletions source/introduction.txt
Original file line number Diff line number Diff line change
Expand Up @@ -20,3 +20,5 @@ Read the following sections to learn about the {+connector+}, {+kafka-connect+},
- :doc:`Connect to MongoDB </introduction/connect>`
- :doc:`Data Formats </introduction/data-formats>`
- :doc:`Converters </introduction/converters>`

.. include:: /includes/atlas-sp.rst
83 changes: 83 additions & 0 deletions source/kafka-connector-atlas-stream-processing-comparison.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,83 @@
.. _kafka-connector-atlas-stream-processing-comparison:

===================================================
Compare {+connector-short+} and {+atlas-sp+}
===================================================

.. toctree::
:titlesonly:
:maxdepth: 2

.. contents:: On this page
:local:
:backlinks: none
:depth: 2
:class: singlecol

This section provides a comparison of the feature sets of the MongoDB
{+connector-short+} and {+atlas-sp+} to help you identify which tool
best suits your use case.

.. list-table::
:header-rows: 1
:widths: 20 40 40

* - Feature
- {+connector-short+}
- {+atlas-sp+}

* - Supported Stream Processing Capabilities
- To process streaming data handled by {+connector-short+}, you must
do one of the following:
- Extend the {+connector-short+} with SMTs or custom Java
- Use or write external tooling
- Available through the MongoDB aggregation framework, with
extensions specific to stream processing.

* - Installation
- Installation required either locally or on Confluent.
- No installation required.

* - Connectivity Tooling
- MongoDB Java Driver required.
- Connection managed by {+service+}.

* - Hosting
- Hosting required for your {+kafka+} cluster and the Kafka
Connector. Use partner services, such as Confluent Cloud, Amazon
Managed Streaming, or Redpanda Cloud when possible.
- Stream processing functionality fully managed by {+service+}.
Hosting required for your {+kafka+} cluster.

* - Windowing
- No support for windowing. You must manually configure windowing
with the Kafka Streams API or other external tooling.
- Support for highly configurable
:atlas:`windows <atlas-stream-processing/windows/>`.

* - Connection Type Support
- - Kafka clusters
- {+service+} databases
- {+service+} collections
- - Kafka clusters
- {+service+} {+clusters+}
- {+service+} databases
- {+service+} collections
- HTTPS

* - Security Features
- - SSL/TLS
- X.509
- {+aws+} IAM
- User must develop all other authentication tools
- - SSL/TLS
- X.509
- VPC Peering with {+aws+}
- Private Link with {+aws+} Confluent
- Private Link with {+aws+} MSK
- Private Link with {+azure+} Event Hub

* - Pricing
- Pricing dependent on your hosting provider.
- Hourly pricing managed by {+atlas-sp+}. Typical costs
approximately 25% of the cost of the {+connector-short+}.
2 changes: 2 additions & 0 deletions source/migrate-from-kafka-connect-mongodb.txt
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@ The following sections list the changes you must make to your Kafka
Connect sink connector configuration settings and custom classes to transition
to the {+sink-connector+}.

.. include:: /includes/atlas-sp.rst

Update Configuration Settings
-----------------------------

Expand Down
2 changes: 2 additions & 0 deletions source/quick-start.txt
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,8 @@
.. meta::
:keywords: get started, tutorial, code example

.. include:: /includes/atlas-sp.rst

Overview
--------

Expand Down
2 changes: 2 additions & 0 deletions source/sink-connector.txt
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,8 @@ Sink Connector
:depth: 2
:class: singlecol

.. include:: /includes/atlas-sp.rst

Overview
--------

Expand Down
2 changes: 2 additions & 0 deletions source/source-connector.txt
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,8 @@ Source Connector
:depth: 2
:class: singlecol

.. include:: /includes/atlas-sp.rst

Overview
--------

Expand Down