VictoriaMetrics · hagen1778 · Jun 3, 2026 · Jun 5, 2026 · Jun 8, 2026 · Jun 24, 2026
diff --git a/...s/docs_victorialogs_security-and-lb-proxying-requests-to-the-given-tenants.webp b/...s/docs_victorialogs_security-and-lb-proxying-requests-to-the-given-tenants.webp
diff --git a/docs/victorialogs/security-and-lb-access-control-inside-a-single-tenant.webp b/docs/victorialogs/security-and-lb-access-control-inside-a-single-tenant.webp
diff --git a/docs/victorialogs/security-and-lb-cluster-routing.webp b/docs/victorialogs/security-and-lb-cluster-routing.webp
diff --git a/docs/victorialogs/security-and-lb-proxying-requests-to-the-given-tenants.webp b/docs/victorialogs/security-and-lb-proxying-requests-to-the-given-tenants.webp
diff --git a/docs/victorialogs/security-and-lb-search-auth.webp b/docs/victorialogs/security-and-lb-search-auth.webp
diff --git a/docs/victorialogs/security-and-lb-search-authorization.webp b/docs/victorialogs/security-and-lb-search-authorization.webp
diff --git a/docs/victorialogs/security-and-lb-tenant-assignment.webp b/docs/victorialogs/security-and-lb-tenant-assignment.webp
diff --git a/docs/victorialogs/security-and-lb-tenant-based-request-proxying.webp b/docs/victorialogs/security-and-lb-tenant-based-request-proxying.webp
diff --git a/docs/victorialogs/security-and-lb-tenants.excalidraw b/docs/victorialogs/security-and-lb-tenants.excalidraw
diff --git a/docs/victorialogs/security-and-lb-tenants.webp b/docs/victorialogs/security-and-lb-tenants.webp
diff --git a/docs/victorialogs/security-and-lb.excalidraw b/docs/victorialogs/security-and-lb.excalidraw
diff --git a/docs/victorialogs/security-and-lb.md b/docs/victorialogs/security-and-lb.md
@@ -24,7 +24,7 @@ to [these docs](https://docs.victoriametrics.com/victoriametrics/vmauth/#authori
 
 See also [how to protect security-sensitive HTTP-based endpoints](https://docs.victoriametrics.com/victorialogs/security-and-lb/#system-endpoints).
 
-## Vmauth config examples
+## vmauth config examples
 
 This document contains the following configuration examples for `vmauth`:
 
@@ -61,6 +61,8 @@ users:
 
 This config instructs `vmauth` accepting requests for the Basic Auth user `foo` with the password `bar`.
 
+![Using vmauth for load balancing with basic authentication](security-and-lb-search-authorization.webp)
+
 Successfully authenticated requests are proxied (load balanced) to one of the VictoriaLogs instances specified in the `url_prefix` list,
 if these requests match the `src_paths` regexp, i.e. if they start with `/select/` path prefix.
 See [these docs](https://docs.victoriametrics.com/victoriametrics/vmauth/#routing-by-path) for details about the `src_path`.
@@ -97,6 +99,8 @@ and requests with the path prefix `/hot/select/` to the backend at `http://victo
 The backends can be either single-node instances of VictoriaLogs or `vmauth` in front of `vlselect` nodes in [VictoriaLogs cluster](https://docs.victoriametrics.com/victorialogs/cluster/).
 See [how to set up `vmauth` in front on multiple `vlselect` nodes](https://docs.victoriametrics.com/victorialogs/security-and-lb/#search-authorization).
 
+![Using vmauth to route by path](security-and-lb-cluster-routing.webp)
+
 This approach is useful when applying different retention policies for various types of logs.
 For example, you might store warn-level and higher severity logs in the cold instance/cluster with longer retention,
 while keeping debug-level and lower severity logs only in the hot instance/cluster with shorter retention.
@@ -140,6 +144,8 @@ unauthorized_user:
 This allows building a VictoriaLogs storage system with distinct per-tenant retention configs
 similar to [this one](https://github.com/VictoriaMetrics/VictoriaLogs/issues/15#issuecomment-3043557052).
 
+![Using vmauth to route by HTTP header](security-and-lb-tenant-based-request-proxying.webp)
+
 See [these docs](https://docs.victoriametrics.com/victoriametrics/vmauth/#routing-by-header) on how to setup request routing in `vmauth` by request headers.
 See [these docs](https://docs.victoriametrics.com/victoriametrics/vmauth/#modifying-http-headers) on how to modify request headers before proxying the requests to backends.
 
@@ -208,6 +214,8 @@ users:
 This configuration allows user `foo` to access 3 different tenants, and user `admin` to access all tenants.
 The user `admin` needs to set the required `AccountID` or `ProjectID` headers, because `vmauth` doesn't set them.
 
+![Enforcing TenantID and ProjectID with vmauth and basic authentication](security-and-lb-proxying-requests-to-the-given-tenants.webp)
+
 In Grafana you need to create a separate data source for each tenant and user, an example of such an address is: `http://vmauth:8427/my-account/mobile-logs/`.
 Using the configuration above, you do not need to set the tenant in the Grafana data source settings because `vmauth` overrides it to `AccountID: 1`, `ProjectID: 6`.
 Each tenant exposes [`vmui`](https://docs.victoriametrics.com/victorialogs/querying/#web-ui) at `/select/vmui/`, for example: `http://vmauth:8427/my-account/mobile-logs/select/vmui/`.
@@ -294,6 +302,8 @@ users:
 `extra_filters` and `extra_stream_filters` should be [percent-encoded](https://en.wikipedia.org/wiki/Percent-encoding) when they include characters that are not URL-safe.
 For example, the query `_stream:{service=frontend-logs}` should be written as `_stream%3A%7Bservice%3Dfrontend-logs%7D`.
 
+![Enforcing stream filters with vmauth and basic authentication](security-and-lb-access-control-inside-a-single-tenant.webp)
+
 Prefer using `extra_stream_filters` over `extra_filters` whenever possible.
 See [LogsQL performance optimization tips](https://docs.victoriametrics.com/victorialogs/logsql/#performance-tips).
 
@@ -364,8 +374,7 @@ users:
 
 Below is a diagram of this configuration:
 
-![security-and-lb-tenants.webp](security-and-lb-tenants.webp)
-{width="600"}
+![Enforcing tenantID and projectID with vmauth and basic authentication](security-and-lb-tenant-assignment.webp)
 
 See [how to override http request headers before proxying the requests to backends](https://docs.victoriametrics.com/victoriametrics/vmauth/#modifying-http-headers).