Get started with Aiven for OpenSearch®
Learn how to use Aiven for OpenSearch®, create a service, secure access, manage indices, and explore your data.
Aiven for OpenSearch® is a fully managed OpenSearch service designed for reliability, scalability, and security. It includes OpenSearch Dashboards for data visualization and supports integrations for logs and monitoring.
Prerequisites
Ensure you have the following before getting started:
- Console
- API
- CLI
- Terraform
- Access to the Aiven Console
- Aiven CLI installed
- A personal token
Create an Aiven for OpenSearch® service
- Console
- API
- CLI
- Terraform
-
In your project, click Services.
-
Click Create service.
-
Select OpenSearch®.
-
Select a Cloud.
-
Select a Plan.
noteThe plans available can vary between cloud providers and regions for the same service.
-
In the Service details, enter a name for your service.
-
Optional: Add service tags.
-
In the Service summary, click Create service.
The status of the service is Rebuilding during its creation. When the status is Running, you can start using the service. This typically takes a couple of minutes and can vary between cloud providers and regions.
Create the service using the Aiven API, run:
curl -X POST https://api.aiven.io/v1/project/<project-name>/service \
-H "Authorization: Bearer <api-token>" \
-H "Content-Type: application/json" \
-d '{
"cloud": "google-europe-west1",
"plan": "startup-4",
"service_name": "example-opensearch",
"service_type": "opensearch"
}'
Parameters:
<project-name>: Your project name.<api-token>: Your API token.
Create the service using the Aiven CLI, run:
avn service create <service-name> \
--service-type opensearch \
--cloud <cloud-region> \
--plan <service-plan>
Parameters:
<service-name>: Name of your service (for example,my-opensearch).<cloud-region>: Deployment region (for example,google-europe-west1).<service-plan>: Subscription plan (for example,startup-4).
The following example files are also available in the Aiven Terraform Provider repository on GitHub.
-
Create a file named
provider.tfand add the following:Loading... -
Create a file named
service.tfand add the following:Loading... -
Create a file named
variables.tfand add the following:Loading... -
Create the
terraform.tfvarsfile and add the values for your token and project name.
To apply your Terraform configuration:
-
Initialize Terraform by running:
terraform initThe output is similar to the following:
Initializing the backend...
Initializing provider plugins...
- Finding aiven/aiven versions matching ">= 4.0.0, < 5.0.0"...
- Installing aiven/aiven v4.9.2...
- Installed aiven/aiven v4.9.2
...
Terraform has been successfully initialized!
... -
To create an execution plan and preview the changes, run:
terraform plan -
To deploy your changes, run:
terraform apply --auto-approve