summaryrefslogtreecommitdiff
path: root/vendor/go.opentelemetry.io/contrib/instrumentation/runtime/internal/x/README.md
diff options
context:
space:
mode:
authorLibravatar Daenney <daenney@noreply.codeberg.org>2025-05-06 08:18:05 +0000
committerLibravatar tobi <kipvandenbos@noreply.codeberg.org>2025-05-06 08:18:05 +0000
commit90a5425fe9776a18ea9a8d2b6ec98dc36a9117af (patch)
treefe6a0eb8569d369a8180cca24c9578b66cf8fef2 /vendor/go.opentelemetry.io/contrib/instrumentation/runtime/internal/x/README.md
parent[bugfix] Fixes to tablist, fileinput, checkbox (#4139) (diff)
downloadgotosocial-90a5425fe9776a18ea9a8d2b6ec98dc36a9117af.tar.xz
[chore] Add Go runtime and host metrics (#4137)
Daenney is a dummy and forgot to add these when he revamped the OTEL stuff. Reviewed-on: https://codeberg.org/superseriousbusiness/gotosocial/pulls/4137 Co-authored-by: Daenney <daenney@noreply.codeberg.org> Co-committed-by: Daenney <daenney@noreply.codeberg.org>
Diffstat (limited to 'vendor/go.opentelemetry.io/contrib/instrumentation/runtime/internal/x/README.md')
-rw-r--r--vendor/go.opentelemetry.io/contrib/instrumentation/runtime/internal/x/README.md38
1 files changed, 38 insertions, 0 deletions
diff --git a/vendor/go.opentelemetry.io/contrib/instrumentation/runtime/internal/x/README.md b/vendor/go.opentelemetry.io/contrib/instrumentation/runtime/internal/x/README.md
new file mode 100644
index 000000000..a2367651a
--- /dev/null
+++ b/vendor/go.opentelemetry.io/contrib/instrumentation/runtime/internal/x/README.md
@@ -0,0 +1,38 @@
+# Feature Gates
+
+The runtime package contains a feature gate used to ease the migration
+from the [previous runtime metrics conventions] to the new [OpenTelemetry Go
+Runtime conventions].
+
+Note that the new runtime metrics conventions are still experimental, and may
+change in backwards incompatible ways as feedback is applied.
+
+## Features
+
+- [Include Deprecated Metrics](#include-deprecated-metrics)
+
+### Include Deprecated Metrics
+
+Once new experimental runtime metrics are added, they will be produced
+**in addition to** the existing runtime metrics. Users that migrate right away
+can disable the old runtime metrics:
+
+```console
+export OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=false
+```
+
+In a later release, the deprecated runtime metrics will stop being produced by
+default. To temporarily re-enable the deprecated metrics:
+
+```console
+export OTEL_GO_X_DEPRECATED_RUNTIME_METRICS=true
+```
+
+After two additional releases, the deprecated runtime metrics will be removed,
+and setting the environment variable will no longer have any effect.
+
+The value set must be the case-insensitive string of `"true"` to enable the
+feature, and `"false"` to disable the feature. All other values are ignored.
+
+[previous runtime metrics conventions]: https://pkg.go.dev/go.opentelemetry.io/contrib/instrumentation/runtime@v0.52.0
+[OpenTelemetry Go Runtime conventions]: https://github.com/open-telemetry/semantic-conventions/blob/main/docs/runtime/go-metrics.md