Skip to content

Add deprecation notice for estimated usage types in Usage Metering API endpoints #4493

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

Merged
dd-octo-sts merged 1 commit into from
Oct 21, 2026
Merged

Add deprecation notice for estimated usage types in Usage Metering API endpoints #4493

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
16 changes: 12 additions & 4 deletions .generator/schemas/v1/openapi.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11506,19 +11506,23 @@ components:
format: double
type: number
estimated_indexed_spans_percentage:
description: The percentage of estimated indexed spans usage by tag(s).
deprecated: true
description: The percentage of estimated indexed spans usage by tag(s) (To be deprecated on February 1st, 2027).
format: double
type: number
estimated_indexed_spans_usage:
description: The estimated indexed spans usage by tag(s).
deprecated: true
description: The estimated indexed spans usage by tag(s) (To be deprecated on February 1st, 2027).
format: double
type: number
estimated_ingested_spans_percentage:
description: The percentage of estimated ingested spans usage by tag(s).
deprecated: true
description: The percentage of estimated ingested spans usage by tag(s) (To be deprecated on February 1st, 2027).
format: double
type: number
estimated_ingested_spans_usage:
description: The estimated ingested spans usage by tag(s).
deprecated: true
description: The estimated ingested spans usage by tag(s) (To be deprecated on February 1st, 2027).
format: double
type: number
fargate_percentage:
Expand Down Expand Up @@ -43108,6 +43112,8 @@ paths:
description: |-
Get hourly usage attribution. Multi-region data is available starting March 1, 2023.

**Note**: All `estimated_*` usage types will be deprecated on February 1, 2027.

This API endpoint is paginated. To make sure you receive all records, check if the value of `next_record_id` is
set in the response. If it is, make another request and pass `next_record_id` as a parameter.
Pseudo code example:
Expand Down Expand Up @@ -43712,6 +43718,8 @@ paths:
description: |-
Get monthly usage attribution. Multi-region data is available starting March 1, 2023.

**Note**: All `estimated_*` usage types will be deprecated on February 1, 2027.

This API endpoint is paginated. To make sure you receive all records, check if the value of `next_record_id` is
set in the response. If it is, make another request and pass `next_record_id` as a parameter.
Pseudo code example:
Expand Down
6 changes: 6 additions & 0 deletions src/main/java/com/datadog/api/client/v1/api/UsageMeteringApi.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -481,6 +481,9 @@ public CompletableFuture<HourlyUsageAttributionResponse> getHourlyUsageAttributi
/**
* Get hourly usage attribution. Multi-region data is available starting March 1, 2023.
*
* <p><strong>Note</strong>: All <code>estimated_*</code> usage types will be deprecated on
* February 1, 2027.
*
* <p>This API endpoint is paginated. To make sure you receive all records, check if the value of
* <code>next_record_id</code> is set in the response. If it is, make another request and pass
* <code>next_record_id</code> as a parameter. Pseudo code example:
Expand Down Expand Up @@ -1543,6 +1546,9 @@ public CompletableFuture<MonthlyUsageAttributionResponse> getMonthlyUsageAttribu
/**
* Get monthly usage attribution. Multi-region data is available starting March 1, 2023.
*
* <p><strong>Note</strong>: All <code>estimated_*</code> usage types will be deprecated on
* February 1, 2027.
*
* <p>This API endpoint is paginated. To make sure you receive all records, check if the value of
* <code>next_record_id</code> is set in the response. If it is, make another request and pass
* <code>next_record_id</code> as a parameter. Pseudo code example:
Expand Down
22 changes: 18 additions & 4 deletions src/main/java/com/datadog/api/client/v1/model/MonthlyUsageAttributionValues.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2019,17 +2019,21 @@ public MonthlyUsageAttributionValues estimatedIndexedSpansPercentage(
}

/**
* The percentage of estimated indexed spans usage by tag(s).
* The percentage of estimated indexed spans usage by tag(s) (To be deprecated on February 1st,
* 2027).
*
* @return estimatedIndexedSpansPercentage
* @deprecated
*/
@Deprecated
@jakarta.annotation.Nullable
@JsonProperty(JSON_PROPERTY_ESTIMATED_INDEXED_SPANS_PERCENTAGE)
@JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
public Double getEstimatedIndexedSpansPercentage() {
return estimatedIndexedSpansPercentage;
}

@Deprecated
public void setEstimatedIndexedSpansPercentage(Double estimatedIndexedSpansPercentage) {
this.estimatedIndexedSpansPercentage = estimatedIndexedSpansPercentage;
}
Expand All @@ -2041,17 +2045,20 @@ public MonthlyUsageAttributionValues estimatedIndexedSpansUsage(
}

/**
* The estimated indexed spans usage by tag(s).
* The estimated indexed spans usage by tag(s) (To be deprecated on February 1st, 2027).
*
* @return estimatedIndexedSpansUsage
* @deprecated
*/
@Deprecated
@jakarta.annotation.Nullable
@JsonProperty(JSON_PROPERTY_ESTIMATED_INDEXED_SPANS_USAGE)
@JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
public Double getEstimatedIndexedSpansUsage() {
return estimatedIndexedSpansUsage;
}

@Deprecated
public void setEstimatedIndexedSpansUsage(Double estimatedIndexedSpansUsage) {
this.estimatedIndexedSpansUsage = estimatedIndexedSpansUsage;
}
Expand All @@ -2063,17 +2070,21 @@ public MonthlyUsageAttributionValues estimatedIngestedSpansPercentage(
}

/**
* The percentage of estimated ingested spans usage by tag(s).
* The percentage of estimated ingested spans usage by tag(s) (To be deprecated on February 1st,
* 2027).
*
* @return estimatedIngestedSpansPercentage
* @deprecated
*/
@Deprecated
@jakarta.annotation.Nullable
@JsonProperty(JSON_PROPERTY_ESTIMATED_INGESTED_SPANS_PERCENTAGE)
@JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
public Double getEstimatedIngestedSpansPercentage() {
return estimatedIngestedSpansPercentage;
}

@Deprecated
public void setEstimatedIngestedSpansPercentage(Double estimatedIngestedSpansPercentage) {
this.estimatedIngestedSpansPercentage = estimatedIngestedSpansPercentage;
}
Expand All @@ -2085,17 +2096,20 @@ public MonthlyUsageAttributionValues estimatedIngestedSpansUsage(
}

/**
* The estimated ingested spans usage by tag(s).
* The estimated ingested spans usage by tag(s) (To be deprecated on February 1st, 2027).
*
* @return estimatedIngestedSpansUsage
* @deprecated
*/
@Deprecated
@jakarta.annotation.Nullable
@JsonProperty(JSON_PROPERTY_ESTIMATED_INGESTED_SPANS_USAGE)
@JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
public Double getEstimatedIngestedSpansUsage() {
return estimatedIngestedSpansUsage;
}

@Deprecated
public void setEstimatedIngestedSpansUsage(Double estimatedIngestedSpansUsage) {
this.estimatedIngestedSpansUsage = estimatedIngestedSpansUsage;
}
Expand Down
Loading