diff --git a/README.md b/README.md index 31fddc283..14c44c67f 100644 --- a/README.md +++ b/README.md @@ -122,7 +122,7 @@ VictoriaMetrics ecosystem contains the following components additionally to [sin - [vmbackup](https://docs.victoriametrics.com/vmbackup/), [vmrestore](https://docs.victoriametrics.com/vmrestore/) and [vmbackupmanager](https://docs.victoriametrics.com/vmbackupmanager/) - tools for creating backups and restoring from backups for VictoriaMetrics data. - `vminsert`, `vmselect` and `vmstorage` - components of [VictoriaMetrics cluster](https://docs.victoriametrics.com/cluster-victoriametrics/). -- [VictoriaLogs](https://docs.victoriametrics.com/VictoriaLogs/) - user-friendly cost-efficient database for logs. +- [VictoriaLogs](https://docs.victoriametrics.com/victorialogs/) - user-friendly cost-efficient database for logs. ## Operation diff --git a/app/victoria-logs/main.go b/app/victoria-logs/main.go index 1a803e44b..32834904a 100644 --- a/app/victoria-logs/main.go +++ b/app/victoria-logs/main.go @@ -47,7 +47,7 @@ func main() { vlinsert.Init() go httpserver.Serve(listenAddrs, useProxyProtocol, requestHandler) - logger.Infof("started VictoriaLogs in %.3f seconds; see https://docs.victoriametrics.com/VictoriaLogs/", time.Since(startTime).Seconds()) + logger.Infof("started VictoriaLogs in %.3f seconds; see https://docs.victoriametrics.com/victorialogs/", time.Since(startTime).Seconds()) pushmetrics.Init() sig := procutil.WaitForSigterm() @@ -77,7 +77,7 @@ func requestHandler(w http.ResponseWriter, r *http.Request) bool { } w.Header().Add("Content-Type", "text/html; charset=utf-8") fmt.Fprintf(w, "

Single-node VictoriaLogs


") - fmt.Fprintf(w, "See docs at https://docs.victoriametrics.com/VictoriaLogs/
") + fmt.Fprintf(w, "See docs at https://docs.victoriametrics.com/victorialogs/
") fmt.Fprintf(w, "Useful endpoints:
") httpserver.WriteAPIHelp(w, [][2]string{ {"select/vmui", "Web UI for VictoriaLogs"}, @@ -99,7 +99,7 @@ func usage() { const s = ` victoria-logs is a log management and analytics service. -See the docs at https://docs.victoriametrics.com/VictoriaLogs/ +See the docs at https://docs.victoriametrics.com/victorialogs/ ` flagutil.Usage(s) } diff --git a/app/vlstorage/main.go b/app/vlstorage/main.go index 500c6871c..3f41ddcb8 100644 --- a/app/vlstorage/main.go +++ b/app/vlstorage/main.go @@ -20,11 +20,11 @@ import ( var ( retentionPeriod = flagutil.NewDuration("retentionPeriod", "7d", "Log entries with timestamps older than now-retentionPeriod are automatically deleted; "+ "log entries with timestamps outside the retention are also rejected during data ingestion; the minimum supported retention is 1d (one day); "+ - "see https://docs.victoriametrics.com/VictoriaLogs/#retention") + "see https://docs.victoriametrics.com/victorialogs/#retention") futureRetention = flagutil.NewDuration("futureRetention", "2d", "Log entries with timestamps bigger than now+futureRetention are rejected during data ingestion; "+ - "see https://docs.victoriametrics.com/VictoriaLogs/#retention") + "see https://docs.victoriametrics.com/victorialogs/#retention") storageDataPath = flag.String("storageDataPath", "victoria-logs-data", "Path to directory with the VictoriaLogs data; "+ - "see https://docs.victoriametrics.com/VictoriaLogs/#storage") + "see https://docs.victoriametrics.com/victorialogs/#storage") inmemoryDataFlushInterval = flag.Duration("inmemoryDataFlushInterval", 5*time.Second, "The interval for guaranteed saving of in-memory data to disk. "+ "The saved data survives unclean shutdowns such as OOM crash, hardware reset, SIGKILL, etc. "+ "Bigger intervals may help increase the lifetime of flash storage with limited write cycles (e.g. Raspberry PI). "+ diff --git a/app/vmui/packages/vmui/src/pages/ExploreLogs/ExploreLogsHeader/ExploreLogsHeader.tsx b/app/vmui/packages/vmui/src/pages/ExploreLogs/ExploreLogsHeader/ExploreLogsHeader.tsx index beaaae9be..5a7c54973 100644 --- a/app/vmui/packages/vmui/src/pages/ExploreLogs/ExploreLogsHeader/ExploreLogsHeader.tsx +++ b/app/vmui/packages/vmui/src/pages/ExploreLogs/ExploreLogsHeader/ExploreLogsHeader.tsx @@ -79,7 +79,7 @@ const ExploreLogsHeader: FC = ({ query, limit, error, onC diff --git a/deployment/docker/README.md b/deployment/docker/README.md index e41807073..de7dbf797 100644 --- a/deployment/docker/README.md +++ b/deployment/docker/README.md @@ -185,7 +185,7 @@ To access Grafana use link [http://localhost:3000](http://localhost:3000). To access [VictoriaLogs UI](https://docs.victoriametrics.com/victorialogs/querying/#web-ui) use link [http://localhost:9428/select/vmui](http://localhost:9428/select/vmui). -Please, also see [how to monitor](https://docs.victoriametrics.com/VictoriaLogs/#monitoring) +Please, also see [how to monitor](https://docs.victoriametrics.com/victorialogs/#monitoring) VictoriaLogs installations. To shutdown environment execute the following command: diff --git a/docs/Cluster-VictoriaMetrics.md b/docs/Cluster-VictoriaMetrics.md index 8e1816367..7f1701907 100644 --- a/docs/Cluster-VictoriaMetrics.md +++ b/docs/Cluster-VictoriaMetrics.md @@ -22,7 +22,7 @@ with the number of CPU cores, RAM and available storage space. The single-node version is easier to configure and operate compared to the cluster version, so think twice before choosing the cluster version. See [this question](https://docs.victoriametrics.com/faq/#which-victoriametrics-type-is-recommended-for-use-in-production---single-node-or-cluster) for more details. -There is also user-friendly database for logs - [VictoriaLogs](https://docs.victoriametrics.com/VictoriaLogs/). +There is also user-friendly database for logs - [VictoriaLogs](https://docs.victoriametrics.com/victorialogs/). If you have questions about VictoriaMetrics, then feel free asking them at [VictoriaMetrics community Slack chat](https://victoriametrics.slack.com/), you can join it via [Slack Inviter](https://slack.victoriametrics.com/). diff --git a/docs/README.md b/docs/README.md index 1def54aaf..7e18233a2 100644 --- a/docs/README.md +++ b/docs/README.md @@ -125,7 +125,7 @@ VictoriaMetrics ecosystem contains the following components additionally to [sin - [vmbackup](https://docs.victoriametrics.com/vmbackup/), [vmrestore](https://docs.victoriametrics.com/vmrestore/) and [vmbackupmanager](https://docs.victoriametrics.com/vmbackupmanager/) - tools for creating backups and restoring from backups for VictoriaMetrics data. - `vminsert`, `vmselect` and `vmstorage` - components of [VictoriaMetrics cluster](https://docs.victoriametrics.com/cluster-victoriametrics/). -- [VictoriaLogs](https://docs.victoriametrics.com/VictoriaLogs/) - user-friendly cost-efficient database for logs. +- [VictoriaLogs](https://docs.victoriametrics.com/victorialogs/) - user-friendly cost-efficient database for logs. ## Operation diff --git a/docs/Single-server-VictoriaMetrics.md b/docs/Single-server-VictoriaMetrics.md index 8e2634852..bc8ac78cf 100644 --- a/docs/Single-server-VictoriaMetrics.md +++ b/docs/Single-server-VictoriaMetrics.md @@ -133,7 +133,7 @@ VictoriaMetrics ecosystem contains the following components additionally to [sin - [vmbackup](https://docs.victoriametrics.com/vmbackup/), [vmrestore](https://docs.victoriametrics.com/vmrestore/) and [vmbackupmanager](https://docs.victoriametrics.com/vmbackupmanager/) - tools for creating backups and restoring from backups for VictoriaMetrics data. - `vminsert`, `vmselect` and `vmstorage` - components of [VictoriaMetrics cluster](https://docs.victoriametrics.com/cluster-victoriametrics/). -- [VictoriaLogs](https://docs.victoriametrics.com/VictoriaLogs/) - user-friendly cost-efficient database for logs. +- [VictoriaLogs](https://docs.victoriametrics.com/victorialogs/) - user-friendly cost-efficient database for logs. ## Operation diff --git a/docs/VictoriaLogs/CHANGELOG.md b/docs/VictoriaLogs/CHANGELOG.md index c32f9f659..8058b937a 100644 --- a/docs/VictoriaLogs/CHANGELOG.md +++ b/docs/VictoriaLogs/CHANGELOG.md @@ -165,11 +165,11 @@ Released at 2023-10-04 Released at 2023-10-03 * FEATURE: add `-elasticsearch.version` command-line flag, which can be used for specifying Elasticsearch version returned by VictoriaLogs to Filebeat at [elasticsearch bulk API](https://docs.victoriametrics.com/victorialogs/data-ingestion/#elasticsearch-bulk-api). This helps resolving [this issue](https://github.com/VictoriaMetrics/VictoriaMetrics/issues/4777). -* FEATURE: expose the following metrics at [/metrics](https://docs.victoriametrics.com/VictoriaLogs/#monitoring) page: +* FEATURE: expose the following metrics at [/metrics](https://docs.victoriametrics.com/victorialogs/#monitoring) page: * `vl_data_size_bytes{type="storage"}` - on-disk size for data excluding [log stream](https://docs.victoriametrics.com/victorialogs/keyconcepts/#stream-fields) indexes. * `vl_data_size_bytes{type="indexdb"}` - on-disk size for [log stream](https://docs.victoriametrics.com/victorialogs/keyconcepts/#stream-fields) indexes. * FEATURE: add `-insert.maxFieldsPerLine` command-line flag, which can be used for limiting the number of fields per line in logs sent to VictoriaLogs via ingestion protocols. This helps to avoid issues like [this](https://github.com/VictoriaMetrics/VictoriaMetrics/issues/4762). -* FEATURE: expose `vl_http_request_duration_seconds` histogram at the [/metrics](https://docs.victoriametrics.com/VictoriaLogs/#monitoring) page. Thanks to @crossoverJie for [this pull request](https://github.com/VictoriaMetrics/VictoriaMetrics/pull/4934). +* FEATURE: expose `vl_http_request_duration_seconds` histogram at the [/metrics](https://docs.victoriametrics.com/victorialogs/#monitoring) page. Thanks to @crossoverJie for [this pull request](https://github.com/VictoriaMetrics/VictoriaMetrics/pull/4934). * FEATURE: add support of `-storage.minFreeDiskSpaceBytes` command-line flag to allow switching to read-only mode when running out of disk space at `-storageDataPath`. See [this issue](https://github.com/VictoriaMetrics/VictoriaMetrics/issues/4737). * BUGFIX: fix possible panic when no data is written to VictoriaLogs for a long time. See [this issue](https://github.com/VictoriaMetrics/VictoriaMetrics/issues/4895). Thanks to @crossoverJie for filing and fixing the issue. diff --git a/docs/VictoriaLogs/LogsQL.md b/docs/VictoriaLogs/LogsQL.md index c0b350e8a..c4947a226 100644 --- a/docs/VictoriaLogs/LogsQL.md +++ b/docs/VictoriaLogs/LogsQL.md @@ -12,7 +12,7 @@ aliases: # LogsQL -LogsQL is a simple yet powerful query language for [VictoriaLogs](https://docs.victoriametrics.com/VictoriaLogs/). +LogsQL is a simple yet powerful query language for [VictoriaLogs](https://docs.victoriametrics.com/victorialogs/). It provides the following features: - Full-text search across [log fields](https://docs.victoriametrics.com/victorialogs/keyconcepts/#data-model). diff --git a/docs/VictoriaLogs/QuickStart.md b/docs/VictoriaLogs/QuickStart.md index 47c85d2f7..2373ecd34 100644 --- a/docs/VictoriaLogs/QuickStart.md +++ b/docs/VictoriaLogs/QuickStart.md @@ -13,7 +13,7 @@ aliases: # VictoriaLogs Quick Start -It is recommended to read [README](https://docs.victoriametrics.com/VictoriaLogs/) +It is recommended to read [README](https://docs.victoriametrics.com/victorialogs/) and [Key Concepts](https://docs.victoriametrics.com/victorialogs/keyconcepts/) before you start working with VictoriaLogs. @@ -122,14 +122,14 @@ Pass `-help` to VictoriaLogs in order to see the list of supported command-line ``` VictoriaLogs stores the ingested data to the `victoria-logs-data` directory by default. The directory can be changed -via `-storageDataPath` command-line flag. See [these docs](https://docs.victoriametrics.com/VictoriaLogs/#storage) for details. +via `-storageDataPath` command-line flag. See [these docs](https://docs.victoriametrics.com/victorialogs/#storage) for details. By default VictoriaLogs stores [log entries](https://docs.victoriametrics.com/victorialogs/keyconcepts/) with timestamps in the time range `[now-7d, now]`, while dropping logs outside the given time range. -E.g. it uses the retention of 7 days. Read [these docs](https://docs.victoriametrics.com/VictoriaLogs/#retention) on how to control the retention +E.g. it uses the retention of 7 days. Read [these docs](https://docs.victoriametrics.com/victorialogs/#retention) on how to control the retention for the [ingested](https://docs.victoriametrics.com/victorialogs/data-ingestion/) logs. -It is recommended setting up monitoring of VictoriaLogs according to [these docs](https://docs.victoriametrics.com/VictoriaLogs/#monitoring). +It is recommended setting up monitoring of VictoriaLogs according to [these docs](https://docs.victoriametrics.com/victorialogs/#monitoring). See also: diff --git a/docs/VictoriaLogs/README.md b/docs/VictoriaLogs/README.md index 29e2228be..6eae9414c 100644 --- a/docs/VictoriaLogs/README.md +++ b/docs/VictoriaLogs/README.md @@ -154,7 +154,7 @@ Pass `-help` to VictoriaLogs in order to see the list of supported command-line -fs.disableMmap Whether to use pread() instead of mmap() for reading data files. By default, mmap() is used for 64-bit arches and pread() is used for 32-bit arches, since they cannot read data files bigger than 2^32 bytes in memory. mmap() is usually faster for reading small data chunks than pread() -futureRetention value - Log entries with timestamps bigger than now+futureRetention are rejected during data ingestion; see https://docs.victoriametrics.com/VictoriaLogs/#retention + Log entries with timestamps bigger than now+futureRetention are rejected during data ingestion; see https://docs.victoriametrics.com/victorialogs/#retention The following optional suffixes are supported: h (hour), d (day), w (week), y (year). If suffix isn't set, then the duration is counted in months (default 2d) -gogc int GOGC to use. See https://tip.golang.org/doc/gc-guide (default 100) @@ -244,7 +244,7 @@ Pass `-help` to VictoriaLogs in order to see the list of supported command-line Optional URL to push metrics exposed at /metrics page. See https://docs.victoriametrics.com/#push-metrics . By default, metrics exposed at /metrics page aren't pushed to any remote storage Supports an array of values separated by comma or specified via multiple flags. -retentionPeriod value - Log entries with timestamps older than now-retentionPeriod are automatically deleted; log entries with timestamps outside the retention are also rejected during data ingestion; the minimum supported retention is 1d (one day); see https://docs.victoriametrics.com/VictoriaLogs/#retention + Log entries with timestamps older than now-retentionPeriod are automatically deleted; log entries with timestamps outside the retention are also rejected during data ingestion; the minimum supported retention is 1d (one day); see https://docs.victoriametrics.com/victorialogs/#retention The following optional suffixes are supported: h (hour), d (day), w (week), y (year). If suffix isn't set, then the duration is counted in months (default 7d) -search.maxConcurrentRequests int The maximum number of concurrent search requests. It shouldn't be high, since a single request can saturate all the CPU cores, while many concurrently executed requests may require high amounts of memory. See also -search.maxQueueDuration (default 6) @@ -253,7 +253,7 @@ Pass `-help` to VictoriaLogs in order to see the list of supported command-line -search.maxQueueDuration duration The maximum time the search request waits for execution when -search.maxConcurrentRequests limit is reached; see also -search.maxQueryDuration (default 10s) -storageDataPath string - Path to directory with the VictoriaLogs data; see https://docs.victoriametrics.com/VictoriaLogs/#storage (default "victoria-logs-data") + Path to directory with the VictoriaLogs data; see https://docs.victoriametrics.com/victorialogs/#storage (default "victoria-logs-data") -storage.minFreeDiskSpaceBytes size The minimum free disk space at -storageDataPath after which the storage stops accepting new data Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 10000000) diff --git a/docs/VictoriaLogs/Roadmap.md b/docs/VictoriaLogs/Roadmap.md index e91a57b28..52c4b2b3a 100644 --- a/docs/VictoriaLogs/Roadmap.md +++ b/docs/VictoriaLogs/Roadmap.md @@ -14,7 +14,7 @@ aliases: # VictoriaLogs roadmap -The [VictoriaLogs](https://docs.victoriametrics.com/VictoriaLogs/) Preview is ready for evaluation in production. +The [VictoriaLogs](https://docs.victoriametrics.com/victorialogs/) Preview is ready for evaluation in production. It is recommended running it alongside the existing solutions such as Elasticsearch and Grafana Loki and comparing their resource usage and usability. It isn't recommended migrating from existing solutions to VictoriaLogs Preview yet. @@ -25,7 +25,7 @@ The following functionality is available in VictoriaLogs Preview: - [Querying](https://docs.victoriametrics.com/victorialogs/querying/). - [Querying via command-line](https://docs.victoriametrics.com/victorialogs/querying/#command-line). -See [these docs](https://docs.victoriametrics.com/VictoriaLogs/) for details. +See [these docs](https://docs.victoriametrics.com/victorialogs/) for details. The following functionality is planned in the future versions of VictoriaLogs: diff --git a/docs/VictoriaLogs/data-ingestion/Filebeat.md b/docs/VictoriaLogs/data-ingestion/Filebeat.md index 34a28967c..3719fa513 100644 --- a/docs/VictoriaLogs/data-ingestion/Filebeat.md +++ b/docs/VictoriaLogs/data-ingestion/Filebeat.md @@ -13,7 +13,7 @@ aliases: # Filebeat setup Specify [`output.elasicsearch`](https://www.elastic.co/guide/en/beats/filebeat/current/elasticsearch-output.html) section in the `filebeat.yml` -for sending the collected logs to [VictoriaLogs](https://docs.victoriametrics.com/VictoriaLogs/): +for sending the collected logs to [VictoriaLogs](https://docs.victoriametrics.com/victorialogs/): ```yaml output.elasticsearch: @@ -84,7 +84,7 @@ output.elasticsearch: compression_level: 1 ``` -By default, the ingested logs are stored in the `(AccountID=0, ProjectID=0)` [tenant](https://docs.victoriametrics.com/VictoriaLogs/#multitenancy). +By default, the ingested logs are stored in the `(AccountID=0, ProjectID=0)` [tenant](https://docs.victoriametrics.com/victorialogs/#multitenancy). If you need storing logs in other tenant, then specify the needed tenant via `headers` at `output.elasticsearch` section. For example, the following `filebeat.yml` config instructs Filebeat to store the data to `(AccountID=12, ProjectID=34)` tenant: diff --git a/docs/VictoriaLogs/data-ingestion/Fluentbit.md b/docs/VictoriaLogs/data-ingestion/Fluentbit.md index 724d64f06..ffa43e9c1 100644 --- a/docs/VictoriaLogs/data-ingestion/Fluentbit.md +++ b/docs/VictoriaLogs/data-ingestion/Fluentbit.md @@ -13,7 +13,7 @@ aliases: # Fluentbit setup Specify [http output](https://docs.fluentbit.io/manual/pipeline/outputs/http) section in the `fluentbit.conf` -for sending the collected logs to [VictoriaLogs](https://docs.victoriametrics.com/VictoriaLogs/): +for sending the collected logs to [VictoriaLogs](https://docs.victoriametrics.com/victorialogs/): ```conf [Output] diff --git a/docs/VictoriaLogs/data-ingestion/Logstash.md b/docs/VictoriaLogs/data-ingestion/Logstash.md index 60451a898..5472ab29b 100644 --- a/docs/VictoriaLogs/data-ingestion/Logstash.md +++ b/docs/VictoriaLogs/data-ingestion/Logstash.md @@ -13,7 +13,7 @@ aliases: # Logstash setup Specify [`output.elasticsearch`](https://www.elastic.co/guide/en/logstash/current/plugins-outputs-elasticsearch.html) section in the `logstash.conf` file -for sending the collected logs to [VictoriaLogs](https://docs.victoriametrics.com/VictoriaLogs/): +for sending the collected logs to [VictoriaLogs](https://docs.victoriametrics.com/victorialogs/): ```conf output { @@ -86,7 +86,7 @@ output { } ``` -By default, the ingested logs are stored in the `(AccountID=0, ProjectID=0)` [tenant](https://docs.victoriametrics.com/VictoriaLogs/#multitenancy). +By default, the ingested logs are stored in the `(AccountID=0, ProjectID=0)` [tenant](https://docs.victoriametrics.com/victorialogs/#multitenancy). If you need storing logs in other tenant, then specify the needed tenant via `custom_headers` at `output.elasticsearch` section. For example, the following `logstash.conf` config instructs Logstash to store the data to `(AccountID=12, ProjectID=34)` tenant: diff --git a/docs/VictoriaLogs/data-ingestion/Promtail.md b/docs/VictoriaLogs/data-ingestion/Promtail.md index 40e25cbb2..a55eb7073 100644 --- a/docs/VictoriaLogs/data-ingestion/Promtail.md +++ b/docs/VictoriaLogs/data-ingestion/Promtail.md @@ -15,7 +15,7 @@ aliases: Promtail can be configured to send the collected logs to VictoriaLogs according to the following docs. Specify [`clients`](https://grafana.com/docs/loki/latest/clients/promtail/configuration/#clients) section in the configuration file -for sending the collected logs to [VictoriaLogs](https://docs.victoriametrics.com/VictoriaLogs/): +for sending the collected logs to [VictoriaLogs](https://docs.victoriametrics.com/victorialogs/): ```yaml clients: @@ -52,11 +52,11 @@ clients: - url: http://localhost:9428/insert/loki/api/v1/push?_stream_fields=instance,job,host,app&ignore_fields=filename,stream ``` -By default the ingested logs are stored in the `(AccountID=0, ProjectID=0)` [tenant](https://docs.victoriametrics.com/VictoriaLogs/#multitenancy). +By default the ingested logs are stored in the `(AccountID=0, ProjectID=0)` [tenant](https://docs.victoriametrics.com/victorialogs/#multitenancy). If you need storing logs in other tenant, then specify the needed tenant via `tenant_id` field in the [Loki client configuration](https://grafana.com/docs/loki/latest/clients/promtail/configuration/#clients) The `tenant_id` must have `AccountID:ProjectID` format, where `AccountID` and `ProjectID` are arbitrary uint32 numbers. -For example, the following config instructs VictoriaLogs to store logs in the `(AccountID=12, ProjectID=34)` [tenant](https://docs.victoriametrics.com/VictoriaLogs/#multitenancy): +For example, the following config instructs VictoriaLogs to store logs in the `(AccountID=12, ProjectID=34)` [tenant](https://docs.victoriametrics.com/victorialogs/#multitenancy): ```yaml clients: diff --git a/docs/VictoriaLogs/data-ingestion/README.md b/docs/VictoriaLogs/data-ingestion/README.md index dd1d047e3..1ed7fc1f7 100644 --- a/docs/VictoriaLogs/data-ingestion/README.md +++ b/docs/VictoriaLogs/data-ingestion/README.md @@ -14,7 +14,7 @@ aliases: # Data ingestion -[VictoriaLogs](https://docs.victoriametrics.com/VictoriaLogs/) can accept logs from the following log collectors: +[VictoriaLogs](https://docs.victoriametrics.com/victorialogs/) can accept logs from the following log collectors: - Filebeat. See [how to setup Filebeat for sending logs to VictoriaLogs](https://docs.victoriametrics.com/victorialogs/data-ingestion/Filebeat.html). - Fluentbit. See [how to setup Fluentbit for sending logs to VictoriaLogs](https://docs.victoriametrics.com/victorialogs/data-ingestion/Fluentbit.html). @@ -211,7 +211,7 @@ See also [HTTP headers](#http-headers). ### HTTP headers VictoriaLogs accepts optional `AccountID` and `ProjectID` headers at [data ingestion HTTP APIs](#http-apis). -These headers may contain the needed tenant to ingest data to. See [multitenancy docs](https://docs.victoriametrics.com/VictoriaLogs/#multitenancy) for details. +These headers may contain the needed tenant to ingest data to. See [multitenancy docs](https://docs.victoriametrics.com/victorialogs/#multitenancy) for details. ## Troubleshooting @@ -238,14 +238,14 @@ VictoriaLogs provides the following command-line flags, which can help debugging [log entries](https://docs.victoriametrics.com/victorialogs/keyconcepts/#data-model). See also `debug` [parameter](#http-parameters). -VictoriaLogs exposes various [metrics](https://docs.victoriametrics.com/VictoriaLogs/#monitoring), which may help debugging data ingestion issues: +VictoriaLogs exposes various [metrics](https://docs.victoriametrics.com/victorialogs/#monitoring), which may help debugging data ingestion issues: - `vl_rows_ingested_total` - the number of ingested [log entries](https://docs.victoriametrics.com/victorialogs/keyconcepts/#data-model) since the last VictoriaLogs restart. If this number icreases over time, then logs are successfully ingested into VictoriaLogs. The ingested logs can be inspected in the following ways: - By passing `debug=1` parameter to every request to [data ingestion APIs](#http-apis). The ingested rows aren't stored in VictoriaLogs in this case. Instead, they are logged, so they can be investigated later. - The `vl_rows_dropped_total` [metric](https://docs.victoriametrics.com/VictoriaLogs/#monitoring) is incremented for each logged row. + The `vl_rows_dropped_total` [metric](https://docs.victoriametrics.com/victorialogs/#monitoring) is incremented for each logged row. - By passing `-logIngestedRows` command-line flag to VictoriaLogs. In this case it logs all the ingested data, so it can be investigated later. - `vl_streams_created_total` - the number of created [log streams](https://docs.victoriametrics.com/victorialogs/keyconcepts/#stream-fields) since the last VictoriaLogs restart. If this metric grows rapidly during extended periods of time, then this may lead diff --git a/docs/VictoriaLogs/data-ingestion/Vector.md b/docs/VictoriaLogs/data-ingestion/Vector.md index bfb61ea92..3b7a5c447 100644 --- a/docs/VictoriaLogs/data-ingestion/Vector.md +++ b/docs/VictoriaLogs/data-ingestion/Vector.md @@ -15,7 +15,7 @@ aliases: ## Elasticsearch sink Specify [Elasticsearch sink type](https://vector.dev/docs/reference/configuration/sinks/elasticsearch/) in the `vector.toml` -for sending the collected logs to [VictoriaLogs](https://docs.victoriametrics.com/VictoriaLogs/): +for sending the collected logs to [VictoriaLogs](https://docs.victoriametrics.com/victorialogs/): ```toml [sinks.vlogs] diff --git a/docs/VictoriaLogs/keyConcepts.md b/docs/VictoriaLogs/keyConcepts.md index 49949539d..4cdc76099 100644 --- a/docs/VictoriaLogs/keyConcepts.md +++ b/docs/VictoriaLogs/keyConcepts.md @@ -15,7 +15,7 @@ aliases: ## Data model -[VictoriaLogs](https://docs.victoriametrics.com/VictoriaLogs/) works with both structured and unstructured logs. +[VictoriaLogs](https://docs.victoriametrics.com/victorialogs/) works with both structured and unstructured logs. Every log entry must contain at least [log message field](#message-field) plus arbitrary number of additional `key=value` fields. A single log entry can be expressed as a single-level [JSON](https://www.json.org/json-en.html) object with string keys and values. For example: @@ -206,7 +206,7 @@ to the following issues: - Increased disk space usage - Increased disk read / write IO -VictoriaLogs exposes `vl_streams_created_total` [metric](https://docs.victoriametrics.com/VictoriaLogs/#monitoring), +VictoriaLogs exposes `vl_streams_created_total` [metric](https://docs.victoriametrics.com/victorialogs/#monitoring), which shows the number of created streams since the last VictoriaLogs restart. If this metric grows at a rapid rate during long period of time, then there are high chances of high cardinality issues mentioned above. VictoriaLogs can log all the newly registered streams when `-logNewStreams` command-line flag is passed to it. diff --git a/docs/VictoriaLogs/querying/README.md b/docs/VictoriaLogs/querying/README.md index ffef78104..4c4d6a2bd 100644 --- a/docs/VictoriaLogs/querying/README.md +++ b/docs/VictoriaLogs/querying/README.md @@ -14,7 +14,7 @@ aliases: # Querying -[VictoriaLogs](https://docs.victoriametrics.com/VictoriaLogs/) can be queried with [LogsQL](https://docs.victoriametrics.com/victorialogs/logsql/) +[VictoriaLogs](https://docs.victoriametrics.com/victorialogs/) can be queried with [LogsQL](https://docs.victoriametrics.com/victorialogs/logsql/) via the following ways: - [Web UI](#web-ui) - a web-based UI for querying logs @@ -89,7 +89,7 @@ The returned lines aren't sorted, since sorting disables the ability to send mat Query results can be sorted either at VictoriaLogs side according [to these docs](https://docs.victoriametrics.com/victorialogs/logsql/#sort-pipe) or at client side with the usual `sort` command according to [these docs](#command-line). -By default the `(AccountID=0, ProjectID=0)` [tenant](https://docs.victoriametrics.com/VictoriaLogs/#multitenancy) is queried. +By default the `(AccountID=0, ProjectID=0)` [tenant](https://docs.victoriametrics.com/victorialogs/#multitenancy) is queried. If you need querying other tenant, then specify the needed tenant via http request headers. For example, the following query searches for log messages at `(AccountID=12, ProjectID=34)` tenant: @@ -97,7 +97,7 @@ for log messages at `(AccountID=12, ProjectID=34)` tenant: curl http://localhost:9428/select/logsql/query -H 'AccountID: 12' -H 'ProjectID: 34' -d 'query=error' ``` -The number of requests to `/select/logsql/query` can be [monitored](https://docs.victoriametrics.com/VictoriaLogs/#monitoring) +The number of requests to `/select/logsql/query` can be [monitored](https://docs.victoriametrics.com/victorialogs/#monitoring) with `vl_http_requests_total{path="/select/logsql/query"}` metric. - [Querying hits stats](#querying-hits-stats) @@ -459,7 +459,7 @@ This is the first version that has minimal functionality. It comes with the foll - The number of query results is always limited to 1000 lines. Iteratively add more specific [filters](https://docs.victoriametrics.com/victorialogs/logsql/#filters) to the query in order to get full response with less than 1000 lines. -- Queries are always executed against [tenant](https://docs.victoriametrics.com/VictoriaLogs/#multitenancy) `0`. +- Queries are always executed against [tenant](https://docs.victoriametrics.com/victorialogs/#multitenancy) `0`. These limitations will be removed in future versions. diff --git a/lib/logstorage/storage.go b/lib/logstorage/storage.go index 949ad1914..3307eb989 100644 --- a/lib/logstorage/storage.go +++ b/lib/logstorage/storage.go @@ -440,7 +440,7 @@ func (s *Storage) MustAddRows(lr *LogRows) { tsf := TimeFormatter(ts) minAllowedTsf := TimeFormatter(minAllowedDay * nsecPerDay) tooSmallTimestampLogger.Warnf("skipping log entry with too small timestamp=%s; it must be bigger than %s according "+ - "to the configured -retentionPeriod=%dd. See https://docs.victoriametrics.com/VictoriaLogs/#retention ; "+ + "to the configured -retentionPeriod=%dd. See https://docs.victoriametrics.com/victorialogs/#retention ; "+ "log entry: %s", &tsf, &minAllowedTsf, durationToDays(s.retention), &rf) s.rowsDroppedTooSmallTimestamp.Add(1) continue @@ -450,7 +450,7 @@ func (s *Storage) MustAddRows(lr *LogRows) { tsf := TimeFormatter(ts) maxAllowedTsf := TimeFormatter(maxAllowedDay * nsecPerDay) tooBigTimestampLogger.Warnf("skipping log entry with too big timestamp=%s; it must be smaller than %s according "+ - "to the configured -futureRetention=%dd; see https://docs.victoriametrics.com/VictoriaLogs/#retention ; "+ + "to the configured -futureRetention=%dd; see https://docs.victoriametrics.com/victorialogs/#retention ; "+ "log entry: %s", &tsf, &maxAllowedTsf, durationToDays(s.futureRetention), &rf) s.rowsDroppedTooBigTimestamp.Add(1) continue