VictoriaMetrics/deployment/marketplace/digitialocean/one-click-droplet
2023-11-17 15:44:15 +01:00
..
files deployment: update VictoriaMetrics docker image tag from v1.95.0 to v1.95.1 2023-11-17 15:44:15 +01:00
scripts Fix some typos and adds improvements for packer builds (#3825) 2023-02-23 12:42:55 +04:00
Makefile Fix some typos and adds improvements for packer builds (#3825) 2023-02-23 12:42:55 +04:00
README.md all: replace bash with console blocks in all the *.md files 2022-06-19 23:00:39 +03:00
RELEASE_GUIDE.md docs: use https://github.com/VictoriaMetrics/VictoriaMetrics/releases/latest instead of https://github.com/VictoriaMetrics/VictoriaMetrics/releases link where needed 2023-10-18 20:06:25 +02:00
template.pkr.hcl template.pkr.hcl: fix wrong variable name 2022-08-30 11:16:59 +03:00

Application summary

VictoriaMetrics is a fast and scalable open source time series database and monitoring solution.

Description

VictoriaMetrics is a free open source time series database (TSDB) and monitoring solution, designed to collect, store and process real-time metrics.

It supports the Prometheus pull model and various push protocols (Graphite, InfluxDB, OpenTSDB) for data ingestion. It is optimized for storage with high-latency IO, low IOPS and time series with high churn rate.

For reading the data and evaluating alerting rules, VictoriaMetrics supports the PromQL, MetricsQL and Graphite query languages. VictoriaMetrics Single is fully autonomous and can be used as a long-term storage for time series.

VictoriaMetrics Single = Hassle-free monitoring solution. Easily handles 10M+ of active time series on a single instance. Perfect for small and medium environments.

Getting started after deploying VictoriaMetrics Single

Config

VictoriaMetrics configuration is located at /etc/victoriametrics/single/scrape.yml on the droplet. This One Click app uses 8428, 2003, 4242 and 8089 ports to accept metrics from different protocols. It's recommended to disable ports for protocols which are not needed. Ubuntu firewall can be used to easily disable access for specific ports.

Scraping metrics

VictoriaMetrics supports metrics scraping in the same way as Prometheus does. Check the configuration file to edit scraping targets. See more details about scraping at How to scrape Prometheus exporters.

Sending metrics

Besides scraping, VictoriaMetrics accepts write requests for various ingestion protocols. This One Click app supports the following protocols:

See more details and examples in official documentation.

UI

VictoriaMetrics provides a User Interface (UI) for query troubleshooting and exploration. The UI is available at http://your_droplet_public_ipv4:8428/vmui. It lets users explore query results via graphs and tables.

To check it, open the following in your browser http://your_droplet_public_ipv4:8428/vmui and then enter vm_app_uptime_seconds to the Query Field to Execute the Query.

Run the following command to query and retrieve a result from VictoriaMetrics Single with curl:

curl -sg http://your_droplet_public_ipv4:8428/api/v1/query_range?query=vm_app_uptime_seconds | jq

Accessing

Once the Droplet is created, you can use DigitalOcean's web console to start a session or SSH directly to the server as root:

ssh root@your_droplet_public_ipv4