[exporter/prometheusremotewrite] deprecate export_created_metric

[pokgak]

Description

Deprecate export_created_metric config option

Link to tracking issue

Fixes #35003

[linux-foundation-easycla]

The committers listed above are authorized under a signed CLA.

• ✅ login: pokgak / name: Aiman Ismail (2d62181, 365a58a, 477a6e2, 402817e)

[ArthurSens]

Thank you @pokgak!

Not sure if this is documented well, but when deprecating we can put the functionality behind a feature gate that is enabled by default. One example of feature gate can be seen here. In the example though the stability is StageAlpha (disabled by default) and we want it to considered StageBeta so it's enabled by default.

In version 0.114.0 we'll finally change it to Alpha and in 0.115.0 finally remove the option.

[pokgak]

@ArthurSens correct me if I'm wrong but isn't the feature already disabled by default so we should be using StageAlpha instead?

opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter/config.go

Lines 105 to 109 in 7ba5aa3

	if cfg.CreatedMetric == nil {
	cfg.CreatedMetric = &CreatedMetric{
	Enabled: false,
	}
	}

I pushed a commit using StageBeta but note that this will change the default value of the export_created_metric.enabled to true.

[ArthurSens]

@ArthurSens correct me if I'm wrong but isn't the feature already disabled by default so we should be using StageAlpha instead?

opentelemetry-collector-contrib/exporter/prometheusremotewriteexporter/config.go

Lines 105 to 109 in 7ba5aa3

	if cfg.CreatedMetric == nil {
	cfg.CreatedMetric = &CreatedMetric{
	Enabled: false,
	}
	}

I pushed a commit using StageBeta but note that this will change the default value of the export_created_metric.enabled to true.

Yes you're correct, I believe I wasn't clear with my previous comment, let me re-phrase it.

What we want to do is add yet another check when we're generating the created metric.

opentelemetry-collector-contrib/pkg/translator/prometheusremotewrite/helper.go

Lines 277 to 280 in 3458d51

	if settings.ExportCreatedMetric && startTimestamp != 0 {
	labels := createLabels(baseName+createdSuffix, baseLabels)
	c.addTimeSeriesIfNeeded(labels, startTimestamp, pt.Timestamp())
	}

Here we'd switch to:

 if settings.ExportCreatedMetric && startTimestamp != 0 && exportCreatedMetricGate.IsEnabled() { 
 	labels := createLabels(baseName+createdSuffix, baseLabels) 
 	c.addTimeSeriesIfNeeded(labels, startTimestamp, pt.Timestamp()) 
 } 

And then we'll have to update one test to make sure the feature-gate works as expected:

• TestPrometheusConverter_AddHistogramDataPoints

Add a new boolean to the test case struct, and in the the Run you can add:

oldValue := exportCreatedMetricGate.IsEnabled()
testutil.SetFeatureGateForTest(t, exportCreatedMetricGate, tt.isGateEnabled)
defer testutil.SetFeatureGateForTest(t, exportCreatedMetricGate, oldValue)

[ArthurSens]

Suggested change

	Enabled: exportCreatedMetricGate.IsEnabled(),
	Enabled: false,

Let's go back to false!

[ArthurSens]

Suggested change

	"exporter.prometheusremotewriteexporter.exportCreatedMetric",
	featuregate.StageBeta,
	featuregate.WithRegisterDescription("Set the default value of the export_created_metric feature."),
	featuregate.WithRegisterReferenceURL("https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/35003"),
	"exporter.prometheusremotewriteexporter.deprecateCreatedMetric",
	featuregate.StageBeta,
	featuregate.WithRegisterDescription("Feature gate used to control the deprecation of created metrics."),
	featuregate.WithRegisterReferenceURL("https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/35003"),