Aiven services are managed from Aiven web console. First login to the console with your email address and password and you will be automatically taken to the "Services" view that shows all the services of the currently selected project.

Projects allow organizing groups of services under different topics and each project can for example have different billing settings. An empty project is created for you automatically when you sign-up and the free credits are attached to this project. You can create new projects by clicking the project name in the left side-bar and selecting "Create a new project". The same menu can also be used to switch between projects.

To get started with Aiven Elasticsearch, first click the "Create a new service" button.

The dialog that opens allows you to specify the main service properties:

  • Service name: A short name for the service used to distinguish it from other services. A random name is provided, but you can type in a more friendly name.
  • Service type: Select "Elasticsearch".
  • Plan: How many servers and what kind of memory/CPU/disk resources will be allocated to run your service. Note that the single-node "Hobbyist" and "Startup" plans are not recommended for applications where durability of the data is essential. Select one of the "high availability" plans for speedy recovery and best protection against data loss against critical node failures.
  • Cloud: Which cloud and region to run the service on. Note that the pricing of the same service may differ between cloud providers and their regions.

After making the selections, click the "Create" button and you will be taken back to the service list view and the newly created service is shown with an indicator that it is being created.

Click the service name in the list and the "Overview" information page for the service opens. This view shows the connection parameters for your service, its current status and allows making changes to the service.

The "Status" indicator will say "REBUILDING" while the service is being created for you. Once the service is up and running, the light will change to green and it will say "RUNNING". Note that while typically services start in a couple of minutes, the performance between clouds varies and it can take longer under some circumstances.



Kibana is a graphical search tool for Elasticsearch. Each Aiven Elasticsearch service comes with the Kibana interface. If you click on the Kibana link you'll be taken to the Kibana welcome page allowing you to search through your cluster.

Python example

You can also try to access the new service programmatically with something like the following Python snippet:

from elasticsearch import Elasticsearch

es = Elasticsearch(service_uri, verify_certs=True, ca_certs=project_ca_certs)

print("Connected to Elasticsearch {} OK".format(service_uri))

doc = {
    "some_data": "mystring",
    "timestamp": datetime.datetime.now(),
}
index_name = "test_index"

es.index(index=index_name, doc_type="footype", id=1, body=doc)
print("Created ES index {}".format(index_name))

result = es.get(index=index_name, doc_type="footype", id=1)["_source"]
assert result["some_data"] == "mystring"
Did this answer your question?