Renvoie la cardinalité estimée pour une métrique avec une configuration des tags, des centiles et du nombre d’agrégations en utilisant Metrics without Limits™.
Arguments
Paramètres du chemin
Name
Type
Description
metric_name [required]
string
The name of the metric.
Chaînes de requête
Name
Type
Description
filter[groups]
string
Comma-separated list of tag keys that the metric is configured to query with. For example: filter[groups]=app,host.
filter[exclude_tags_mode]
boolean
When true, filter[groups] is treated as an exclude list instead of an include list. Defaults to false.
filter[hours_ago]
integer
The number of hours of look back (from now) to estimate cardinality with. If unspecified, it defaults to 0 hours.
filter[num_aggregations]
integer
Deprecated. Number of aggregations has no impact on volume.
filter[pct]
boolean
Deprecated. This query parameter has no effect on the estimate.
filter[timespan_h]
integer
A window, in hours, from the look back to estimate cardinality with. The minimum and default is 1 hour.
Response object that includes metric cardinality estimates.
Expand All
Champ
Type
Description
data
object
Object for a metric cardinality estimate.
attributes
object
Object containing the definition of a metric estimate attribute.
estimate_type
enum
Estimate type based on the queried configuration. count_or_gauge is returned by default, and distribution is returned for distribution metrics. The filter[pct] query parameter has no effect on this value.
Allowed enum values: count_or_gauge,distribution,percentile
default: count_or_gauge
estimated_at
date-time
Timestamp when the cardinality estimate was requested.
estimated_output_series
int64
Estimated cardinality of the metric based on the queried configuration.
id
string
The metric name for this resource.
type
enum
The metric estimate resource type.
Allowed enum values: metric_cardinality_estimate
# Path parameters exportmetric_name="dist.http.endpoint.request" # Use a Personal Access Token or Service Access Token exportDD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"python3"example.py"
# Tag Configuration Cardinality Estimator returns "Success" responserequire"datadog_api_client"DatadogAPIClient.configuredo|config|config.access_token=ENV["DD_BEARER_TOKEN"]endapi_instance=DatadogAPIClient::V2::MetricsAPI.newopts={filter_groups:"app,host",filter_num_aggregations:4,}papi_instance.estimate_metrics_output_series("system.cpu.idle",opts)
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"rb"example.rb"
// Tag Configuration Cardinality Estimator returns "Success" responsepackagemainimport("context""encoding/json""fmt""os""github.com/DataDog/datadog-api-client-go/v2/api/datadog""github.com/DataDog/datadog-api-client-go/v2/api/datadogV2")funcmain(){ctx:=datadog.NewDefaultContext(context.Background())ctx=context.WithValue(ctx,datadog.ContextAccessToken,os.Getenv("DD_BEARER_TOKEN"))configuration:=datadog.NewConfiguration()apiClient:=datadog.NewAPIClient(configuration)api:=datadogV2.NewMetricsApi(apiClient)resp,r,err:=api.EstimateMetricsOutputSeries(ctx,"system.cpu.idle",*datadogV2.NewEstimateMetricsOutputSeriesOptionalParameters().WithFilterGroups("app,host").WithFilterNumAggregations(4))iferr!=nil{fmt.Fprintf(os.Stderr,"Error when calling `MetricsApi.EstimateMetricsOutputSeries`: %v\n",err)fmt.Fprintf(os.Stderr,"Full HTTP response: %v\n",r)}responseContent,_:=json.MarshalIndent(resp,""," ")fmt.Fprintf(os.Stdout,"Response from `MetricsApi.EstimateMetricsOutputSeries`:\n%s\n",responseContent)}
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"go run"main.go"
// Tag Configuration Cardinality Estimator returns "Success" responseimportcom.datadog.api.client.ApiClient;importcom.datadog.api.client.ApiException;importcom.datadog.api.client.v2.api.MetricsApi;importcom.datadog.api.client.v2.api.MetricsApi.EstimateMetricsOutputSeriesOptionalParameters;importcom.datadog.api.client.v2.model.MetricEstimateResponse;publicclassExample{publicstaticvoidmain(String[]args){ApiClientdefaultClient=ApiClient.getDefaultApiClient();defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN"));MetricsApiapiInstance=newMetricsApi(defaultClient);try{MetricEstimateResponseresult=apiInstance.estimateMetricsOutputSeries("system.cpu.idle",newEstimateMetricsOutputSeriesOptionalParameters().filterGroups("app,host").filterNumAggregations(4));System.out.println(result);}catch(ApiExceptione){System.err.println("Exception when calling MetricsApi#estimateMetricsOutputSeries");System.err.println("Status code: "+e.getCode());System.err.println("Reason: "+e.getResponseBody());System.err.println("Response headers: "+e.getResponseHeaders());e.printStackTrace();}}}
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"java"Example.java"
// Tag Configuration Cardinality Estimator returns "Success" response
usedatadog_api_client::datadog;usedatadog_api_client::datadogV2::api_metrics::EstimateMetricsOutputSeriesOptionalParams;usedatadog_api_client::datadogV2::api_metrics::MetricsAPI;#[tokio::main]asyncfnmain(){letconfiguration=datadog::Configuration::new();letapi=MetricsAPI::with_config(configuration);letresp=api.estimate_metrics_output_series("system.cpu.idle".to_string(),EstimateMetricsOutputSeriesOptionalParams::default().filter_groups("app,host".to_string()).filter_num_aggregations(4),).await;ifletOk(value)=resp{println!("{:#?}",value);}else{println!("{:#?}",resp.unwrap_err());}}
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_API_KEY="<API-KEY>"DD_APP_KEY="<APP-KEY>"cargo run
/**
* Tag Configuration Cardinality Estimator returns "Success" response
*/import{client,v2}from"@datadog/datadog-api-client";constconfiguration=client.createConfiguration({authMethods:{AuthZ:{accessToken: process.env.DD_BEARER_TOKENasstring,},},});constapiInstance=newv2.MetricsApi(configuration);constparams: v2.MetricsApiEstimateMetricsOutputSeriesRequest={metricName:"system.cpu.idle",filterGroups:"app,host",filterNumAggregations: 4,};apiInstance.estimateMetricsOutputSeries(params).then((data: v2.MetricEstimateResponse)=>{console.log("API called successfully. Returned data: "+JSON.stringify(data));}).catch((error: any)=>console.error(error));
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"tsc"example.ts"
Demander une démonstration personnalisée
Commencer avec Datadog
Ask AI
AI-generated responses may be inaccurate. Verify important info.