Cross Cluster Connections in Search with OpenSearch

Learn about cross cluster connections in OCI Search with OpenSearch.

You can use cross cluster connections to search and analyze data across multiple OpenSearch clusters, enabling you to gain insights from distributed data sources. You to perform operations such as cross-cluster search, as if the data was from a single source.

Cross cluster connections are available by default with the Security plugin, but you need to configure each cluster to allow remote connections from other clusters. This involves setting up remote cluster connections and configuring access permissions.

Prerequisites

The user performing the cross cluster operation requires permissions for both the inbound and the outbound clusters.

For more information about required IAM policies and permission details for Search with OpenSearch, see Search with OpenSearch IAM Policies.

Limits and Considerations

  • You can configure a maximum of five clusters per tenancy for cross cluster connections.
  • Clusters can connect to other clusters with the same OpenSearch version or one version less.
  • Cross cluster connections are supported for clusters within the same OC1 region, or across all regions within the OC1 realm.

Configuring Cross Cluster Connections

See the following topics for working with cross cluster connections for a cluster:

Performing Cross Cluster Search

The user performing a cross cluster search requires OpenSearch permissions to query both the outbound cluster and the inbound cluster.

The following is an example of a cross cluster search query:

curl -X GET "https://<outbound_cluster_opensearch_private_IP>:9200/<inbound_cluster_alias>:<index_name>/_search?q=title:Kubernetes&pretty"

For more information, see Cross-cluster search.