> For the complete documentation index, see [llms.txt](https://docs.cloudfabrix.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudfabrix.io/rda/cfxdx-datasource-integrations/elasticsearch.md).
# Elasticsearch
Elasticsearch is a search engine based on the Lucene library. It provides a distributed, multitenant-capable full-text search engine with an HTTP web interface and schema-free JSON documents.
CloudFabrix RDA provides out of the box integration for Elasticsearch through it's API interface. As part of the integration, it provides an ability to query the data from Elasticsearch indice(s), update or append the data into an Elasticsearch indice. Below Elastichsearch distributions are supported.
* Elasticsearch Commercial & Open-source versions
* Opendistro & Opensearch from AWS versions
**Elasticsearch Permissions:** Below permissions are required as a prerequisite.
* read: To read, search/filter the data from indices
* write: To create, update & append data into indices (optional)
## Adding Elasticsearch as Datasource/Extension in '**RDA**':
Elasticsearch or any other datasource/extension's configuration is configured in RDA's user interface. Login into RDA's user interface using a browser.
**https\://\:9998**
Under '**Notebook**', click on '**CFXDX Python 3**' box
In the '**Notebook**' command box, type **`botadmin()`** and **`alt (or option) + Enter`** to open datasource administration menu.
Click on '**Add**' menu and under **Type** drop down, select **`elasticsearch_v2`**
{% hint style="info" %}
Note: Elasticsearch extension type**`elasticsearch`**is deprecated, please use**`elasticsearch_v2`**instead.
{% endhint %}
* **Type**: Datasource/Extension type. In this context, it is '**elasticsearch\_v2**'
* **name**: Datasource/Extension label which should be unique within the RDA
* **Hostname:** Elasticsearch's IP Address or DNS name
* **URL Prefix:** Use this option when Elasticsearch is behind a load balancer and it has additional path to the root (ex: /elasticsearch) - Optional
* **Username**: Username that has read/write permissions to Elasticsearch indices (optional)
* **Password:** User account's password (optional)
* **HTTP(s) Port:** default is 9200, but can be changed to 443 or to other port
* **Protocol:** API integration over HTTP/HTTPs protocol
* **Timeout(seconds):** HTTP response timeout in seconds, default value is 30 seconds
For the details on Elasticsearch (v2) inventory data collection bots, please refer [**CloudFabrix RDA Bot documentation.**](https://bot-docs.cloudfabrix.io/Bots/elasticsearch_v2/)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.cloudfabrix.io/rda/cfxdx-datasource-integrations/elasticsearch.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.