Elasticsearch is a distributed, free and open search and analytics engine for all types of data, including textual, numerical, geospatial, structured, and unstructured.
View Elasticsearch's documentation.
|Sync Type||Description||Supported Sync Modes||API Reference|
|Index documents||Sync data from any source to an Elasticsearch index||Upsert, Update||Index API|
Connect to Elasticsearch
Go to the Destinations overview page and click the Add destination button. Select Elasticsearch and click Continue. You can then authenticate Hightouch to Elasticsearch with an Elasticsearch Cloud ID and API key.
You can find your Cloud ID in your Elasticsearch deployment. To generate an API key, follow these steps in the Elasticsearch docs.
Once you've set up your Elasticsearch destination and have a model to pull data from, you can set up your sync configuration to begin syncing data. Go to the Syncs overview page and click the Add sync button to begin. Then, select the relevant model and the Elasticsearch destination you want to sync to.
Syncing to an index
An Elasticsearch index is the place where the data used by a search engine is stored. You can use Hightouch to update individual documents in an index.
To match rows from your model to documents in Elasticsearch, you need to select a model column and corresponding Elasticsearch field. You can match on any Elasticsearch field.
You can sync data to both existing fields and fields that don't yet exist in Elasticsearch. If you send data to a field that doesn't exist yet, Hightouch adds the field and automatically detects its type.
The delete behavior you select dictates what to do when a row no longer appears in your model's query results. You have the following options:
|Do nothing||Keep the document in Elasticsearch|
|Clear||Keep the document in Elasticsearch, but set mapped fields to empty|
|Delete||Remove the document from Elasticsearch|
Tips and troubleshooting
To date, our customers haven't experienced any errors while using this destination. If you run into any issues, please don't hesitate to . We're here to help.
Hightouch provides complete visibility into the API calls made during each of your sync runs. We recommend reading our article on debugging tips and tricks to learn more.
Hightouch can alert you of sync issues via Slack, PagerDuty, SMS, or email. For details, please visit our article on alerting.