VictoriaLogs Single

VictoriaLogs is open source user-friendly database for logs from VictoriaMetrics.

VictoriaLogs can accept logs from popular log collectors. It provides easy yet powerful query language with full-text search capabilities across all the log fields via LogsQL query language and supports fast full-text search over high-cardinality log fields such as trace_id, user_id and ip as wel as out-of-order logs’ ingestion aka backfilling.

VictoriaLogs can be seamlessly combined with good old Unix tools for log analysis such as grep, less, sort, jq, etc. See these docs for details.

VictoriaLogs capacity and performance scales linearly with the available resources (CPU, RAM, disk IO, disk space)

Software Included

Creating an App using the Control Panel

Click the Deploy to DigitalOcean button to create a Droplet based on this 1-Click App. If you aren’t logged in, this link will prompt you to log in with your DigitalOcean account.

Creating an App using the API

In addition to creating a Droplet from the VictoriaLogs Single 1-Click App using the control panel, you can also use the DigitalOcean API. As an example, to create a 4GB VictoriaLogs Single Droplet in the SFO2 region, you can use the following curl command. You need to either save your API access token) to an environment variable or substitute it in the command below.

curl -X POST -H 'Content-Type: application/json' \
         -H 'Authorization: Bearer '$TOKEN'' -d \
        '{"name":"choose_a_name","region":"sfo2","size":"s-2vcpu-4gb","image": "victoriametrics-victorialogssing"}' \
        "https://api.digitalocean.com/v2/droplets"

Getting Started After Deploying VictoriaLogs Single

Config

VictoriaLogs configuration is located at /etc/victorialogs/single/victorialogs.conf on the droplet.

This One Click app uses 9428 port to accept logs from popular log collectors like:

• Filebeat
• Fluentbit
• Fluentd
• Logstash
• Vector
• Promtail
• Telegraf
• OpenTelemetry setup
• Syslog

See more details and examples in official documentation.

Web UI

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

Accessing

Run the following command to check that VictoriaLogs is healthy and ready to accept for data ingestion:

curl -sg http://your_droplet_public_ipv4:9428/health

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