vmagent
Send data to Levitate via VictoriaMetrics vmagent using Prometheus Remote Write protocol
We make use of the VictoriaMetrics' vmagent remote-write to write to an external remote endpoint i.e. Levitate's remote-write endpoint.
Prerequisites
Create a Levitate cluster by following Getting Started.
Keep the following information handy after creating the cluster:
$levitate_remote_write_url
- Levitate's Remote write endpoint$levitate_remote_write_username
- Cluster ID$levitate_remote_write_password
- Write token created for the cluster
Sending data to Levitate
The information flow is as follows:
Setup
Here is a sampledocker-compose.yaml
for the vmagent
setup:
version: "3.5"
services:
vmagent:
container_name: vmagent
image: victoriametrics/vmagent
ports:
- 8429:8429
volumes:
- vmagentdata:/vmagentdata
- /var/tmp:/var/tmp
- ./vmagent.yaml:/etc/vmagent/vmagent.yaml
command:
- "--promscrape.config=/etc/vmagent/vmagent.yaml"
- "--remoteWrite.tmpDataPath=/var/tmp/vmagent/"
- "--remoteWrite.maxDiskUsagePerURL=10737418240"
- "--remoteWrite.url=$levitate_remote_write_url"
- "--remoteWrite.basicAuth.username=$levitate_remote_write_username"
- "--remoteWrite.basicAuth.password=$levitate_remote_write_password"
restart: always
network_mode: "host"
volumes:
vmagentdata: { }
Create vmagent.yaml
to add a sample scrape config. Replace this scrape config with your desired config:
global:
scrape_interval: 1m
scrape_timeout: 20s
# Check https://prometheus.io/docs/prometheus/latest/configuration/configuration for more details
scrape_configs:
- job_name: "vmagent"
static_configs:
- targets: [ "localhost:8429" ]
This will run the vmagent
container, scrape the desired targets, and remote write metrics to Levitate.
Verification
The Levitate Cluster will start showing a summary of ingested samples.
Check out how to install VMAgent on Ubuntu as standalone serivce here.
Next steps
Create a read token for your Levitate Cluster and follow our guide to Configure Grafana to visualize the time series data getting sent to Levitate.
Troubleshooting
Please get in touch with us on Discord or Email if you have any questions.