diff --git a/.github/ISSUE_TEMPLATE/blank.yaml b/.github/ISSUE_TEMPLATE/blank.yaml index 3710d1be866..3560f736c83 100644 --- a/.github/ISSUE_TEMPLATE/blank.yaml +++ b/.github/ISSUE_TEMPLATE/blank.yaml @@ -116,6 +116,7 @@ body: - otelcol.processor.interval - otelcol.processor.k8sattributes - otelcol.processor.memory_limiter + - otelcol.processor.metric_start_time - otelcol.processor.probabilistic_sampler - otelcol.processor.resourcedetection - otelcol.processor.span diff --git a/.github/ISSUE_TEMPLATE/bug_report.yaml b/.github/ISSUE_TEMPLATE/bug_report.yaml index 7230d55bdf1..4b416afef53 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yaml +++ b/.github/ISSUE_TEMPLATE/bug_report.yaml @@ -116,6 +116,7 @@ body: - otelcol.processor.interval - otelcol.processor.k8sattributes - otelcol.processor.memory_limiter + - otelcol.processor.metric_start_time - otelcol.processor.probabilistic_sampler - otelcol.processor.resourcedetection - otelcol.processor.span diff --git a/.github/ISSUE_TEMPLATE/docs.yaml b/.github/ISSUE_TEMPLATE/docs.yaml index 54d478b5956..49edbb49d58 100644 --- a/.github/ISSUE_TEMPLATE/docs.yaml +++ b/.github/ISSUE_TEMPLATE/docs.yaml @@ -119,6 +119,7 @@ body: - otelcol.processor.interval - otelcol.processor.k8sattributes - otelcol.processor.memory_limiter + - otelcol.processor.metric_start_time - otelcol.processor.probabilistic_sampler - otelcol.processor.resourcedetection - otelcol.processor.span diff --git a/.github/ISSUE_TEMPLATE/feature_request.yaml b/.github/ISSUE_TEMPLATE/feature_request.yaml index dc5e8a96343..4bab64a6bd6 100644 --- a/.github/ISSUE_TEMPLATE/feature_request.yaml +++ b/.github/ISSUE_TEMPLATE/feature_request.yaml @@ -116,6 +116,7 @@ body: - otelcol.processor.interval - otelcol.processor.k8sattributes - otelcol.processor.memory_limiter + - otelcol.processor.metric_start_time - otelcol.processor.probabilistic_sampler - otelcol.processor.resourcedetection - otelcol.processor.span diff --git a/.github/ISSUE_TEMPLATE/proposal.yaml b/.github/ISSUE_TEMPLATE/proposal.yaml index dce026a5475..df4e4506521 100644 --- a/.github/ISSUE_TEMPLATE/proposal.yaml +++ b/.github/ISSUE_TEMPLATE/proposal.yaml @@ -116,6 +116,7 @@ body: - otelcol.processor.interval - otelcol.processor.k8sattributes - otelcol.processor.memory_limiter + - otelcol.processor.metric_start_time - otelcol.processor.probabilistic_sampler - otelcol.processor.resourcedetection - otelcol.processor.span diff --git a/collector/go.mod b/collector/go.mod index 99887d3ab62..ba92367de42 100644 --- a/collector/go.mod +++ b/collector/go.mod @@ -676,6 +676,7 @@ require ( github.com/open-telemetry/opentelemetry-collector-contrib/processor/groupbyattrsprocessor v0.142.0 // indirect github.com/open-telemetry/opentelemetry-collector-contrib/processor/intervalprocessor v0.142.0 // indirect github.com/open-telemetry/opentelemetry-collector-contrib/processor/k8sattributesprocessor v0.142.0 // indirect + github.com/open-telemetry/opentelemetry-collector-contrib/processor/metricstarttimeprocessor v0.142.0 // indirect github.com/open-telemetry/opentelemetry-collector-contrib/processor/resourcedetectionprocessor v0.142.0 // indirect github.com/open-telemetry/opentelemetry-collector-contrib/processor/tailsamplingprocessor v0.142.0 // indirect github.com/open-telemetry/opentelemetry-collector-contrib/processor/transformprocessor v0.142.0 // indirect diff --git a/collector/go.sum b/collector/go.sum index 106958c3081..1d7f968fc1c 100644 --- a/collector/go.sum +++ b/collector/go.sum @@ -1874,6 +1874,8 @@ github.com/open-telemetry/opentelemetry-collector-contrib/processor/intervalproc github.com/open-telemetry/opentelemetry-collector-contrib/processor/intervalprocessor v0.142.0/go.mod h1:Ggho2ol6+k+WvicHJqGlD26ARkJt5NEPoz7bdOUYzdE= github.com/open-telemetry/opentelemetry-collector-contrib/processor/k8sattributesprocessor v0.142.0 h1:oq+Qai4+JgqvDkbVy9ObqD4p527ObwyDRvtThtT5FZ0= github.com/open-telemetry/opentelemetry-collector-contrib/processor/k8sattributesprocessor v0.142.0/go.mod h1:/rXd9kVmBw277+LEDcJGJ/RRb2rVL89hNL95FUaMN9k= +github.com/open-telemetry/opentelemetry-collector-contrib/processor/metricstarttimeprocessor v0.142.0 h1:RMdnEzbfqBmNI3UT8K5//1Z1HpD8Adq1RIzCItmdgaw= +github.com/open-telemetry/opentelemetry-collector-contrib/processor/metricstarttimeprocessor v0.142.0/go.mod h1:DbnNU+vFFh3sYuJRfCDRV80fPr1GJT0YSSvqSF/2Q8c= github.com/open-telemetry/opentelemetry-collector-contrib/processor/probabilisticsamplerprocessor v0.142.0 h1:HZMvNV/HhFqUipmTGj1vZj+V6MSG/wQs4p0fAMbDF4o= github.com/open-telemetry/opentelemetry-collector-contrib/processor/probabilisticsamplerprocessor v0.142.0/go.mod h1:Ss0gY7Lj+RZAKKCUp3wzc0JFloI+f0L6OFTX+I003Qs= github.com/open-telemetry/opentelemetry-collector-contrib/processor/resourcedetectionprocessor v0.142.0 h1:JHsjepWLopcut4j2+NH545OP6V6A7mfFiEKfddOM4Jg= diff --git a/docs/sources/reference/compatibility/_index.md b/docs/sources/reference/compatibility/_index.md index a6731fc3815..7fbd2658077 100644 --- a/docs/sources/reference/compatibility/_index.md +++ b/docs/sources/reference/compatibility/_index.md @@ -341,6 +341,7 @@ The following components, grouped by namespace, _export_ OpenTelemetry `otelcol. - [otelcol.processor.interval](../components/otelcol/otelcol.processor.interval) - [otelcol.processor.k8sattributes](../components/otelcol/otelcol.processor.k8sattributes) - [otelcol.processor.memory_limiter](../components/otelcol/otelcol.processor.memory_limiter) +- [otelcol.processor.metric_start_time](../components/otelcol/otelcol.processor.metric_start_time) - [otelcol.processor.probabilistic_sampler](../components/otelcol/otelcol.processor.probabilistic_sampler) - [otelcol.processor.resourcedetection](../components/otelcol/otelcol.processor.resourcedetection) - [otelcol.processor.span](../components/otelcol/otelcol.processor.span) @@ -382,6 +383,7 @@ The following components, grouped by namespace, _consume_ OpenTelemetry `otelcol - [otelcol.processor.interval](../components/otelcol/otelcol.processor.interval) - [otelcol.processor.k8sattributes](../components/otelcol/otelcol.processor.k8sattributes) - [otelcol.processor.memory_limiter](../components/otelcol/otelcol.processor.memory_limiter) +- [otelcol.processor.metric_start_time](../components/otelcol/otelcol.processor.metric_start_time) - [otelcol.processor.probabilistic_sampler](../components/otelcol/otelcol.processor.probabilistic_sampler) - [otelcol.processor.resourcedetection](../components/otelcol/otelcol.processor.resourcedetection) - [otelcol.processor.span](../components/otelcol/otelcol.processor.span) diff --git a/docs/sources/reference/components/otelcol/otelcol.processor.metric_start_time.md b/docs/sources/reference/components/otelcol/otelcol.processor.metric_start_time.md new file mode 100644 index 00000000000..06501864ed1 --- /dev/null +++ b/docs/sources/reference/components/otelcol/otelcol.processor.metric_start_time.md @@ -0,0 +1,264 @@ +--- +canonical: https://grafana.com/docs/alloy/latest/reference/components/otelcol/otelcol.processor.metric_start_time/ +description: Learn about otelcol.processor.metric_start_time +labels: + stage: general-availability + products: + - oss +title: otelcol.processor.metric_start_time +--- + +# `otelcol.processor.metric_start_time` + +`otelcol.processor.metric_start_time` accepts metrics from other `otelcol` components and sets the start time for cumulative metric datapoints which do not already have a start time. +This processor is commonly used with `otelcol.receiver.prometheus`, which produces metric points without a [start time][otlp-start-time]. + +{{< admonition type="note" >}} +`otelcol.processor.metric_start_time` is a wrapper over the upstream OpenTelemetry Collector [`metricstarttime`][] processor. +Bug reports or feature requests will be redirected to the upstream repository, if necessary. + +[`metricstarttime`]: https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/{{< param "OTEL_VERSION" >}}/processor/metricstarttimeprocessor +{{< /admonition >}} + +You can specify multiple `otelcol.processor.metric_start_time` components by giving them different labels. + +[otlp-start-time]: https://github.com/open-telemetry/opentelemetry-proto/blob/v1.9.0/opentelemetry/proto/metrics/v1/metrics.proto#L181-L187 + +## Usage + +```alloy +otelcol.processor.metric_start_time "