VictoriaMetrics/docs/managed-victoriametrics/quickstart.md
Dmytro Kozlov d0df4f7c7f
docs/managed-victoriametrics: update documentation (#5135)
Co-authored-by: Ivan Yatskevich <ivan@yatskevich.com>
2023-10-16 02:02:42 +02:00

10 KiB
Raw Blame History

sort weight title menu aliases
2 2 Quick Start
docs
parent weight
managed 2
/managed-victoriametrics/quickstart.html

Quick Start in Managed VictoriaMetrics

Managed VictoriaMetrics is a database-as-a-service platform, where users can run the VictoriaMetrics that they know and love on AWS without the need to perform typical DevOps tasks such as proper configuration, monitoring, logs collection, access protection, software updates, backups, etc.

The document covers the following topics:

  1. Registration
  2. Adding a payment method
  3. Restoring a password
  4. Creating deployments
  5. Start writing and reading data
  6. Modifying an existing deployment

Registration

Start your registration process by visiting the Sign Up page.

There are two different methods to create an account:

  1. Create an account via Google Auth service;
  2. Create an account by filling in a registration form.

Create an account via Google Auth service:

  1. Click Continue with Google button on the Sign Up page

  2. Choose Google account you want to use for registration

  3. You will be automatically redirected to the main page of the Managed VictoriaMetrics

Create an account by filling in a registration form:

  1. Fill in your email, password and password confirmation on Sign Up page.

  2. All fields are required. Any errors will be shown in the interface, so it is easy to understand what should be adjusted.

  3. Press Create account button when all fields are filled in.

You will be redirected to the main page with a notification message to confirm your email.

You will also receive an email with a confirmation link as shown on the picture below:

It is necessary to confirm your email address. Otherwise, you won't be able to create a deployment.

After successful confirmation of your email address, you'll be able to create your first deployment or add a payment method.

Adding a payment method

  1. Navigate to a Billing page or click on Upgrade button as shown below:

  2. Choose a payment method

Pay with a card

  1. Click on an Add card panel and fill in all the fields in the form and press Add card button

  2. An error message will appear if a card us invalid

  3. Successfully added card will be shown on the page as follows:

When you need to unify your AWS billing, you can start a subscription on AWS Marketplace.

  1. Click on the Buy on AWS Marketplace panel:

  2. You will be redirected to the Managed VictoriaMetrics product page.
  3. Click on View purchase option button, and you will be redirected to an AWS login page or to a subscribe page on AWS Marketplace.

  4. Go to the Managed VictoriaMetrics product page and click Continue to Subscribe button:

  5. Press the Subscribe button:

  6. After that you will see a success message where you should click Set up your account button:

  7. You'll be redirected back to Managed VictoriaMetrics billing page:

Switching between payment methods

If both payment methods are added, it is possible to easily switch between them. Click on the radio button like on the picture below and confirm the change:

If the payment method was changed successfully, the following message will appear:

Password restoration

If you forgot your password, it can be restored in the following way:

  1. Click Forgot password? link on the Sign In page:

  2. Enter your email and click Reset password button:

  3. Follow the instructions sent to your email in order to get access to your Managed VictoriaMetrics account:

  4. Navigate to the Profile page by clicking the corresponding link in the top right corner:

  5. Enter a new password on the Profile page and press Save:

Creating deployments

On the Deployments page you will see a list of your existing deployments and will be able to manage them.

To create a deployment click on the button Create Deployment button:

On the opened screen, choose parameters of your new deployment:

  • Deployment type
    • Single - for affordable, performant single-node deployments;
    • Cluster - for highly available and multi-tenant deployments;
  • Region AWS region where deployment will run;
  • Desired storage capacity for storing metrics (you always can expand disk size later);
  • Retention period for stored metrics.
  • Size of your deployment based on your needs

When all parameters are configured, click on the Create button, and deployment will be created.

Once created, deployment will remain for a short period of time in PROVISIONING status while the hardware spins-up, just wait for a couple of minutes and reload the page. You'll also be notified via email once your deployment is ready to use:

Start writing and reading data

After transition from PROVISIONING to RUNNING state, Managed VictoriaMetrics deployment is fully operational and is ready to accept write and read requests.

Click on deployment name and navigate to the Access tab to get the access token:

Access tokens are used in token-based authentication to allow an application to access the VictoriaMetrics API. Supported token types are Read-Only, Write-Only and Read-Write. Click on token created by default to see usage examples:

Follow usage examples in order to configure access to VictoriaMetrics for your Prometheus, Grafana or any other software.

Modifying an existing deployment

Remember, you can always add, remove or modify existing deployment by changing its size or any parameters on the deployment's page. It is important to know that downgrade for cluster is currently not available.

To discover additional configuration options click on Advanced Settings button, so you should see the following:

In that section, additional params can be set:

  • Deduplication defines interval when deployment leaves a single raw sample with the biggest timestamp per each discrete interval;

  • Maintenance Window when deployment should start an upgrade process if needed;

  • Settings allow to define different flags for the deployment:

    1. cluster components flags.
    2. single version flags.

Please note, such an update requires a deployment restart and may result in a short downtime for single-node deployments.