VictoriaMetrics Playground
A fast, cost-effective, and scalable time-series database and monitoring solution.
💡 To explore VictoriaMetrics cluster mode, check out the multi-node playground.
🔧 System Components
- VictoriaMetrics: Time-series database: stores and queries metrics
🛠️ Tools
curl: Used to interact with the VictoriaMetrics HTTP API directly
🎯 Getting Started
Writing Metrics
Write a metric using Prometheus text exposition format:
curl -d 'my_custom_metric{env="playground"} 42' http://localhost:8428/api/v1/import/prometheus
Write multiple metrics at once:
curl -d @- http://localhost:8428/api/v1/import/prometheus <<EOF
http_requests_total{method="GET",path="/"} 100
http_requests_total{method="POST",path="/api"} 25
EOF
Querying Metrics
Instant query:
curl -s "http://localhost:8428/api/v1/query?query=vm_app_uptime_seconds" | jq
Range query (last 2 minutes):
curl -s "http://localhost:8428/api/v1/query_range?query=vm_app_uptime_seconds&start=$(date -d '2 minutes ago' +%s)&end=$(date +%s)&step=15s" | jq
Query the custom metric written above:
curl -s 'http://localhost:8428/api/v1/query?query=my_custom_metric' | jq
Querying with vmui
Open the vmui tab to access VictoriaMetrics' built-in query interface. It supports MetricsQL with autocompletion, query tracing, and a variety of visualization options.
Checking Service Status
systemctl status victoriametrics
📚 Learn More
🧩 Related Content
🧪 Playgrounds
Happy learning! 🚀
A real VM, not a container
Get root on a VM with its own kernel, so Docker, Kubernetes, and systemd just work.
Read the docs →
SSH from browser or CLI
Use the built-in web terminal, or connect with labctl ssh, plain ssh, scp, or rsync.
Read the docs →
Drive it with AI
Let Claude, Codex, or any MCP client start this playground and run commands in it.
Read the docs →
Expose HTTP(S) ports
Give any web app running inside the VM a public URL - for yourself or to share with others.
Read the docs →
Share terminals
Invite others into your terminal session, or open it yourself from another device.
Read the docs →
Customize with init scripts
Add shell scripts that run at boot to install packages, clone repos, or seed test data.
Read the docs →
Private networking
VMs reach the internet via NAT with no public IP; several VMs share bridge networks.
Read the docs →
Ephemeral or persistent
By default, VMs are destroyed when the session ends; enable persistence to keep the disks for next time.
Read the docs →
Built-in container registry
A private registry.iximiuz.com for every playground to share images across services and VMs.
Read the docs →