github-mirrors/VictoriaMetrics
1
0
Fork 0
mirror of https://github.com/VictoriaMetrics/VictoriaMetrics.git synced 2024-11-21 14:44:00 +00:00
Code Issues Projects Releases Packages Wiki Activity
VictoriaMetrics/docs/enterprise.md

308 lines
14 KiB
Markdown
Raw Normal View History

docs/enterprise.md: describe all the enteprise features in a short doc at https://docs.victoriametrics.com/enterprise.html
2022-10-24 15:00:25 +00:00
---
prepare static docs to migration Signed-off-by: Artem Navoiev <tenmozes@gmail.com>
2023-04-30 10:31:45 +00:00
weight: 99
docs: grouped changelog docs, removed old make commands, replaced docs in root README with official docs links (#6727) ### Describe Your Changes - replace docs in root README with a link to official documentation - remove old make commands for documentation - remove redundant "VictoriaMetrics" from document titles - merge changelog docs into a section - rm content of Single-server-VictoriaMetrics.md as it can be included from docs/README - add basic information to README in the root folder, so it will be useful for github users - rm `picture` tag from docs/README as it was needed for github only, we don't display VM logo at docs.victoriametrics.com - update `## documentation` section in docs/README to reflect the changes - rename DD pictures, as they now belong to docs/README Signed-off-by: hagen1778 <roman@victoriametrics.com> Co-authored-by: hagen1778 <roman@victoriametrics.com>
2024-07-31 14:03:18 +00:00
title: Enterprise
prepare static docs to migration Signed-off-by: Artem Navoiev <tenmozes@gmail.com>
2023-04-30 10:31:45 +00:00
menu:
docs:
docs: grouped changelog docs, removed old make commands, replaced docs in root README with official docs links (#6727) ### Describe Your Changes - replace docs in root README with a link to official documentation - remove old make commands for documentation - remove redundant "VictoriaMetrics" from document titles - merge changelog docs into a section - rm content of Single-server-VictoriaMetrics.md as it can be included from docs/README - add basic information to README in the root folder, so it will be useful for github users - rm `picture` tag from docs/README as it was needed for github only, we don't display VM logo at docs.victoriametrics.com - update `## documentation` section in docs/README to reflect the changes - rename DD pictures, as they now belong to docs/README Signed-off-by: hagen1778 <roman@victoriametrics.com> Co-authored-by: hagen1778 <roman@victoriametrics.com>
2024-07-31 14:03:18 +00:00
identifier: vm-enterprise
vmalert-tool: implement unittest (#4789) 1. split package rule under /app/vmalert, expose needed objects 2. add vmalert-tool with unittest subcmd https://github.com/VictoriaMetrics/VictoriaMetrics/issues/2945
2023-10-13 11:54:33 +00:00
parent: 'victoriametrics'
prepare static docs to migration Signed-off-by: Artem Navoiev <tenmozes@gmail.com>
2023-04-30 10:31:45 +00:00
weight: 99
aliases:
- /enterprise.html
docs/enterprise.md: describe all the enteprise features in a short doc at https://docs.victoriametrics.com/enterprise.html
2022-10-24 15:00:25 +00:00
---
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
VictoriaMetrics components are provided in two kinds - [Community edition](https://victoriametrics.com/products/open-source/)
and [Enterprise edition](https://victoriametrics.com/products/enterprise/).
docs/enterprise.md: describe all the enteprise features in a short doc at https://docs.victoriametrics.com/enterprise.html
2022-10-24 15:00:25 +00:00
VictoriaMetrics community components are open source and are free to use - see [the source code](https://github.com/VictoriaMetrics/VictoriaMetrics/)
and [the license](https://github.com/VictoriaMetrics/VictoriaMetrics/blob/master/LICENSE).
docs: use https://github.com/VictoriaMetrics/VictoriaMetrics/releases/latest instead of https://github.com/VictoriaMetrics/VictoriaMetrics/releases link where needed The https://github.com/VictoriaMetrics/VictoriaMetrics/releases link may show non-latest releases at the top, such as LTS releases or VictoriaLogs releases. So it is better to use https://github.com/VictoriaMetrics/VictoriaMetrics/releases/latest link, which always redirect to the latest available release of VictoriaMetrics.
2023-10-18 18:06:23 +00:00
VictoriaMetrics Enterprise components are available in binary form at [releases page](https://github.com/VictoriaMetrics/VictoriaMetrics/releases/latest)
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
and at [docker hub](https://hub.docker.com/u/victoriametrics). Enterprise binaries and packages have `enterprise` suffix in their names.
docs/enterprise.md: describe all the enteprise features in a short doc at https://docs.victoriametrics.com/enterprise.html
2022-10-24 15:00:25 +00:00
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
## Valid cases for VictoriaMetrics Enterprise
The use of VictoriaMetrics Enterprise components is permitted in the following cases:
- Evaluation use in non-production setups. Please, request trial license [here](https://victoriametrics.com/products/enterprise/trial/)
and then pass it via `-license` or `-licenseFile` command-line flags as described [in these docs](#running-victoriametrics-enterprise).
docs/enterprise.md: describe all the enteprise features in a short doc at https://docs.victoriametrics.com/enterprise.html
2022-10-24 15:00:25 +00:00
- Production use if you have a valid enterprise contract or valid permit from VictoriaMetrics company.
docs: fixes misspelled typos Also tried to make it catch "Authorisation" in the future, fixed a lot of other misspells along the way, but didn't make it catch "Authorisation" anyway. - Fix misspelled "Authorization" header name - Fix misspelled "organization" - Fix more misspells
2024-09-13 10:14:24 +00:00
Please contact us via [this page](https://victoriametrics.com/products/enterprise/) if you are interested in such a contract.
docs/enterprise.md: describe all the enteprise features in a short doc at https://docs.victoriametrics.com/enterprise.html
2022-10-24 15:00:25 +00:00
docs: rename managed to cloud (#6689) ### Describe Your Changes These changes were made as part of the title transition from Managed VictoriaMetrics to VictoriaMetrics Cloud ### Checklist The following checks are **mandatory**: - [x] My change adheres [VictoriaMetrics contributing guidelines](https://docs.victoriametrics.com/contributing/).
2024-07-30 07:59:29 +00:00
- [VictoriaMetrics Cloud](https://docs.victoriametrics.com/victoriametrics-cloud/) is built on top of VictoriaMetrics Enterprise.
docs/enterprise.md: describe all the enteprise features in a short doc at https://docs.victoriametrics.com/enterprise.html
2022-10-24 15:00:25 +00:00
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
See [these docs](#running-victoriametrics-enterprise) for details on how to run VictoriaMetrics enterprise.
docs/enterprise.md: describe all the enteprise features in a short doc at https://docs.victoriametrics.com/enterprise.html
2022-10-24 15:00:25 +00:00
## VictoriaMetrics enterprise features
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
VictoriaMetrics Enterprise includes [all the features of the community edition](https://docs.victoriametrics.com/#prominent-features),
docs/enterprise.md: describe all the enteprise features in a short doc at https://docs.victoriametrics.com/enterprise.html
2022-10-24 15:00:25 +00:00
plus the following additional features:
docs: consistently use https://docs.victoriametrics.com/lts-releases/ link for LTS releases
2024-03-01 00:51:41 +00:00
- Stable releases with long-term support, which contains important bugfixes and security fixes. See [these docs](https://docs.victoriametrics.com/lts-releases/).
docs/enterprise.md: prioritize enterprise technical support over other enterprise features
2024-02-06 13:52:33 +00:00
- First-class consulting and technical support provided by the core VictoriaMetrics dev team.
- [Monitoring of monitoring](https://victoriametrics.com/products/mom/) - this feature allows forecasting
and preventing possible issues in VictoriaMetrics setups.
- [Enterprise security compliance](https://victoriametrics.com/security/).
- Prioritizing of feature requests from Enterprise customers.
docs/enterprise.md: remove duplicate Enterprise word in the same sentence
2024-02-12 09:00:35 +00:00
On top of this, Enterprise package of VictoriaMetrics includes the following features:
docs/enterprise.md: prioritize enterprise technical support over other enterprise features
2024-02-06 13:52:33 +00:00
docs/enterprise.md: describe all the enteprise features in a short doc at https://docs.victoriametrics.com/enterprise.html
2022-10-24 15:00:25 +00:00
- [Downsampling](https://docs.victoriametrics.com/#downsampling) - this feature allows reducing storage costs
and increasing performance for queries over historical data.
- [Multiple retentions](https://docs.victoriametrics.com/#retention-filters) - this feature allows reducing storage costs
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
by specifying different retentions for different datasets.
all: replace old https://docs.victoriametrics.com/Cluster-VictoriaMetrics.html url with the new one - https://docs.victoriametrics.com/cluster-victoriametrics/
2024-04-18 00:54:20 +00:00
- [Automatic discovery of vmstorage nodes](https://docs.victoriametrics.com/cluster-victoriametrics/#automatic-vmstorage-discovery) -
app/{vminsert,vmselect}: add support for automatic discovery and update of vmstorage nodes Thanks to @dmitryk-dk for the initial implemenation at https://github.com/VictoriaMetrics/VictoriaMetrics-enterprise/pull/446
2022-10-28 10:07:40 +00:00
this feature allows updating the list of `vmstorage` nodes at `vminsert` and `vmselect` without the need to restart these services.
docs/vmanomaly: v1.12 updates & fixes (#6046) * docs/vmanomaly: v1.12.0 & link updates * add autotuned description to model section * - update refs of vmanomaly on enterprise and vmalert pages - add diagrams for model types - update self-monitoring section * - fix typos - remove .index.html from links
2024-04-01 13:41:55 +00:00
- [Anomaly Detection Service](https://docs.victoriametrics.com/anomaly-detection) - this feature allows automation and simplification of your alerting rules, covering [complex anomalies](https://victoriametrics.com/blog/victoriametrics-anomaly-detection-handbook-chapter-2/) found in metrics data.
all: replace old https://docs.victoriametrics.com/vmbackupmanager.html url with the new one - https://docs.victoriametrics.com/vmbackupmanager/
2024-04-18 00:03:58 +00:00
- [Backup automation](https://docs.victoriametrics.com/vmbackupmanager/).
all: replace old https://docs.victoriametrics.com/PerTenantStatistic.html url with the new one - https://docs.victoriametrics.com/pertenantstatistic/
2024-04-18 01:35:44 +00:00
- [Advanced per-tenant stats](https://docs.victoriametrics.com/pertenantstatistic/).
all: replace old https://docs.victoriametrics.com/vmgateway.html url with the new one - https://docs.victoriametrics.com/vmgateway/
2024-04-18 00:08:18 +00:00
- [Advanced auth and rate limiter](https://docs.victoriametrics.com/vmgateway/).
lib/httpserver: add support for automatic issuing of TLS certificates via Lets Encrypt service Updates https://github.com/VictoriaMetrics/VictoriaMetrics/issues/5949
2024-04-17 21:38:16 +00:00
- [Automatic issuing of TLS certificates](https://docs.victoriametrics.com/#automatic-issuing-of-tls-certificates).
lib/httpserver: add support for mTLS for requests to -httpListenAddr
2024-02-06 15:40:48 +00:00
- [mTLS for all the VictoriaMetrics components](https://docs.victoriametrics.com/#mtls-protection).
all: replace old https://docs.victoriametrics.com/Cluster-VictoriaMetrics.html url with the new one - https://docs.victoriametrics.com/cluster-victoriametrics/
2024-04-18 00:54:20 +00:00
- [mTLS for communications between cluster components](https://docs.victoriametrics.com/cluster-victoriametrics/#mtls-protection).
all: replace old https://docs.victoriametrics.com/vmauth.html url with the new one - https://docs.victoriametrics.com/vmauth/
2024-04-17 23:49:41 +00:00
- [mTLS-based request routing](https://docs.victoriametrics.com/vmauth/#mtls-based-request-routing).
all: replace the outdated url https://docs.victoriametrics.com/vmagent.html with the new one - https://docs.victoriametrics.com/vmagent/
2024-04-17 23:31:37 +00:00
- [Kafka integration](https://docs.victoriametrics.com/vmagent/#kafka-integration).
- [Google PubSub integration](https://docs.victoriametrics.com/vmagent/#google-pubsub-integration).
all: replace old https://docs.victoriametrics.com/vmalert.html url with the new one - https://docs.victoriametrics.com/vmalert/
2024-04-17 23:44:12 +00:00
- [Multitenant support in vmalert](https://docs.victoriametrics.com/vmalert/#multitenancy).
- [Ability to read alerting and recording rules from Object Storage](https://docs.victoriametrics.com/vmalert/#reading-rules-from-object-storage).
all: replace old https://docs.victoriametrics.com/vmauth.html url with the new one - https://docs.victoriametrics.com/vmauth/
2024-04-17 23:49:41 +00:00
- [Ability to filter incoming requests by IP at vmauth](https://docs.victoriametrics.com/vmauth/#ip-filters).
docs/enterprise.md: describe all the enteprise features in a short doc at https://docs.victoriametrics.com/enterprise.html
2022-10-24 15:00:25 +00:00
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
Contact us via [this page](https://victoriametrics.com/products/enterprise/) if you are interested in VictoriaMetrics Enterprise.
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
## Running VictoriaMetrics Enterprise
VictoriaMetrics Enterprise components are available in the following forms:
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
- [Binary releases](#binary-releases)
- [Docker images](#docker-images)
- [Helm charts](#helm-charts)
- [Kubernetes operator](#kubernetes-operator)
### Binary releases
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
It is allowed to run VictoriaMetrics Enterprise components in [cases listed here](#valid-cases-for-victoriametrics-enterprise).
docs: use https://github.com/VictoriaMetrics/VictoriaMetrics/releases/latest instead of https://github.com/VictoriaMetrics/VictoriaMetrics/releases link where needed The https://github.com/VictoriaMetrics/VictoriaMetrics/releases link may show non-latest releases at the top, such as LTS releases or VictoriaLogs releases. So it is better to use https://github.com/VictoriaMetrics/VictoriaMetrics/releases/latest link, which always redirect to the latest available release of VictoriaMetrics.
2023-10-18 18:06:23 +00:00
Binary releases of VictoriaMetrics Enterprise are available [at the releases page](https://github.com/VictoriaMetrics/VictoriaMetrics/releases/latest).
{docker,docs}: update references to latest release Update references to latest release - v1.106.0. --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2024-11-05 17:40:13 +00:00
Enterprise binaries and packages have `enterprise` suffix in their names. For example, `victoria-metrics-linux-amd64-v1.106.0-enterprise.tar.gz`.
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
In order to run binary release of VictoriaMetrics Enterprise component, please download the `*-enterprise.tar.gz` archive for your OS and architecture
docs: use https://github.com/VictoriaMetrics/VictoriaMetrics/releases/latest instead of https://github.com/VictoriaMetrics/VictoriaMetrics/releases link where needed The https://github.com/VictoriaMetrics/VictoriaMetrics/releases link may show non-latest releases at the top, such as LTS releases or VictoriaLogs releases. So it is better to use https://github.com/VictoriaMetrics/VictoriaMetrics/releases/latest link, which always redirect to the latest available release of VictoriaMetrics.
2023-10-18 18:06:23 +00:00
from the [releases page](https://github.com/VictoriaMetrics/VictoriaMetrics/releases/latest) and unpack it. Then run the unpacked binary.
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
docs/enterprise.md: remove the mention of deprecated -eula command-line flag
2024-02-13 16:46:56 +00:00
All the VictoriaMetrics Enterprise components require specifying the following command-line flags:
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
* `-license` - this flag accepts VictoriaMetrics Enterprise license key, which can be obtained at [this page](https://victoriametrics.com/products/enterprise/trial/)
* `-licenseFile` - this flag accepts a path to file with VictoriaMetrics Enterprise license key,
which can be obtained at [this page](https://victoriametrics.com/products/enterprise/trial/) . Use either `-license` or `-licenseFile`, but not both.
license: add ability to reload keys (#775) * lib/license: add support of license key hot-reload * docs: add info about license key hot reload --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2024-09-04 13:23:23 +00:00
* `-licenseFile.reloadInterval` - specifies the interval for checking the license file for updates. The default value is 1 hour. If the license file is updated, the new license key is read from the file.
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
* `-license.forceOffline` - enables offline verification of VictoriaMetrics Enterprise license key. Contact us via [this page](https://victoriametrics.com/products/enterprise/)
if you need license key, which can be verified offline without the need to connect to VictoriaMetrics license server.
For example, the following command runs VictoriaMetrics Enterprise binary with the Enterprise license
obtained at [this page](https://victoriametrics.com/products/enterprise/trial/):
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
docs: follow-up after 491287ed1552798161c6e197fbf391770602d2b9 * port un-synced changed from docs/readme to readme * consistently use `sh` instead of `console` highlight, as it looks like a more appropriate syntax highlight * consistently use `sh` instead of `bash`, as it is shorter * consistently use `yaml` instead of `yml` See syntax codes here https://gohugo.io/content-management/syntax-highlighting/ Signed-off-by: hagen1778 <roman@victoriametrics.com>
2024-01-27 18:29:11 +00:00
```sh
{docker,docs}: update references to latest release Update references to latest release - v1.106.0. --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2024-11-05 17:40:13 +00:00
wget https://github.com/VictoriaMetrics/VictoriaMetrics/releases/download/v1.106.0/victoria-metrics-linux-amd64-v1.106.0-enterprise.tar.gz
tar -xzf victoria-metrics-linux-amd64-v1.106.0-enterprise.tar.gz
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
./victoria-metrics-prod -license=BASE64_ENCODED_LICENSE_KEY
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
```
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
Alternatively, VictoriaMetrics Enterprise license can be stored in the file and then referred via `-licenseFile` command-line flag:
docs: follow-up after 491287ed1552798161c6e197fbf391770602d2b9 * port un-synced changed from docs/readme to readme * consistently use `sh` instead of `console` highlight, as it looks like a more appropriate syntax highlight * consistently use `sh` instead of `bash`, as it is shorter * consistently use `yaml` instead of `yml` See syntax codes here https://gohugo.io/content-management/syntax-highlighting/ Signed-off-by: hagen1778 <roman@victoriametrics.com>
2024-01-27 18:29:11 +00:00
```sh
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
./victoria-metrics-prod -licenseFile=/path/to/vm-license
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
```
### Docker images
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
It is allowed to run VictoriaMetrics Enterprise components in [cases listed here](#valid-cases-for-victoriametrics-enterprise).
Docker images for VictoriaMetrics Enterprise are available [at VictoriaMetrics DockerHub](https://hub.docker.com/u/victoriametrics).
{docker,docs}: update references to latest release Update references to latest release - v1.106.0. --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2024-11-05 17:40:13 +00:00
Enterprise docker images have `enterprise` suffix in their names. For example, `victoriametrics/victoria-metrics:v1.106.0-enterprise`.
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
In order to run Docker image of VictoriaMetrics Enterprise component, it is required to provide the license key via command-line
flag as described [here](#binary-releases).
Enterprise license key can be obtained at [this page](https://victoriametrics.com/products/enterprise/trial/).
For example, the following command runs VictoriaMetrics Enterprise Docker image with the specified license key:
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
docs: follow-up after 491287ed1552798161c6e197fbf391770602d2b9 * port un-synced changed from docs/readme to readme * consistently use `sh` instead of `console` highlight, as it looks like a more appropriate syntax highlight * consistently use `sh` instead of `bash`, as it is shorter * consistently use `yaml` instead of `yml` See syntax codes here https://gohugo.io/content-management/syntax-highlighting/ Signed-off-by: hagen1778 <roman@victoriametrics.com>
2024-01-27 18:29:11 +00:00
```sh
{docker,docs}: update references to latest release Update references to latest release - v1.106.0. --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2024-11-05 17:40:13 +00:00
docker run --name=victoria-metrics victoriametrics/victoria-metrics:v1.106.0-enterprise -license=BASE64_ENCODED_LICENSE_KEY
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
```
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
Alternatively, the license code can be stored in the file and then referred via `-licenseFile` command-line flag:
docs: follow-up after 491287ed1552798161c6e197fbf391770602d2b9 * port un-synced changed from docs/readme to readme * consistently use `sh` instead of `console` highlight, as it looks like a more appropriate syntax highlight * consistently use `sh` instead of `bash`, as it is shorter * consistently use `yaml` instead of `yml` See syntax codes here https://gohugo.io/content-management/syntax-highlighting/ Signed-off-by: hagen1778 <roman@victoriametrics.com>
2024-01-27 18:29:11 +00:00
```sh
{docker,docs}: update references to latest release Update references to latest release - v1.106.0. --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2024-11-05 17:40:13 +00:00
docker run --name=victoria-metrics -v /vm-license:/vm-license victoriametrics/victoria-metrics:v1.106.0-enterprise -licenseFile=/path/to/vm-license
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
```
Example docker-compose configuration:
```yaml
version: "3.5"
services:
victoriametrics:
container_name: victoriametrics
{docker,docs}: update references to latest release Update references to latest release - v1.106.0. --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2024-11-05 17:40:13 +00:00
image: victoriametrics/victoria-metrics:v1.106.0
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
ports:
- 8428:8428
volumes:
- vmdata:/storage
- /vm-license:/vm-license
command:
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
- "-storageDataPath=/storage"
- "-licenseFile=/vm-license"
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
volumes:
vmdata: {}
```
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
The example assumes that the license file is stored at `/vm-license` on the host.
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
### Helm charts
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
It is allowed to run VictoriaMetrics Enterprise components in [cases listed here](#valid-cases-for-victoriametrics-enterprise).
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
Helm charts for VictoriaMetrics Enterprise components are available [here](https://github.com/VictoriaMetrics/helm-charts).
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
In order to run VictoriaMetrics Enterprise helm chart it is required to provide the license key via `license` value in `values.yaml` file
and adjust the image tag to the Enterprise one as described [here](#docker-images).
Enterprise license key can be obtained at [this page](https://victoriametrics.com/products/enterprise/trial/).
For example, the following `values` file for [VictoriaMetrics single-node chart](https://github.com/VictoriaMetrics/helm-charts/tree/master/charts/victoria-metrics-single)
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
is used to provide key in plain-text:
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
```yaml
server:
image:
{docker,docs}: update references to latest release Update references to latest release - v1.106.0. --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2024-11-05 17:40:13 +00:00
tag: v1.106.0-enterprise
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
license:
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
key: {BASE64_ENCODED_LICENSE_KEY}
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
```
In order to provide key via existing secret, the following values file is used:
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
```yaml
server:
image:
{docker,docs}: update references to latest release Update references to latest release - v1.106.0. --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2024-11-05 17:40:13 +00:00
tag: v1.106.0-enterprise
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
license:
secret:
name: vm-license
key: license
```
Example secret with license key:
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
```yaml
apiVersion: v1
kind: Secret
metadata:
name: vm-license
type: Opaque
data:
license: {BASE64_ENCODED_LICENSE_KEY}
```
Or create secret via `kubectl`:
docs: follow-up after 491287ed1552798161c6e197fbf391770602d2b9 * port un-synced changed from docs/readme to readme * consistently use `sh` instead of `console` highlight, as it looks like a more appropriate syntax highlight * consistently use `sh` instead of `bash`, as it is shorter * consistently use `yaml` instead of `yml` See syntax codes here https://gohugo.io/content-management/syntax-highlighting/ Signed-off-by: hagen1778 <roman@victoriametrics.com>
2024-01-27 18:29:11 +00:00
```sh
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
kubectl create secret generic vm-license --from-literal=license={BASE64_ENCODED_LICENSE_KEY}
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
```
license: add ability to reload keys (#775) * lib/license: add support of license key hot-reload * docs: add info about license key hot reload --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2024-09-04 13:23:23 +00:00
Note that license key provided by using secret is mounted in a file. This allows to perform updates of the license without the need to restart the pod.
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
### Kubernetes operator
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
It is allowed to run VictoriaMetrics Enterprise components in [cases listed here](#valid-cases-for-victoriametrics-enterprise).
VictoriaMetrics Enterprise components can be deployed via [VictoriaMetrics operator](https://docs.victoriametrics.com/operator/).
In order to use Enterprise components it is required to provide the license key via `license` field and adjust the image tag to the enterprise one.
Enterprise license key can be obtained at [this page](https://victoriametrics.com/products/enterprise/trial/).
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
all: replace old https://docs.victoriametrics.com/Single-server-VictoriaMetrics.html url with the new one - https://docs.victoriametrics.com/single-server-victoriametrics/
2024-04-18 01:11:03 +00:00
For example, the following custom resource for [VictoriaMetrics single-node](https://docs.victoriametrics.com/single-server-victoriametrics/)
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
is used to provide key in plain-text:
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
```yaml
apiVersion: operator.victoriametrics.com/v1beta1
kind: VMSingle
metadata:
name: example-vmsingle
spec:
retentionPeriod: "1"
license:
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
key: {BASE64_ENCODED_LICENSE_KEY}
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
image:
{docker,docs}: update references to latest release Update references to latest release - v1.106.0. --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2024-11-05 17:40:13 +00:00
tag: v1.106.0-enterprise
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
```
In order to provide key via existing secret, the following custom resource is used:
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
```yaml
apiVersion: operator.victoriametrics.com/v1beta1
kind: VMSingle
metadata:
name: example-vmsingle
spec:
retentionPeriod: "1"
license:
keyRef:
name: vm-license
key: license
image:
{docker,docs}: update references to latest release Update references to latest release - v1.106.0. --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2024-11-05 17:40:13 +00:00
tag: v1.106.0-enterprise
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
```
Example secret with license key:
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
```yaml
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
apiVersion: v1
kind: Secret
metadata:
name: vm-license
type: Opaque
data:
license: {BASE64_ENCODED_LICENSE_KEY}
```
Or create secret via `kubectl`:
docs: follow-up after 491287ed1552798161c6e197fbf391770602d2b9 * port un-synced changed from docs/readme to readme * consistently use `sh` instead of `console` highlight, as it looks like a more appropriate syntax highlight * consistently use `sh` instead of `bash`, as it is shorter * consistently use `yaml` instead of `yml` See syntax codes here https://gohugo.io/content-management/syntax-highlighting/ Signed-off-by: hagen1778 <roman@victoriametrics.com>
2024-01-27 18:29:11 +00:00
```sh
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
kubectl create secret generic vm-license --from-literal=license={BASE64_ENCODED_LICENSE_KEY}
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
```
license: add ability to reload keys (#775) * lib/license: add support of license key hot-reload * docs: add info about license key hot reload --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2024-09-04 13:23:23 +00:00
Note that license key provided by using secret is mounted in a file. This allows to perform updates of the license without the need to restart the pod.
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
See full list of CRD specifications [here](https://docs.victoriametrics.com/operator/api.html).
## Monitoring license expiration
lib/license: cleanups and prettifications for log messages and docs related to licensing - Make more clear the docs at docs/enterprise.md, so readers could figure out faster on how to obtain enterprise key and how to pass it to VictoriaMetrics Enterprise components. - Fix examples at docs/enterprise.md, which were referring to non-existing `-license-file` command-line flag. The `-licenseFile` command-line flag must be used instead. - Improve the description of `-license*` command-line flags, so users could understand faster how to use them. - Improve the warning message, which is emitted when the deprecated -eula command-line flag is passed, so the user could figure out how to switch faster to -license* command-line flags. - Disallow running VictoriaMetrics components with both -license and -licenseFile command-line flags. - Disallow running VictoriaMetrics components when -licensFile points to an empty file. - Consistently use the phrase "This flag is available only in Enterprise binaries" across all the enterprise-specific command-line flags. - Remove unneeded level of indirection for `noLicenseMessage` and `expiredMessage` string contants in order to improve code readability and maintainability. - Remove unneded `return` statements after `logger.Fatalf()` calls, since these calls exit the app and never return. - Make sure that the info log message about successful license verification is emitted when the license is verified successfully. Previously the error message could be logged when the license payload is invalid or if it misses some required features.
2023-10-13 11:07:16 +00:00
All the VictoriaMetrics Enterprise components expose the following metrics at the `/metrics` page:
* `vm_license_expires_at` - license expiration date in unix timestamp format
* `vm_license_expires_in_seconds` - the number of seconds left until the license expires
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
all: replace old https://docs.victoriametrics.com/vmalert.html url with the new one - https://docs.victoriametrics.com/vmalert/
2024-04-17 23:44:12 +00:00
Example alerts for [vmalert](https://docs.victoriametrics.com/vmalert/) based on these metrics:
docs/enterprise: add info about license flags (#5085) * docs/enterprise: add info about license flags Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add more examples on how to run enterprise components Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: address review feedback Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: specify release version Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: fix image tag in example Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> * docs/enterprise: add docker-compose example, fix secret name Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com> --------- Signed-off-by: Zakhar Bessarab <z.bessarab@victoriametrics.com>
2023-10-05 09:05:57 +00:00
```yaml
groups:
- name: vm-license
# note the `job` label and update accordingly to your setup
rules:
- alert: LicenseExpiresInLessThan30Days
expr: vm_license_expires_in_seconds < 30 * 24 * 3600
labels:
severity: warning
annotations:
summary: "{{ $labels.job }} instance {{ $labels.instance }} license expires in less than 30 days"
description: "{{ $labels.instance }} of job {{ $labels.job }} license expires in {{ $value | humanizeDuration }}.
Please make sure to update the license before it expires."
- alert: LicenseExpiresInLessThan7Days
expr: vm_license_expires_in_seconds < 7 * 24 * 3600
labels:
severity: critical
annotations:
summary: "{{ $labels.job }} instance {{ $labels.instance }} license expires in less than 7 days"
description: "{{ $labels.instance }} of job {{ $labels.job }} license expires in {{ $value | humanizeDuration }}.
Please make sure to update the license before it expires."
```
Reference in a new issue Copy permalink