- 필수 기능
- 시작하기
- Glossary
- 표준 속성
- Guides
- Agent
- 통합
- 개방형텔레메트리
- 개발자
- Administrator's Guide
- API
- Datadog Mobile App
- CoScreen
- Cloudcraft
- 앱 내
- 서비스 관리
- 인프라스트럭처
- 애플리케이션 성능
- APM
- Continuous Profiler
- 스팬 시각화
- 데이터 스트림 모니터링
- 데이터 작업 모니터링
- 디지털 경험
- 소프트웨어 제공
- 보안
- AI Observability
- 로그 관리
- 관리
Manage configuration of rum-based metrics for your organization.
GET https://api.ap1.datadoghq.com/api/v2/rum/config/metricshttps://api.datadoghq.eu/api/v2/rum/config/metricshttps://api.ddog-gov.com/api/v2/rum/config/metricshttps://api.datadoghq.com/api/v2/rum/config/metricshttps://api.us3.datadoghq.com/api/v2/rum/config/metricshttps://api.us5.datadoghq.com/api/v2/rum/config/metrics
Get the list of configured rum-based metrics with their definitions.
OK
All the available rum-based metric objects.
항목
유형
설명
data
[object]
A list of rum-based metric objects.
attributes
object
The object describing a Datadog rum-based metric.
compute
object
The compute rule to compute the rum-based metric.
aggregation_type
enum
The type of aggregation to use.
Allowed enum values: count,distribution
include_percentiles
boolean
Toggle to include or exclude percentile aggregations for distribution metrics.
Only present when aggregation_type
is distribution
.
path
string
The path to the value the rum-based metric will aggregate on.
Only present when aggregation_type
is distribution
.
event_type
enum
The type of RUM events to filter on.
Allowed enum values: session,view,action,error,resource,long_task,vital
filter
object
The rum-based metric filter. RUM events matching this filter will be aggregated in this metric.
query
string
The search query - following the RUM search syntax.
group_by
[object]
The rules for the group by.
path
string
The path to the value the rum-based metric will be aggregated over.
tag_name
string
Eventual name of the tag that gets created. By default, path
is used as the tag name.
uniqueness
object
The rule to count updatable events. Is only set if event_type
is session
or view
.
when
enum
When to count updatable events. match
when the event is first seen, or end
when the event is complete.
Allowed enum values: match,end
id
string
The name of the rum-based metric.
type
enum
The type of the resource. The value should always be rum_metrics.
Allowed enum values: rum_metrics
default: rum_metrics
{
"data": [
{
"attributes": {
"compute": {
"aggregation_type": "distribution",
"include_percentiles": true,
"path": "@duration"
},
"event_type": "session",
"filter": {
"query": "service:web* AND @http.status_code:[200 TO 299]"
},
"group_by": [
{
"path": "@http.status_code",
"tag_name": "status_code"
}
],
"uniqueness": {
"when": "match"
}
},
"id": "rum.sessions.webui.count",
"type": "rum_metrics"
}
]
}
Not Authorized
API error response.
{
"errors": [
"Bad Request"
]
}
Too many requests
API error response.
{
"errors": [
"Bad Request"
]
}
// Get all rum-based metrics returns "OK" response
import com.datadog.api.client.ApiClient;
import com.datadog.api.client.ApiException;
import com.datadog.api.client.v2.api.RumMetricsApi;
import com.datadog.api.client.v2.model.RumMetricsResponse;
public class Example {
public static void main(String[] args) {
ApiClient defaultClient = ApiClient.getDefaultApiClient();
RumMetricsApi apiInstance = new RumMetricsApi(defaultClient);
try {
RumMetricsResponse result = apiInstance.listRumMetrics();
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling RumMetricsApi#listRumMetrics");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}
First install the library and its dependencies and then save the example to Example.java
and run following commands:
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comddog-gov.com" DD_API_KEY="<API-KEY>" DD_APP_KEY="<APP-KEY>" java "Example.java"
POST https://api.ap1.datadoghq.com/api/v2/rum/config/metricshttps://api.datadoghq.eu/api/v2/rum/config/metricshttps://api.ddog-gov.com/api/v2/rum/config/metricshttps://api.datadoghq.com/api/v2/rum/config/metricshttps://api.us3.datadoghq.com/api/v2/rum/config/metricshttps://api.us5.datadoghq.com/api/v2/rum/config/metrics
Create a metric based on your organization’s RUM data. Returns the rum-based metric object from the request body when the request is successful.
The definition of the new rum-based metric.
항목
유형
설명
data [required]
object
The new rum-based metric properties.
attributes [required]
object
The object describing the Datadog rum-based metric to create.
compute [required]
object
The compute rule to compute the rum-based metric.
aggregation_type [required]
enum
The type of aggregation to use.
Allowed enum values: count,distribution
include_percentiles
boolean
Toggle to include or exclude percentile aggregations for distribution metrics.
Only present when aggregation_type
is distribution
.
path
string
The path to the value the rum-based metric will aggregate on.
Only present when aggregation_type
is distribution
.
event_type [required]
enum
The type of RUM events to filter on.
Allowed enum values: session,view,action,error,resource,long_task,vital
filter
object
The rum-based metric filter. Events matching this filter will be aggregated in this metric.
query [required]
string
The search query - following the RUM search syntax.
default: *
group_by
[object]
The rules for the group by.
path [required]
string
The path to the value the rum-based metric will be aggregated over.
tag_name
string
Eventual name of the tag that gets created. By default, path
is used as the tag name.
uniqueness
object
The rule to count updatable events. Is only set if event_type
is sessions
or views
.
when [required]
enum
When to count updatable events. match
when the event is first seen, or end
when the event is complete.
Allowed enum values: match,end
id [required]
string
The name of the rum-based metric.
type [required]
enum
The type of the resource. The value should always be rum_metrics.
Allowed enum values: rum_metrics
default: rum_metrics
{
"data": {
"attributes": {
"compute": {
"aggregation_type": "distribution",
"include_percentiles": true,
"path": "@duration"
},
"event_type": "session",
"filter": {
"query": "@service:web-ui"
},
"group_by": [
{
"path": "@browser.name",
"tag_name": "browser_name"
}
],
"uniqueness": {
"when": "match"
}
},
"id": "rum.sessions.webui.count",
"type": "rum_metrics"
}
}
Created
The rum-based metric object.
항목
유형
설명
data
object
The rum-based metric properties.
attributes
object
The object describing a Datadog rum-based metric.
compute
object
The compute rule to compute the rum-based metric.
aggregation_type
enum
The type of aggregation to use.
Allowed enum values: count,distribution
include_percentiles
boolean
Toggle to include or exclude percentile aggregations for distribution metrics.
Only present when aggregation_type
is distribution
.
path
string
The path to the value the rum-based metric will aggregate on.
Only present when aggregation_type
is distribution
.
event_type
enum
The type of RUM events to filter on.
Allowed enum values: session,view,action,error,resource,long_task,vital
filter
object
The rum-based metric filter. RUM events matching this filter will be aggregated in this metric.
query
string
The search query - following the RUM search syntax.
group_by
[object]
The rules for the group by.
path
string
The path to the value the rum-based metric will be aggregated over.
tag_name
string
Eventual name of the tag that gets created. By default, path
is used as the tag name.
uniqueness
object
The rule to count updatable events. Is only set if event_type
is session
or view
.
when
enum
When to count updatable events. match
when the event is first seen, or end
when the event is complete.
Allowed enum values: match,end
id
string
The name of the rum-based metric.
type
enum
The type of the resource. The value should always be rum_metrics.
Allowed enum values: rum_metrics
default: rum_metrics
{
"data": {
"attributes": {
"compute": {
"aggregation_type": "distribution",
"include_percentiles": true,
"path": "@duration"
},
"event_type": "session",
"filter": {
"query": "service:web* AND @http.status_code:[200 TO 299]"
},
"group_by": [
{
"path": "@http.status_code",
"tag_name": "status_code"
}
],
"uniqueness": {
"when": "match"
}
},
"id": "rum.sessions.webui.count",
"type": "rum_metrics"
}
}
Bad Request
API error response.
{
"errors": [
"Bad Request"
]
}
Not Authorized
API error response.
{
"errors": [
"Bad Request"
]
}
Conflict
API error response.
{
"errors": [
"Bad Request"
]
}
Too many requests
API error response.
{
"errors": [
"Bad Request"
]
}
// Create a rum-based metric returns "Created" response
import com.datadog.api.client.ApiClient;
import com.datadog.api.client.ApiException;
import com.datadog.api.client.v2.api.RumMetricsApi;
import com.datadog.api.client.v2.model.RumMetricCompute;
import com.datadog.api.client.v2.model.RumMetricComputeAggregationType;
import com.datadog.api.client.v2.model.RumMetricCreateAttributes;
import com.datadog.api.client.v2.model.RumMetricCreateData;
import com.datadog.api.client.v2.model.RumMetricCreateRequest;
import com.datadog.api.client.v2.model.RumMetricEventType;
import com.datadog.api.client.v2.model.RumMetricFilter;
import com.datadog.api.client.v2.model.RumMetricGroupBy;
import com.datadog.api.client.v2.model.RumMetricResponse;
import com.datadog.api.client.v2.model.RumMetricType;
import com.datadog.api.client.v2.model.RumMetricUniqueness;
import com.datadog.api.client.v2.model.RumMetricUniquenessWhen;
import java.util.Collections;
public class Example {
public static void main(String[] args) {
ApiClient defaultClient = ApiClient.getDefaultApiClient();
RumMetricsApi apiInstance = new RumMetricsApi(defaultClient);
RumMetricCreateRequest body =
new RumMetricCreateRequest()
.data(
new RumMetricCreateData()
.attributes(
new RumMetricCreateAttributes()
.compute(
new RumMetricCompute()
.aggregationType(RumMetricComputeAggregationType.DISTRIBUTION)
.includePercentiles(true)
.path("@duration"))
.eventType(RumMetricEventType.SESSION)
.filter(new RumMetricFilter().query("@service:web-ui"))
.groupBy(
Collections.singletonList(
new RumMetricGroupBy()
.path("@browser.name")
.tagName("browser_name")))
.uniqueness(
new RumMetricUniqueness().when(RumMetricUniquenessWhen.WHEN_MATCH)))
.id("rum.sessions.webui.count")
.type(RumMetricType.RUM_METRICS));
try {
RumMetricResponse result = apiInstance.createRumMetric(body);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling RumMetricsApi#createRumMetric");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}
First install the library and its dependencies and then save the example to Example.java
and run following commands:
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comddog-gov.com" DD_API_KEY="<API-KEY>" DD_APP_KEY="<APP-KEY>" java "Example.java"
GET https://api.ap1.datadoghq.com/api/v2/rum/config/metrics/{metric_id}https://api.datadoghq.eu/api/v2/rum/config/metrics/{metric_id}https://api.ddog-gov.com/api/v2/rum/config/metrics/{metric_id}https://api.datadoghq.com/api/v2/rum/config/metrics/{metric_id}https://api.us3.datadoghq.com/api/v2/rum/config/metrics/{metric_id}https://api.us5.datadoghq.com/api/v2/rum/config/metrics/{metric_id}
Get a specific rum-based metric from your organization.
이름
유형
설명
metric_id [required]
string
The name of the rum-based metric.
OK
The rum-based metric object.
항목
유형
설명
data
object
The rum-based metric properties.
attributes
object
The object describing a Datadog rum-based metric.
compute
object
The compute rule to compute the rum-based metric.
aggregation_type
enum
The type of aggregation to use.
Allowed enum values: count,distribution
include_percentiles
boolean
Toggle to include or exclude percentile aggregations for distribution metrics.
Only present when aggregation_type
is distribution
.
path
string
The path to the value the rum-based metric will aggregate on.
Only present when aggregation_type
is distribution
.
event_type
enum
The type of RUM events to filter on.
Allowed enum values: session,view,action,error,resource,long_task,vital
filter
object
The rum-based metric filter. RUM events matching this filter will be aggregated in this metric.
query
string
The search query - following the RUM search syntax.
group_by
[object]
The rules for the group by.
path
string
The path to the value the rum-based metric will be aggregated over.
tag_name
string
Eventual name of the tag that gets created. By default, path
is used as the tag name.
uniqueness
object
The rule to count updatable events. Is only set if event_type
is session
or view
.
when
enum
When to count updatable events. match
when the event is first seen, or end
when the event is complete.
Allowed enum values: match,end
id
string
The name of the rum-based metric.
type
enum
The type of the resource. The value should always be rum_metrics.
Allowed enum values: rum_metrics
default: rum_metrics
{
"data": {
"attributes": {
"compute": {
"aggregation_type": "distribution",
"include_percentiles": true,
"path": "@duration"
},
"event_type": "session",
"filter": {
"query": "service:web* AND @http.status_code:[200 TO 299]"
},
"group_by": [
{
"path": "@http.status_code",
"tag_name": "status_code"
}
],
"uniqueness": {
"when": "match"
}
},
"id": "rum.sessions.webui.count",
"type": "rum_metrics"
}
}
Not Authorized
API error response.
{
"errors": [
"Bad Request"
]
}
Not Found
API error response.
{
"errors": [
"Bad Request"
]
}
Too many requests
API error response.
{
"errors": [
"Bad Request"
]
}
// Get a rum-based metric returns "OK" response
import com.datadog.api.client.ApiClient;
import com.datadog.api.client.ApiException;
import com.datadog.api.client.v2.api.RumMetricsApi;
import com.datadog.api.client.v2.model.RumMetricResponse;
public class Example {
public static void main(String[] args) {
ApiClient defaultClient = ApiClient.getDefaultApiClient();
RumMetricsApi apiInstance = new RumMetricsApi(defaultClient);
// there is a valid "rum_metric" in the system
String RUM_METRIC_DATA_ID = System.getenv("RUM_METRIC_DATA_ID");
try {
RumMetricResponse result = apiInstance.getRumMetric(RUM_METRIC_DATA_ID);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling RumMetricsApi#getRumMetric");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}
First install the library and its dependencies and then save the example to Example.java
and run following commands:
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comddog-gov.com" DD_API_KEY="<API-KEY>" DD_APP_KEY="<APP-KEY>" java "Example.java"
PATCH https://api.ap1.datadoghq.com/api/v2/rum/config/metrics/{metric_id}https://api.datadoghq.eu/api/v2/rum/config/metrics/{metric_id}https://api.ddog-gov.com/api/v2/rum/config/metrics/{metric_id}https://api.datadoghq.com/api/v2/rum/config/metrics/{metric_id}https://api.us3.datadoghq.com/api/v2/rum/config/metrics/{metric_id}https://api.us5.datadoghq.com/api/v2/rum/config/metrics/{metric_id}
Update a specific rum-based metric from your organization. Returns the rum-based metric object from the request body when the request is successful.
이름
유형
설명
metric_id [required]
string
The name of the rum-based metric.
New definition of the rum-based metric.
항목
유형
설명
data [required]
object
The new rum-based metric properties.
attributes [required]
object
The rum-based metric properties that will be updated.
compute
object
The compute rule to compute the rum-based metric.
include_percentiles
boolean
Toggle to include or exclude percentile aggregations for distribution metrics.
Only present when aggregation_type
is distribution
.
filter
object
The rum-based metric filter. Events matching this filter will be aggregated in this metric.
query [required]
string
The search query - following the RUM search syntax.
default: *
group_by
[object]
The rules for the group by.
path [required]
string
The path to the value the rum-based metric will be aggregated over.
tag_name
string
Eventual name of the tag that gets created. By default, path
is used as the tag name.
id
string
The name of the rum-based metric.
type [required]
enum
The type of the resource. The value should always be rum_metrics.
Allowed enum values: rum_metrics
default: rum_metrics
{
"data": {
"id": "rum.sessions.webui.count",
"type": "rum_metrics",
"attributes": {
"compute": {
"include_percentiles": false
},
"filter": {
"query": "@service:rum-config"
},
"group_by": [
{
"path": "@browser.version",
"tag_name": "browser_version"
}
]
}
}
}
OK
The rum-based metric object.
항목
유형
설명
data
object
The rum-based metric properties.
attributes
object
The object describing a Datadog rum-based metric.
compute
object
The compute rule to compute the rum-based metric.
aggregation_type
enum
The type of aggregation to use.
Allowed enum values: count,distribution
include_percentiles
boolean
Toggle to include or exclude percentile aggregations for distribution metrics.
Only present when aggregation_type
is distribution
.
path
string
The path to the value the rum-based metric will aggregate on.
Only present when aggregation_type
is distribution
.
event_type
enum
The type of RUM events to filter on.
Allowed enum values: session,view,action,error,resource,long_task,vital
filter
object
The rum-based metric filter. RUM events matching this filter will be aggregated in this metric.
query
string
The search query - following the RUM search syntax.
group_by
[object]
The rules for the group by.
path
string
The path to the value the rum-based metric will be aggregated over.
tag_name
string
Eventual name of the tag that gets created. By default, path
is used as the tag name.
uniqueness
object
The rule to count updatable events. Is only set if event_type
is session
or view
.
when
enum
When to count updatable events. match
when the event is first seen, or end
when the event is complete.
Allowed enum values: match,end
id
string
The name of the rum-based metric.
type
enum
The type of the resource. The value should always be rum_metrics.
Allowed enum values: rum_metrics
default: rum_metrics
{
"data": {
"attributes": {
"compute": {
"aggregation_type": "distribution",
"include_percentiles": true,
"path": "@duration"
},
"event_type": "session",
"filter": {
"query": "service:web* AND @http.status_code:[200 TO 299]"
},
"group_by": [
{
"path": "@http.status_code",
"tag_name": "status_code"
}
],
"uniqueness": {
"when": "match"
}
},
"id": "rum.sessions.webui.count",
"type": "rum_metrics"
}
}
Bad Request
API error response.
{
"errors": [
"Bad Request"
]
}
Not Authorized
API error response.
{
"errors": [
"Bad Request"
]
}
Not Found
API error response.
{
"errors": [
"Bad Request"
]
}
Conflict
API error response.
{
"errors": [
"Bad Request"
]
}
Too many requests
API error response.
{
"errors": [
"Bad Request"
]
}
// Update a rum-based metric returns "OK" response
import com.datadog.api.client.ApiClient;
import com.datadog.api.client.ApiException;
import com.datadog.api.client.v2.api.RumMetricsApi;
import com.datadog.api.client.v2.model.RumMetricFilter;
import com.datadog.api.client.v2.model.RumMetricGroupBy;
import com.datadog.api.client.v2.model.RumMetricResponse;
import com.datadog.api.client.v2.model.RumMetricType;
import com.datadog.api.client.v2.model.RumMetricUpdateAttributes;
import com.datadog.api.client.v2.model.RumMetricUpdateCompute;
import com.datadog.api.client.v2.model.RumMetricUpdateData;
import com.datadog.api.client.v2.model.RumMetricUpdateRequest;
import java.util.Collections;
public class Example {
public static void main(String[] args) {
ApiClient defaultClient = ApiClient.getDefaultApiClient();
RumMetricsApi apiInstance = new RumMetricsApi(defaultClient);
// there is a valid "rum_metric" in the system
String RUM_METRIC_DATA_ID = System.getenv("RUM_METRIC_DATA_ID");
RumMetricUpdateRequest body =
new RumMetricUpdateRequest()
.data(
new RumMetricUpdateData()
.id(RUM_METRIC_DATA_ID)
.type(RumMetricType.RUM_METRICS)
.attributes(
new RumMetricUpdateAttributes()
.compute(new RumMetricUpdateCompute().includePercentiles(false))
.filter(new RumMetricFilter().query("@service:rum-config"))
.groupBy(
Collections.singletonList(
new RumMetricGroupBy()
.path("@browser.version")
.tagName("browser_version")))));
try {
RumMetricResponse result = apiInstance.updateRumMetric(RUM_METRIC_DATA_ID, body);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling RumMetricsApi#updateRumMetric");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}
First install the library and its dependencies and then save the example to Example.java
and run following commands:
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comddog-gov.com" DD_API_KEY="<API-KEY>" DD_APP_KEY="<APP-KEY>" java "Example.java"
DELETE https://api.ap1.datadoghq.com/api/v2/rum/config/metrics/{metric_id}https://api.datadoghq.eu/api/v2/rum/config/metrics/{metric_id}https://api.ddog-gov.com/api/v2/rum/config/metrics/{metric_id}https://api.datadoghq.com/api/v2/rum/config/metrics/{metric_id}https://api.us3.datadoghq.com/api/v2/rum/config/metrics/{metric_id}https://api.us5.datadoghq.com/api/v2/rum/config/metrics/{metric_id}
Delete a specific rum-based metric from your organization.
이름
유형
설명
metric_id [required]
string
The name of the rum-based metric.
No Content
Not Authorized
API error response.
{
"errors": [
"Bad Request"
]
}
Not Found
API error response.
{
"errors": [
"Bad Request"
]
}
Too many requests
API error response.
{
"errors": [
"Bad Request"
]
}
// Delete a rum-based metric returns "No Content" response
import com.datadog.api.client.ApiClient;
import com.datadog.api.client.ApiException;
import com.datadog.api.client.v2.api.RumMetricsApi;
public class Example {
public static void main(String[] args) {
ApiClient defaultClient = ApiClient.getDefaultApiClient();
RumMetricsApi apiInstance = new RumMetricsApi(defaultClient);
// there is a valid "rum_metric" in the system
String RUM_METRIC_DATA_ID = System.getenv("RUM_METRIC_DATA_ID");
try {
apiInstance.deleteRumMetric(RUM_METRIC_DATA_ID);
} catch (ApiException e) {
System.err.println("Exception when calling RumMetricsApi#deleteRumMetric");
System.err.println("Status code: " + e.getCode());
System.err.println("Reason: " + e.getResponseBody());
System.err.println("Response headers: " + e.getResponseHeaders());
e.printStackTrace();
}
}
}
First install the library and its dependencies and then save the example to Example.java
and run following commands:
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comddog-gov.com" DD_API_KEY="<API-KEY>" DD_APP_KEY="<APP-KEY>" java "Example.java"