From 48228031e4ccb499688a41871f070353125c0a7d Mon Sep 17 00:00:00 2001 From: Andrii Chubatiuk Date: Tue, 28 Nov 2023 14:52:29 +0100 Subject: [PATCH] docs: sync mistakenly deleted docs from 543f218fe96574b9b2189c8350bb09afa349e3bb https://github.com/VictoriaMetrics/VictoriaMetrics/commit/543f218fe96574b9b2189c8350bb09afa349e3bb Signed-off-by: hagen1778 --- README.md | 28 ++++++++++++++++++++++----- docs/README.md | 27 ++++++++++++++++++++++---- docs/Single-server-VictoriaMetrics.md | 10 +++++----- 3 files changed, 51 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index fbb4a05d7..8ac1bfec8 100644 --- a/README.md +++ b/README.md @@ -507,10 +507,15 @@ See also [vmagent](https://docs.victoriametrics.com/vmagent.html), which can be ## How to send data from DataDog agent -VictoriaMetrics accepts data from [DataDog agent](https://docs.datadoghq.com/agent/) -or [DogStatsD](https://docs.datadoghq.com/developers/dogstatsd/) -via ["submit metrics" API](https://docs.datadoghq.com/api/latest/metrics/#submit-metrics) -at `/datadog/api/v1/series` path. +VictoriaMetrics accepts data in the following protocols: +* [DataDog agent](https://docs.datadoghq.com/agent/) +* [DogStatsD](https://docs.datadoghq.com/developers/dogstatsd/) +* [DataDog Lambda Extension](https://docs.datadoghq.com/serverless/libraries_integrations/extension/) + +Via ["submit metrics" API](https://docs.datadoghq.com/api/latest/metrics/#submit-metrics) at the following path: +* `/datadog/api/v1/series` +* `/datadog/api/v2/series` +* `/datadog/api/beta/sketches` ### Sending metrics to VictoriaMetrics @@ -582,6 +587,19 @@ additional_endpoints: +### Send via Serverless DataDog plugin + +Disable logs (logs ingestion is not supported by Victoria Metrics) and set a custom endpoint in serverless.yaml +``` +custom: + datadog: + enableDDLogs: false # Disabled not supported DD logs + apiKey: fakekey # Set any key, otherwise plugin fails +provider: + environment: + DD_DD_URL: <>/datadog # Victoria Metrics endpoint for DataDog +``` + ### Send via cURL See how to send data to VictoriaMetrics via @@ -2564,7 +2582,7 @@ Pass `-help` to VictoriaMetrics in order to see the list of supported command-li -csvTrimTimestamp duration Trim timestamps when importing csv data to this duration. Minimum practical duration is 1ms. Higher duration (i.e. 1s) may be used for reducing disk space usage for timestamp data (default 1ms) -datadog.maxInsertRequestSize size - The maximum size in bytes of a single DataDog POST request to /api/v1/series + The maximum size in bytes of a single DataDog POST request to /api/v1/series, /api/v2/series, /api/beta/sketches Supports the following optional suffixes for size values: KB, MB, GB, TB, KiB, MiB, GiB, TiB (default 67108864) -datadog.sanitizeMetricName Sanitize metric names for the ingested DataDog data to comply with DataDog behaviour described at https://docs.datadoghq.com/metrics/custom_metrics/#naming-custom-metrics (default true) diff --git a/docs/README.md b/docs/README.md index 3338cbb42..16a884c09 100644 --- a/docs/README.md +++ b/docs/README.md @@ -510,10 +510,15 @@ See also [vmagent](https://docs.victoriametrics.com/vmagent.html), which can be ## How to send data from DataDog agent -VictoriaMetrics accepts data from [DataDog agent](https://docs.datadoghq.com/agent/) -or [DogStatsD](https://docs.datadoghq.com/developers/dogstatsd/) -via ["submit metrics" API](https://docs.datadoghq.com/api/latest/metrics/#submit-metrics) -at `/datadog/api/v1/series` path. +VictoriaMetrics accepts data in the following protocols: +* [DataDog agent](https://docs.datadoghq.com/agent/) +* [DogStatsD](https://docs.datadoghq.com/developers/dogstatsd/) +* [DataDog Lambda Extension](https://docs.datadoghq.com/serverless/libraries_integrations/extension/) + +Via ["submit metrics" API](https://docs.datadoghq.com/api/latest/metrics/#submit-metrics) at the following path: +* `/datadog/api/v1/series` +* `/datadog/api/v2/series` +* `/datadog/api/beta/sketches` ### Sending metrics to VictoriaMetrics @@ -585,6 +590,19 @@ additional_endpoints: +### Send via Serverless DataDog plugin + +Disable logs (logs ingestion is not supported by Victoria Metrics) and set a custom endpoint in serverless.yaml +``` +custom: + datadog: + enableDDLogs: false # Disabled not supported DD logs + apiKey: fakekey # Set any key, otherwise plugin fails +provider: + environment: + DD_DD_URL: <>/datadog # Victoria Metrics endpoint for DataDog +``` + ### Send via cURL See how to send data to VictoriaMetrics via @@ -2045,6 +2063,7 @@ These metrics can be scraped via [vmagent](https://docs.victoriametrics.com/vmag Alternatively, single-node VictoriaMetrics can self-scrape the metrics when `-selfScrapeInterval` command-line flag is set to duration greater than 0. For example, `-selfScrapeInterval=10s` would enable self-scraping of `/metrics` page with 10 seconds interval. + _Please note, never use loadbalancer address for scraping metrics. All monitored components should be scraped directly by their address._ Official Grafana dashboards available for [single-node](https://grafana.com/grafana/dashboards/10229-victoriametrics/) diff --git a/docs/Single-server-VictoriaMetrics.md b/docs/Single-server-VictoriaMetrics.md index a89841f33..d11d9f385 100644 --- a/docs/Single-server-VictoriaMetrics.md +++ b/docs/Single-server-VictoriaMetrics.md @@ -518,13 +518,12 @@ See also [vmagent](https://docs.victoriametrics.com/vmagent.html), which can be ## How to send data from DataDog agent -VictoriaMetrics accepts data from: +VictoriaMetrics accepts data in the following protocols: * [DataDog agent](https://docs.datadoghq.com/agent/) * [DogStatsD](https://docs.datadoghq.com/developers/dogstatsd/) * [DataDog Lambda Extension](https://docs.datadoghq.com/serverless/libraries_integrations/extension/) -via ["submit metrics" API](https://docs.datadoghq.com/api/latest/metrics/#submit-metrics) -at: +Via ["submit metrics" API](https://docs.datadoghq.com/api/latest/metrics/#submit-metrics) at the following path: * `/datadog/api/v1/series` * `/datadog/api/v2/series` * `/datadog/api/beta/sketches` @@ -560,10 +559,10 @@ dd_url: http://victoriametrics:8428/datadog -vmagent also can accept DataDog metrics format. Depending on where vmagent will forward data, +vmagent also can accept Datadog metrics format. Depending on where vmagent will forward data, pick [single-node or cluster URL](https://docs.victoriametrics.com/url-examples.html#datadog) formats. -### Sending metrics to DataDog and VictoriaMetrics +### Sending metrics to Datadog and VictoriaMetrics DataDog allows configuring [Dual Shipping](https://docs.datadoghq.com/agent/guide/dual-shipping/) for metrics sending via ENV variable `DD_ADDITIONAL_ENDPOINTS` or via configuration file `additional_endpoints`. @@ -2072,6 +2071,7 @@ These metrics can be scraped via [vmagent](https://docs.victoriametrics.com/vmag Alternatively, single-node VictoriaMetrics can self-scrape the metrics when `-selfScrapeInterval` command-line flag is set to duration greater than 0. For example, `-selfScrapeInterval=10s` would enable self-scraping of `/metrics` page with 10 seconds interval. + _Please note, never use loadbalancer address for scraping metrics. All monitored components should be scraped directly by their address._ Official Grafana dashboards available for [single-node](https://grafana.com/grafana/dashboards/10229-victoriametrics/)