StatsD output scheduled removal (#1673)

* StatsD output scheduled removal * Suggest OpenTelemetry * Apply suggestions from code review Co-authored-by: Heitor Tashiro Sergent <[email protected]> --------- Co-authored-by: Heitor Tashiro Sergent <[email protected]>
grafana · Aug 2, 2024 · 9eb02ec · 9eb02ec
1 parent 98219e8
commit 9eb02ec
Show file tree

Hide file tree

Showing 6 changed files with 16 additions and 35 deletions.
diff --git a/docs/sources/next/results-output/real-time/amazon-cloudwatch.md b/docs/sources/next/results-output/real-time/amazon-cloudwatch.md
@@ -6,13 +6,7 @@ weight: 00
 
 # Amazon CloudWatch
 
-{{% admonition type="warning" %}}
-
-The built-in StatsD output has been deprecated on k6 v0.47.0. You can continue to use this feature by using the [xk6-output-statsd extension](https://github.com/LeonAdato/xk6-output-statsd), and this guide has been updated to include instructions for how to use it.
-
-For more information on the reason behind this change, you can follow [this issue](https://github.com/grafana/k6/issues/2982) in the k6 repository.
-
-{{< /admonition >}}
+{{< docs/shared source="k6" lookup="statsd-output.md" version="<K6_VERSION>" >}}
 
 k6 can send metrics data to [Amazon CloudWatch](https://aws.amazon.com/cloudwatch/) through the [CloudWatch Agent](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html) by using the [xk6-output-statsd extension](https://github.com/LeonAdato/xk6-output-statsd). These metrics can then be visualized in dashboards.
 

diff --git a/docs/sources/next/results-output/real-time/datadog.md b/docs/sources/next/results-output/real-time/datadog.md
@@ -6,13 +6,7 @@ weight: 00
 
 # Datadog
 
-{{% admonition type="warning" %}}
-
-The built-in StatsD output has been deprecated on k6 v0.47.0. You can continue to use this feature by using the [xk6-output-statsd extension](https://github.com/LeonAdato/xk6-output-statsd), and this guide has been updated to include instructions for how to use it.
-
-For more information on the reason behind this change, you can follow [this issue](https://github.com/grafana/k6/issues/2982) in the k6 repository.
-
-{{< /admonition >}}
+{{< docs/shared source="k6" lookup="statsd-output.md" version="<K6_VERSION>" >}}
 
 k6 can send metrics to [Datadog](https://www.datadoghq.com/). That allows visualizing and correlating performance testing metrics with other monitored metrics in Datadog.
 

diff --git a/docs/sources/next/results-output/real-time/netdata.md b/docs/sources/next/results-output/real-time/netdata.md
@@ -6,13 +6,7 @@ weight: 00
 
 # Netdata
 
-{{% admonition type="warning" %}}
-
-The built-in StatsD output has been deprecated on k6 v0.47.0. You can continue to use this feature by using the [xk6-output-statsd extension](https://github.com/LeonAdato/xk6-output-statsd), and this guide has been updated to include instructions for how to use it.
-
-For more information on the reason behind this change, you can follow [this issue](https://github.com/grafana/k6/issues/2982) in the k6 repository.
-
-{{< /admonition >}}
+{{< docs/shared source="k6" lookup="statsd-output.md" version="<K6_VERSION>" >}}
 
 k6 can send performance testing metrics to [Netdata](https://netdata.cloud). This enables the user to start monitoring their k6 experiments right away, as Netdata is a monitoring tool with:
 

diff --git a/docs/sources/next/results-output/real-time/newrelic.md b/docs/sources/next/results-output/real-time/newrelic.md
@@ -7,13 +7,7 @@ slug: 'new-relic'
 
 # New Relic
 
-{{% admonition type="warning" %}}
-
-The built-in StatsD output has been deprecated on k6 v0.47.0. You can continue to use this feature by using the [xk6-output-statsd extension](https://github.com/LeonAdato/xk6-output-statsd), and this guide has been updated to include instructions for how to use it.
-
-For more information on the reason behind this change, you can follow [this issue](https://github.com/grafana/k6/issues/2982) in the k6 repository.
-
-{{< /admonition >}}
+{{< docs/shared source="k6" lookup="statsd-output.md" version="<K6_VERSION>" >}}
 
 k6 can send telemetry data to [New Relic](https://newrelic.com/) through the New Relic [StatsD integration](https://docs.newrelic.com/docs/integrations/host-integrations/host-integrations-list/statsd-monitoring-integration-version-2). Within New Relic you can find your k6 performance data alongside your real users data and server side performance. This data can be visualized in dashboards and shared with others, used to compare load impact with system performance, and alert on metrics too.
 

diff --git a/docs/sources/next/results-output/real-time/statsd.md b/docs/sources/next/results-output/real-time/statsd.md
@@ -6,13 +6,7 @@ weight: 00
 
 # StatsD
 
-{{% admonition type="warning" %}}
-
-The built-in StatsD output has been deprecated on k6 v0.47.0. You can continue to use this feature by using the [xk6-output-statsd extension](https://github.com/LeonAdato/xk6-output-statsd), and this guide has been updated to include instructions for how to use it.
-
-For more information on the reason behind this change, you can follow [this issue](https://github.com/grafana/k6/issues/2982) in the k6 repository.
-
-{{< /admonition >}}
+{{< docs/shared source="k6" lookup="statsd-output.md" version="<K6_VERSION>" >}}
 
 k6 can push test metrics to a [StatsD](https://github.com/statsd/statsd) service by using the [xk6-output-statsd extension](https://github.com/LeonAdato/xk6-output-statsd).
 

diff --git a/docs/sources/next/shared/statsd-output.md b/docs/sources/next/shared/statsd-output.md
@@ -0,0 +1,11 @@
+---
+title: StatsD module admonition
+---
+
+{{< admonition type="warning" >}}
+
+The built-in StatsD output has been deprecated on k6 v0.47.0 and [scheduled to be removed in v0.55.0](https://github.com/grafana/k6/pull/3849). You can continue to use this feature by using the [xk6-output-statsd extension](https://github.com/LeonAdato/xk6-output-statsd), or using the [OpenTelemetry output](https://grafana.com/docs/k6/<K6_VERSION>/results-output/real-time/opentelemetry/) depending on your use case.
+
+For more information on the reason behind this change, you can follow [this issue](https://github.com/grafana/k6/issues/2982) in the k6 repository.
+
+{{< /admonition >}}