Get started with Aiven for Metrics

Get started with Aiven for Metrics by creating your service using the Aiven Console or Aiven CLI.

note

Aiven for Metrics is not currently available on Azure or Google Cloud Marketplace.

Create a service

Console

1. In your project, click Services.

2. Click Create service.

3. Select Thanos Metrics.

4. Enter a name for your service.

   important

   You cannot change the name after you create the service.

5. Optional: Add tags.

6. Select the cloud provider, region, and plan.

   note

   Available plans and pricing for the same service can vary between cloud providers and regions.

7. Optional: Add disk storage.

8. 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 couple of minutes and can vary between cloud providers and regions.

CLI

The Aiven CLI provides a simple and efficient way to create an Aiven for Metrics service. If you prefer creating a new service from the CLI:

1. Determine the service plan, cloud provider, and region to use for your Aiven for Metrics service.

2. Run the following command to create an Aiven for Metrics service named metrics-demo:

   avn service create metrics-demo   \
    --service-type thanos            \
    --cloud aws-europe-west1         \
    --plan startup-4                 \
    --project PROJECT_NAME

   Where PROJECT_NAME is the name of your Aiven project.

To see:

• A full list of default flags, run avn service create -h
• Type-specific options, run avn service types -v

Terraform

The following example files are also available in the Aiven Terraform Provider repository on GitHub.

1. Create a file named provider.tf and add the following:

   Loading...

2. Create a file named service.tf and add the following:

   Loading...

3. Create a file named variables.tf and add the following:

   Loading...

4. Create a file named terraform.tfvars and add values for your token and Aiven project.

To apply your Terraform configuration:

1. Initialize Terraform by running:

   terraform init

   The 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!
   ...

2. To create an execution plan and preview the changes, run:

   terraform plan

3. To deploy your changes, run:

   terraform apply --auto-approve

Create service integrations

Integrate Aiven for Metrics with other Aiven services, such as OpenSearch for advanced queries or Grafana for visualization, or connect it with another Aiven for Metrics service for comprehensive monitoring. Set up integrations using the Aiven Console, Aiven CLI, or Aiven Terraform Provider.

The Aiven for Metrics integration example in GitHub shows you how to use the Aiven Terraform Provider to create and integrate Thanos Metrics with PostgreSQL and Grafana.