-
Notifications
You must be signed in to change notification settings - Fork 110
Creates content connectors page in security docs #2113
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
base: main
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change | ||||
---|---|---|---|---|---|---|
@@ -0,0 +1,36 @@ | ||||||
--- | ||||||
applies_to: | ||||||
stack: preview 9.1 | ||||||
serverless: preview | ||||||
--- | ||||||
|
||||||
# Content connectors | ||||||
|
||||||
Elastic's content connectors allow you to extract, transform, index, and sync data from third-party applications including Github, PagerDuty, Jira, OpsGenie, Teams, Google Drive, Slack, email, and more. To see a complete list of the available connectors, follow the setup instructions below. | ||||||
|
||||||
## Setup | ||||||
{{stack}} supports two deployment methods: Elastic managed, and self-managed. {{sec-serverless}} only supports Elastic managed deployments. Self-managed deployments require you to manage the {{elastic-agent}} that forwards data to Elastic and allow you to customize the connector's code, whereas Elastic managed deployments use agentless technology and do not allow customization. | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
Suggestion to avoid confusion with stack deployment models Reading this paragraph, I also wonder about what this page states: https://www.elastic.co/docs/reference/search-connectors/ "As of Elastic 9.0, managed connectors on Elastic Cloud Hosted are no longer available. All connectors must be self-managed." If I reconcile this paragraph with the sentence from that other page, that gives:
I think we should try to clarify, as I either misunderstood, or we're giving conflicting/partial information in our various pages. @leemthompo maybe you can help here? |
||||||
|
||||||
To learn about set up for self-managed connectors, refer to [Self managed connectors](elasticsearch://reference/search-connectors/self-managed-connectors.md). To set up an Elastic managed connector: | ||||||
|
||||||
- Use the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md) to find "Content conectors". | ||||||
- Click **New Connector**. | ||||||
- Under **Connector**, select your desired data source. | ||||||
- Under **Setup**, select your deployment method. | ||||||
- 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. | ||||||
- 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**. | ||||||
- 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. | ||||||
|
||||||
|
||||||
## Manage a connector | ||||||
|
||||||
To manage an existing connector: | ||||||
|
||||||
- Use the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md) to find "Content connectors". | ||||||
- Click the connector you want to manage to open its settings page, which has six tabs: | ||||||
- **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. | ||||||
- **Documents**: View data from the connector. | ||||||
- **Mappings**: Update index mappings for the connector's data. | ||||||
- **Sync rules**: Use EQL to select which documents from the connector you wish to save. By default, all documents are saved. | ||||||
- **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. | ||||||
- **Configuration**: Edit the connector's data source-specific configuration. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Link to list of connectors