This documentation contains work-in-progress information for future Elastic Stack and Cloud releases. Use the version selector to view supported release docs. It also contains some Elastic Cloud serverless information. Check out our serverless docs for more details.
« Elastic Zoom connector reference Running from a Docker container »
Elastic Docs ›Elasticsearch Guide [8.16] ›Ingest content with Elastic connectors

Self-managed connectors

edit

Self-managed connectors

edit

Naming history

Self-managed connectors were initially known as "connector clients". You might find this term in older documentation.

Self-managed Elastic connectors are run on your own infrastructure. This means they run outside of your Elastic deployment.

You can run the connectors service from source or from a Docker container.

We also have a quickstart option using Docker Compose, to spin up all the required services at once: Elasticsearch, Kibana, and the connectors service. Refer to Docker Compose quickstart for more information.

The following connectors are available as self-managed connectors:

Availability and Elastic prerequisites

edit

Self-managed connectors currently don’t support Windows. Use this compatibility matrix to check which operating systems are supported by self-managed connectors. Find this information under self-managed connectors on that page.

Expand for Elastic prerequisites information

Your Elastic deployment must include the following Elastic services:

  • Elasticsearch
  • Kibana

(A new Elastic Cloud deployment includes these services by default.)

To run self-managed connectors, your self-deployed connector service version must match your Elasticsearch version. For example, if you’re running Elasticsearch 8.10.1, your connector service should be version 8.10.1.x. Elastic does not support deployments running mismatched versions (except during upgrades).

As of 8.10.0 new self-managed connectors no longer require the Enterprise Search service. However, if you are upgrading connectors from versions earlier than 8.9, you’ll need to run Enterprise Search once to migrate your connectors to the new format. In future releases, you may still need to run Enterprise Search for the purpose of migrations or upgrades.

You must have access to Kibana and have write indices privileges for the .elastic-connectors index.

To use connector clients in a self-managed environment, you must deploy the connectors service.

Support and licensing requirements

Depending on how you use self-managed connectors, support and licensing requirements will vary.

Refer to the following subscriptions pages for details. Find your connector of interest in the Elastic Search section under Client Integrations:

Note the following information regarding support for self-managed connectors:

  • A converted but unmodified managed connector is supported by Elastic.
  • A converted but customized managed connector is not supported by Elastic.

Data source prerequisites

The first decision you need to make before deploying a connector is which third party service (data source) you want to sync to Elasticsearch. Note that each data source will have specific prerequisites you’ll need to meet to authorize the connector to access its data. For example, certain data sources may require you to create an OAuth application, or create a service account.

You’ll need to check the individual connector documentation for these details.

Deploy the connector service

edit

The connector service is a Python application that you must run on your own infrastructure when using self-managed connectors. The source code is hosted in the elastic/connectors repository.

You can run the connector service from source or use Docker:

Tutorials

edit

These examples use the PostgreSQL connector but the basic process is the same for all self-managed connectors.

Connector testing

edit

The connector framework enables you to run end-to-end (E2E) tests on your self-managed connectors, against a real data source.

To avoid tampering with a real Elasticsearch instance, E2E tests run an isolated Elasticsearch instance in Docker. Configuration values are set in your docker-compose.yml file. Docker Compose manages the setup of the development environment, including both the mock Elastic instance and mock data source.

E2E tests use default configuration values for the connector. Find instructions about testing in each connector’s documentation.

Connector framework

edit

The Elastic connector framework enables you to:

  • Customize existing self-managed connectors.
  • Build your own self-managed connectors.

Refer to Build and customize connectors for more information.

« Elastic Zoom connector reference Running from a Docker container »