Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Daily release/oct 11 2024 4 28 #18948

Merged
merged 3 commits into from
Oct 11, 2024
Merged

Daily release/oct 11 2024 4 28 #18948

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
7c01b08
OpenTelemetry Summary metrics are not supported
alanwest Oct 11, 2024
be2c29a
fix(OTEL): remove colon before link
ally-sassman Oct 11, 2024
0f062c7
Merge pull request #18943 from newrelic/alanwest-patch-1
ally-sassman Oct 11, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 9 additions & 2 deletions ...tent/docs/opentelemetry/best-practices/opentelemetry-best-practices-metrics.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -449,9 +449,16 @@ Buckets with boundaries at negative and positive infinity are represented in New

### OTLP summary metrics [#otlp-summary]

OTLP [summary metrics](https://github.com/open-telemetry/opentelemetry-proto/blob/a05597bff803d3d9405fcdd1e1fb1f42bed4eb7a/opentelemetry/proto/metrics/v1/metrics.proto#L254-L256) are similar to histograms in that they summarize a population of measurements, including sum and count. However, where histograms include buckets to describe the distribution of measurements, summaries include quantiles. These quantiles are of limited use since they cannot undergo spatial or temporal reaggregation. Summaries included in OpenTelemetry for legacy support, and OpenTelemetry APIs and SDK do not produce summaries.
OTLP [summary metrics](https://github.com/open-telemetry/opentelemetry-proto/blob/a76fe9dea26871e8a6c494024bc9927fe73b8142/opentelemetry/proto/metrics/v1/metrics.proto#L274-L276) are similar to histograms in that they summarize a population of measurements, including sum and count. However, where histograms include buckets to describe the distribution of measurements, summaries include quantiles. These quantiles are of limited use since they cannot undergo spatial or temporal reaggregation. Summaries included in OpenTelemetry for legacy support, and OpenTelemetry APIs and SDK do not produce summaries.

Summaries are translated to New Relic [`summary`](/docs/data-apis/understand-data/metric-data/metric-data-type/#metric-types).
Summaries are translated to New Relic [`summary`](/docs/data-apis/understand-data/metric-data/metric-data-type/#metric-types). Note that the New Relic summary type does not support quantiles.

<Callout variant="important">
While summaries are ingested and translated to a New Relic [`summary`](/docs/data-apis/understand-data/metric-data/metric-data-type/#metric-types), they are not properly supported.
New Relic assumes summaries represent a delta since the last measurement when in fact they are cumulative metrics (see [aggregation temporality](#aggregation-temporality).
Summaries are most commonly emitted by Prometheus which is a cumulative metrics system. Therefore, New Relic does not currently support the most common use case. As such, you will
experience unexpected behavior for your summary metrics including failed ingest.
</Callout>

## Aggregation temporality [#aggregation-temporality]

Expand Down
Loading