|
| 1 | +--- |
| 2 | +applies_to: |
| 3 | + stack: |
| 4 | + serverless: |
| 5 | +--- |
| 6 | + |
| 7 | +# Content connectors |
| 8 | + |
| 9 | +Elastic's content connectors allow you to extract, transform, index, and sync data from third-party applications including Github, Jira, Teams, Google Drive, Slack, email, and more ([view all connectors](elasticsearch://reference/search-connectors/index.md)). |
| 10 | + |
| 11 | +## Managed vs self-managed connectors |
| 12 | + |
| 13 | +Content connectors are available in two deployment options: you can run them yourself or let Elastic run them within your managed deployment on {{ecloud}}. |
| 14 | + |
| 15 | +### Elastic managed connectors |
| 16 | +```yaml {applies_to} |
| 17 | +stack: preview 9.1 |
| 18 | +deployment: |
| 19 | + self: unavailable |
| 20 | +serverless: |
| 21 | + security: preview |
| 22 | +``` |
| 23 | +
|
| 24 | +Elastic managed connectors are deployed within your managed Elastic environment. These connectors: |
| 25 | +- Require no infrastructure management |
| 26 | +- Offer simplified setup and maintenance |
| 27 | +- Do not support customization |
| 28 | +- Only send data to the serverless/hosted deployment they're deployed within |
| 29 | +
|
| 30 | +### Self-managed connectors |
| 31 | +Self-managed connectors run on your own infrastructure, independent of where your {{es}} instance is running. These connectors: |
| 32 | +- Require you to deploy the connector service (Python) on your infrastructure |
| 33 | +- Can send data to any {{es}} instance (managed or self-managed) |
| 34 | +- Can be customized |
| 35 | +
|
| 36 | +## Setup |
| 37 | +
|
| 38 | +To learn about setup for self-managed connectors, refer to [Self-managed connectors](elasticsearch://reference/search-connectors/self-managed-connectors.md). To set up an Elastic managed connector: |
| 39 | +
|
| 40 | +1. Use the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md) to find "Content conectors". |
| 41 | +1. Click **New Connector**. |
| 42 | +1. Under **Connector**, select your desired data source. |
| 43 | +1. Under **Setup**, select your deployment method. |
| 44 | +1. Under **Configure index & API key**, click **Generate configuration**. After a few seconds, this will create a new connector and a new index for its data, and display their names and IDs. You can click their names to view details about each. |
| 45 | +1. Click **Next** to continue to the **Configuration** page. This is where you can select details related to your specific data source. For more information about configuring your selected data source, follow the link on the left to the **Connector reference**. |
| 46 | +1. When configuration is complete, click **Next**. The **Finish up** page appears. Here you can set up recurring connector syncs, run a manual sync, or use queries and dev tools to interact with your data. Each sync updates the data in the connector's {{es}} index. You can also manage the connector. |
| 47 | +
|
| 48 | +
|
| 49 | +## Manage a connector |
| 50 | +
|
| 51 | +To manage an existing connector: |
| 52 | +
|
| 53 | +1. Use the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md) to find "Content connectors". |
| 54 | +1. Click the connector you want to manage to open its settings page, which has six tabs: |
| 55 | + - **Overview**: View general information such as the connector's name, ID, status, pipeline, and content sync history. Manage the connector's pipeline and attached index. |
| 56 | + - **Documents**: View data from the connector. |
| 57 | + - **Mappings**: Update index mappings for the connector's data. |
| 58 | + - **Sync rules**: Manage basic and advanced [sync rules](elasticsearch://reference/search-connectors/es-sync-rules.md) to control which documents are synced from your third-party data source. |
| 59 | + - **Scheduling**: Define when data from this connector gets synced, and set up document level security. A `Full content sync` deletes existing data in your index before fetching from your data source again. An `Incremental content sync` fetches updated data only, without deleting existing data. |
| 60 | + - **Configuration**: Edit the connector's data source-specific configuration. |
0 commit comments