Service metrics API - PUT a metric

Updates the specified calculated service metric.

If the calculated service metric with the specified key doesn't exist, a new metric is created.

PUT	ManagedDynatrace for Government	`https://{your-domain}/e/{your-environment-id}/api/config/v1/calculatedMetrics/service/{metricKey}`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/config/v1/calculatedMetrics/service/{metricKey}`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/calculatedMetrics/service/{metricKey}`

Authentication

To execute this request, you need an access token with WriteConfig scope.

To learn how to obtain and use it, see Tokens and authentication.

Parameters

Refer to JSON models to find all JSON models that depend on the type of the model.

Parameter	Type	Description	In	Required
metricKey	string	The key of the calculated service metric to be updated. The key of the calculated service metric in the body of the request must match this key.	path	required
body	CalculatedServiceMetric	The JSON body of the request. Contains updated parameters of the calculated service metric.	body	required

Parameter

Type

Description

Required

metricKey

string

The key of the calculated service metric to be updated.

The key of the calculated service metric in the body of the request must match this key.

path

required

body

CalculatedServiceMetric

The JSON body of the request. Contains updated parameters of the calculated service metric.

body

required

Request body objects

The `CalculatedServiceMetric` object

Descriptor of a calculated service metric.

Element	Type	Description	Required
metadata	ConfigurationMetadata	Metadata useful for debugging	optional
tsmMetricKey	string	The key of the calculated service metric.	required
name	string	The displayed name of the metric.	required
enabled	boolean	The metric is enabled (`true`) or disabled (`false`).	required
ignoreMutedRequests	boolean	Metric should (`true`) or not (`false`) ignore muted requests.	optional
metricDefinition	CalculatedMetricDefinition	The definition of a calculated service metric.	required
unit	string	The unit of the metric. The element can hold these values `BILLION` `BIT` `BIT_PER_HOUR` `BIT_PER_MINUTE` `BIT_PER_SECOND` `BYTE` `BYTE_PER_HOUR` `BYTE_PER_MINUTE` `BYTE_PER_SECOND` `CORES` `COUNT` `DAY` `DECIBEL_MILLI_WATT` `GIBI_BYTE` `GIBI_BYTE_PER_HOUR` `GIBI_BYTE_PER_MINUTE` `GIBI_BYTE_PER_SECOND` `GIGA` `GIGA_BYTE` `GIGA_BYTE_PER_HOUR` `GIGA_BYTE_PER_MINUTE` `GIGA_BYTE_PER_SECOND` `HOUR` `KIBI_BYTE` `KIBI_BYTE_PER_HOUR` `KIBI_BYTE_PER_MINUTE` `KIBI_BYTE_PER_SECOND` `KILO` `KILO_BYTE` `KILO_BYTE_PER_HOUR` `KILO_BYTE_PER_MINUTE` `KILO_BYTE_PER_SECOND` `KILO_METRE_PER_HOUR` `MEBI_BYTE` `MEBI_BYTE_PER_HOUR` `MEBI_BYTE_PER_MINUTE` `MEBI_BYTE_PER_SECOND` `MEGA` `MEGA_BYTE` `MEGA_BYTE_PER_HOUR` `MEGA_BYTE_PER_MINUTE` `MEGA_BYTE_PER_SECOND` `METRE_PER_HOUR` `METRE_PER_SECOND` `MICRO_SECOND` `MILLION` `MILLI_CORES` `MILLI_SECOND` `MILLI_SECOND_PER_MINUTE` `MINUTE` `MONTH` `MSU` `NANO_SECOND` `NANO_SECOND_PER_MINUTE` `NOT_APPLICABLE` `PERCENT` `PER_HOUR` `PER_MINUTE` `PER_SECOND` `PIXEL` `PROMILLE` `RATIO` `SECOND` `STATE` `TRILLION` `UNSPECIFIED` `WEEK` `YEAR`	required
unitDisplayName	string	The display name of the metric's unit. Only applicable when the unit parameter is set to `UNSPECIFIED`.	optional
entityId	string	Restricts the metric usage to the specified service. This field is mutually exclusive with the managementZones field.	optional
managementZones	string[]	Restricts the metric usage to specified management zones. This field is mutually exclusive with the entityId field.	optional
conditions	Condition[]	The set of conditions for the metric usage. All the specified conditions must be fulfilled to use the metric.	optional
dimensionDefinition	DimensionDefinition	Parameters of a definition of a calculated service metric.	optional

The `ConfigurationMetadata` object

Metadata useful for debugging

Element	Type	Description	Required
configurationVersions	integer[]	A sorted list of the version numbers of the configuration.	optional
currentConfigurationVersions	string[]	A sorted list of version numbers of the configuration.	optional
clusterVersion	string	Dynatrace version.	optional

The `CalculatedMetricDefinition` object

The definition of a calculated service metric.

Element Type Description Required

metric

string

Element	Type	Description	Required
metric	string	The metric to be captured. The element can hold these values `CPU_TIME` `DATABASE_CHILD_CALL_COUNT` `DATABASE_CHILD_CALL_TIME` `DISK_IO_TIME` `EXCEPTION_COUNT` `FAILED_REQUEST_COUNT` `FAILED_REQUEST_COUNT_CLIENT` `FAILURE_RATE` `FAILURE_RATE_CLIENT` `HTTP_4XX_ERROR_COUNT` `HTTP_4XX_ERROR_COUNT_CLIENT` `HTTP_5XX_ERROR_COUNT` `HTTP_5XX_ERROR_COUNT_CLIENT` `IO_TIME` `LOCK_TIME` `NETWORK_IO_TIME` `NON_DATABASE_CHILD_CALL_COUNT` `NON_DATABASE_CHILD_CALL_TIME` `PROCESSING_TIME` `REQUEST_ATTRIBUTE` `REQUEST_COUNT` `RESPONSE_TIME` `RESPONSE_TIME_CLIENT` `SUCCESSFUL_REQUEST_COUNT` `SUCCESSFUL_REQUEST_COUNT_CLIENT` `WAIT_TIME`	required
requestAttribute	string	The request attribute to be captured. Only applicable when the metric parameter is set to `REQUEST_ATTRIBUTE`.	optional

The metric to be captured.

The element can hold these values

CPU_TIME
DATABASE_CHILD_CALL_COUNT
DATABASE_CHILD_CALL_TIME
DISK_IO_TIME
EXCEPTION_COUNT
FAILED_REQUEST_COUNT
FAILED_REQUEST_COUNT_CLIENT
FAILURE_RATE
FAILURE_RATE_CLIENT
HTTP_4XX_ERROR_COUNT
HTTP_4XX_ERROR_COUNT_CLIENT
HTTP_5XX_ERROR_COUNT
HTTP_5XX_ERROR_COUNT_CLIENT
IO_TIME
LOCK_TIME
NETWORK_IO_TIME
NON_DATABASE_CHILD_CALL_COUNT
NON_DATABASE_CHILD_CALL_TIME
PROCESSING_TIME
REQUEST_ATTRIBUTE
REQUEST_COUNT
RESPONSE_TIME
RESPONSE_TIME_CLIENT
SUCCESSFUL_REQUEST_COUNT
SUCCESSFUL_REQUEST_COUNT_CLIENT
WAIT_TIME

required

requestAttribute

string

The request attribute to be captured.

Only applicable when the metric parameter is set to REQUEST_ATTRIBUTE.

optional

The `Condition` object

A condition of a rule usage.

Element Type Description Required

attribute

string

Element	Type	Description	Required
attribute	string	The attribute to be matched. Note that for a service property attribute you must use the comparison of the `FAST_STRING` type. The element can hold these values `ACTOR_SYSTEM` `AKKA_ACTOR_CLASS_NAME` `AKKA_ACTOR_MESSAGE_TYPE` `AKKA_ACTOR_PATH` `APPLICATION_BUILD_VERSION` `APPLICATION_ENVIRONMENT` `APPLICATION_NAME` `APPLICATION_RELEASE_VERSION` `AZURE_FUNCTIONS_FUNCTION_NAME` `AZURE_FUNCTIONS_SITE_NAME` `CICS_PROGRAM_NAME` `CICS_SYSTEM_ID` `CICS_TASK_ID` `CICS_TRANSACTION_ID` `CICS_USER_ID` `CPU_TIME` `CTG_GATEWAY_URL` `CTG_PROGRAM` `CTG_SERVER_NAME` `CTG_TRANSACTION_ID` `CUSTOMSERVICE_CLASS` `CUSTOMSERVICE_METHOD` `DATABASE_CHILD_CALL_COUNT` `DATABASE_CHILD_CALL_TIME` `DATABASE_HOST` `DATABASE_NAME` `DATABASE_STATEMENT` `DATABASE_TYPE` `DATABASE_URL` `DISK_IO_TIME` `ERROR_COUNT` `ESB_APPLICATION_NAME` `ESB_INPUT_TYPE` `ESB_LIBRARY_NAME` `ESB_MESSAGE_FLOW_NAME` `EXCEPTION_CLASS` `EXCEPTION_MESSAGE` `FAILED_STATE` `FAILURE_REASON` `FLAW_STATE` `HTTP_REQUEST_METHOD` `HTTP_STATUS` `HTTP_STATUS_CLASS` `IMS_PROGRAM_NAME` `IMS_TRANSACTION_ID` `IMS_USER_ID` `IO_TIME` `IS_KEY_REQUEST` `LAMBDA_COLDSTART` `LOCK_TIME` `MESSAGING_DESTINATION_TYPE` `MESSAGING_IS_TEMPORARY_QUEUE` `MESSAGING_QUEUE_NAME` `MESSAGING_QUEUE_VENDOR` `NETWORK_IO_TIME` `NON_DATABASE_CHILD_CALL_COUNT` `NON_DATABASE_CHILD_CALL_TIME` `PROCESS_GROUP_NAME` `PROCESS_GROUP_TAG` `REMOTE_ENDPOINT` `REMOTE_METHOD` `REMOTE_SERVICE_NAME` `REQUEST_NAME` `REQUEST_TYPE` `RESPONSE_TIME` `RESPONSE_TIME_CLIENT` `RMI_CLASS` `RMI_METHOD` `SERVICE_DISPLAY_NAME` `SERVICE_NAME` `SERVICE_PORT` `SERVICE_PUBLIC_DOMAIN_NAME` `SERVICE_REQUEST_ATTRIBUTE` `SERVICE_TAG` `SERVICE_TYPE` `SERVICE_WEB_APPLICATION_ID` `SERVICE_WEB_CONTEXT_ROOT` `SERVICE_WEB_SERVER_NAME` `SERVICE_WEB_SERVICE_NAME` `SERVICE_WEB_SERVICE_NAMESPACE` `SUSPENSION_TIME` `TOTAL_PROCESSING_TIME` `WAIT_TIME` `WEBREQUEST_QUERY` `WEBREQUEST_RELATIVE_URL` `WEBREQUEST_URL` `WEBREQUEST_URL_HOST` `WEBREQUEST_URL_PATH` `WEBREQUEST_URL_PORT` `WEBSERVICE_ENDPOINT` `WEBSERVICE_METHOD` `ZOS_CALL_TYPE`	required
comparisonInfo	ComparisonInfo	Type-specific comparison for attributes. The actual set of fields depends on the type of the comparison. Find the list of actual objects in the description of the type field or see Service metrics API - JSON models.	required

The attribute to be matched.

Note that for a service property attribute you must use the comparison of the FAST_STRING type.

The element can hold these values

ACTOR_SYSTEM
AKKA_ACTOR_CLASS_NAME
AKKA_ACTOR_MESSAGE_TYPE
AKKA_ACTOR_PATH
APPLICATION_BUILD_VERSION
APPLICATION_ENVIRONMENT
APPLICATION_NAME
APPLICATION_RELEASE_VERSION
AZURE_FUNCTIONS_FUNCTION_NAME
AZURE_FUNCTIONS_SITE_NAME
CICS_PROGRAM_NAME
CICS_SYSTEM_ID
CICS_TASK_ID
CICS_TRANSACTION_ID
CICS_USER_ID
CPU_TIME
CTG_GATEWAY_URL
CTG_PROGRAM
CTG_SERVER_NAME
CTG_TRANSACTION_ID
CUSTOMSERVICE_CLASS
CUSTOMSERVICE_METHOD
DATABASE_CHILD_CALL_COUNT
DATABASE_CHILD_CALL_TIME
DATABASE_HOST
DATABASE_NAME
DATABASE_STATEMENT
DATABASE_TYPE
DATABASE_URL
DISK_IO_TIME
ERROR_COUNT
ESB_APPLICATION_NAME
ESB_INPUT_TYPE
ESB_LIBRARY_NAME
ESB_MESSAGE_FLOW_NAME
EXCEPTION_CLASS
EXCEPTION_MESSAGE
FAILED_STATE
FAILURE_REASON
FLAW_STATE
HTTP_REQUEST_METHOD
HTTP_STATUS
HTTP_STATUS_CLASS
IMS_PROGRAM_NAME
IMS_TRANSACTION_ID
IMS_USER_ID
IO_TIME
IS_KEY_REQUEST
LAMBDA_COLDSTART
LOCK_TIME
MESSAGING_DESTINATION_TYPE
MESSAGING_IS_TEMPORARY_QUEUE
MESSAGING_QUEUE_NAME
MESSAGING_QUEUE_VENDOR
NETWORK_IO_TIME
NON_DATABASE_CHILD_CALL_COUNT
NON_DATABASE_CHILD_CALL_TIME
PROCESS_GROUP_NAME
PROCESS_GROUP_TAG
REMOTE_ENDPOINT
REMOTE_METHOD
REMOTE_SERVICE_NAME
REQUEST_NAME
REQUEST_TYPE
RESPONSE_TIME
RESPONSE_TIME_CLIENT
RMI_CLASS
RMI_METHOD
SERVICE_DISPLAY_NAME
SERVICE_NAME
SERVICE_PORT
SERVICE_PUBLIC_DOMAIN_NAME
SERVICE_REQUEST_ATTRIBUTE
SERVICE_TAG
SERVICE_TYPE
SERVICE_WEB_APPLICATION_ID
SERVICE_WEB_CONTEXT_ROOT
SERVICE_WEB_SERVER_NAME
SERVICE_WEB_SERVICE_NAME
SERVICE_WEB_SERVICE_NAMESPACE
SUSPENSION_TIME
TOTAL_PROCESSING_TIME
WAIT_TIME
WEBREQUEST_QUERY
WEBREQUEST_RELATIVE_URL
WEBREQUEST_URL
WEBREQUEST_URL_HOST
WEBREQUEST_URL_PATH
WEBREQUEST_URL_PORT
WEBSERVICE_ENDPOINT
WEBSERVICE_METHOD
ZOS_CALL_TYPE

required

comparisonInfo

ComparisonInfo

Type-specific comparison for attributes. The actual set of fields depends on the type of the comparison. Find the list of actual objects in the description of the type field or see Service metrics API - JSON models.

required

The `ComparisonInfo` object

Element	Type	Description	Required
comparison	string	Operator of the comparision. You can reverse it by setting negate to `true`.	required
value	object	The value to compare to.	optional
values	object[]	The values to compare to.	optional
negate	boolean	Reverse the comparison operator. For example, it turns equals into does not equal.	required
type	string	Defines the actual set of fields depending on the value. See one of the following objects: `STRING` -> StringComparisonInfo `NUMBER` -> NumberComparisonInfo `BOOLEAN` -> BooleanComparisonInfo `HTTP_METHOD` -> HttpMethodComparisonInfo `STRING_REQUEST_ATTRIBUTE` -> StringRequestAttributeComparisonInfo `NUMBER_REQUEST_ATTRIBUTE` -> NumberRequestAttributeComparisonInfo `ZOS_CALL_TYPE` -> ZosComparisonInfo `IIB_INPUT_NODE_TYPE` -> IIBInputNodeTypeComparisonInfo `ESB_INPUT_NODE_TYPE` -> ESBInputNodeTypeComparisonInfo `FAILED_STATE` -> FailedStateComparisonInfo `FLAW_STATE` -> FlawStateComparisonInfo `FAILURE_REASON` -> FailureReasonComparisonInfo `HTTP_STATUS_CLASS` -> HttpStatusClassComparisonInfo `TAG` -> TagComparisonInfo `FAST_STRING` -> FastStringComparisonInfo `SERVICE_TYPE` -> ServiceTypeComparisonInfo The element can hold these values `BOOLEAN` `ESB_INPUT_NODE_TYPE` `FAILED_STATE` `FAILURE_REASON` `FAST_STRING` `FLAW_STATE` `HTTP_METHOD` `HTTP_STATUS_CLASS` `IIB_INPUT_NODE_TYPE` `NUMBER` `NUMBER_REQUEST_ATTRIBUTE` `SERVICE_TYPE` `STRING` `STRING_REQUEST_ATTRIBUTE` `TAG` `ZOS_CALL_TYPE`	required

The `DimensionDefinition` object

Parameters of a definition of a calculated service metric.

Element	Type	Description	Required
name	string	The name of the dimension.	required
dimension	string	The dimension value pattern. You can define custom placeholders in the placeholders field and use them here.	required
placeholders	Placeholder[]	The list of custom placeholders to be used in a dimension value pattern.	optional
topX	integer	The number of top values to be calculated.	required
topXDirection	string	How to calculate the topX values. The element can hold these values `ASCENDING` `DESCENDING`	required
topXAggregation	string	The aggregation of the dimension. The element can hold these values `AVERAGE` `COUNT` `MAX` `MIN` `OF_INTEREST_RATIO` `OTHER_RATIO` `SINGLE_VALUE` `SUM`	required

The `Placeholder` object

The custom placeholder to be used as a naming value pattern.

It enables you to extract a request attribute value or other request attribute and use it in the naming pattern.

Element	Type	Description	Required
name	string	The name of the placeholder. Use it in the naming pattern as `{name}`.	required
attribute	string	The attribute to extract from. You can only use attributes of the string type. The element can hold these values `ACTOR_SYSTEM` `AKKA_ACTOR_CLASS_NAME` `AKKA_ACTOR_MESSAGE_TYPE` `AKKA_ACTOR_PATH` `APPLICATION_BUILD_VERSION` `APPLICATION_ENVIRONMENT` `APPLICATION_NAME` `APPLICATION_RELEASE_VERSION` `AZURE_FUNCTIONS_FUNCTION_NAME` `AZURE_FUNCTIONS_SITE_NAME` `CICS_PROGRAM_NAME` `CICS_SYSTEM_ID` `CICS_TASK_ID` `CICS_TRANSACTION_ID` `CICS_USER_ID` `CPU_TIME` `CTG_GATEWAY_URL` `CTG_PROGRAM` `CTG_SERVER_NAME` `CTG_TRANSACTION_ID` `CUSTOMSERVICE_CLASS` `CUSTOMSERVICE_METHOD` `DATABASE_CHILD_CALL_COUNT` `DATABASE_CHILD_CALL_TIME` `DATABASE_HOST` `DATABASE_NAME` `DATABASE_STATEMENT` `DATABASE_TYPE` `DATABASE_URL` `DISK_IO_TIME` `ERROR_COUNT` `ESB_APPLICATION_NAME` `ESB_INPUT_TYPE` `ESB_LIBRARY_NAME` `ESB_MESSAGE_FLOW_NAME` `EXCEPTION_CLASS` `EXCEPTION_MESSAGE` `FAILED_STATE` `FAILURE_REASON` `FLAW_STATE` `HTTP_REQUEST_METHOD` `HTTP_STATUS` `HTTP_STATUS_CLASS` `IMS_PROGRAM_NAME` `IMS_TRANSACTION_ID` `IMS_USER_ID` `IO_TIME` `IS_KEY_REQUEST` `LAMBDA_COLDSTART` `LOCK_TIME` `MESSAGING_DESTINATION_TYPE` `MESSAGING_IS_TEMPORARY_QUEUE` `MESSAGING_QUEUE_NAME` `MESSAGING_QUEUE_VENDOR` `NETWORK_IO_TIME` `NON_DATABASE_CHILD_CALL_COUNT` `NON_DATABASE_CHILD_CALL_TIME` `PROCESS_GROUP_NAME` `PROCESS_GROUP_TAG` `REMOTE_ENDPOINT` `REMOTE_METHOD` `REMOTE_SERVICE_NAME` `REQUEST_NAME` `REQUEST_TYPE` `RESPONSE_TIME` `RESPONSE_TIME_CLIENT` `RMI_CLASS` `RMI_METHOD` `SERVICE_DISPLAY_NAME` `SERVICE_NAME` `SERVICE_PORT` `SERVICE_PUBLIC_DOMAIN_NAME` `SERVICE_REQUEST_ATTRIBUTE` `SERVICE_TAG` `SERVICE_TYPE` `SERVICE_WEB_APPLICATION_ID` `SERVICE_WEB_CONTEXT_ROOT` `SERVICE_WEB_SERVER_NAME` `SERVICE_WEB_SERVICE_NAME` `SERVICE_WEB_SERVICE_NAMESPACE` `SUSPENSION_TIME` `TOTAL_PROCESSING_TIME` `WAIT_TIME` `WEBREQUEST_QUERY` `WEBREQUEST_RELATIVE_URL` `WEBREQUEST_URL` `WEBREQUEST_URL_HOST` `WEBREQUEST_URL_PATH` `WEBREQUEST_URL_PORT` `WEBSERVICE_ENDPOINT` `WEBSERVICE_METHOD` `ZOS_CALL_TYPE`	required
kind	string	The type of extraction. Defines either usage of regular expression (`regex`) or the position of request attribute value to be extracted. When the attribute is `SERVICE_REQUEST_ATTRIBUTE` attribute and aggregation is `COUNT`, needs to be set to `ORIGINAL_TEXT` The element can hold these values `AFTER_DELIMITER` `BEFORE_DELIMITER` `BETWEEN_DELIMITER` `ORIGINAL_TEXT` `REGEX_EXTRACTION`	required
delimiterOrRegex	string	Depending on the type value: `REGEX_EXTRACTION`: The regular expression. `BETWEEN_DELIMITER`: The opening delimiter string to look for. All other values: The delimiter string to look for.	optional
endDelimiter	string	The closing delimiter string to look for. Required if the kind value is `BETWEEN_DELIMITER`. Not applicable otherwise.	optional
requestAttribute	string	The request attribute to extract from. Required if the kind value is `SERVICE_REQUEST_ATTRIBUTE`. Not applicable otherwise.	optional
normalization	string	The format of the extracted string. The element can hold these values `ORIGINAL` `TO_LOWER_CASE` `TO_UPPER_CASE`	optional
useFromChildCalls	boolean	If `true` request attribute will be taken from a child service call. Only applicable for the `SERVICE_REQUEST_ATTRIBUTE` attribute. Defaults to `false`.	optional
aggregation	string	Which value of the request attribute must be used when it occurs across multiple child requests. Only applicable for the `SERVICE_REQUEST_ATTRIBUTE` attribute, when useFromChildCalls is `true`. For the `COUNT` aggregation, the kind field is not applicable. The element can hold these values `COUNT` `FIRST` `LAST`	optional
source	PropagationSource	Defines valid sources of request attributes for conditions or placeholders.	optional

The `PropagationSource` object

Defines valid sources of request attributes for conditions or placeholders.

Element	Type	Description	Required
managementZone	string	Use only request attributes from services that belong to this management zone.. Use either this or `serviceTag`	optional
serviceTag	UniversalTag	Use only request attributes from services that have this tag. Use either this or `managementZone`	optional

The `UniversalTag` object

Use only request attributes from services that have this tag. Use either this or managementZone

Element	Type	Description	Required
tagKey	UniversalTagKey	-	optional
value	string	The value of the tag. Not applicable to custom tags. If a tag does have a separate key and value (in the textual representation they are split by the colon ‘:’), this field is set with the actual value. Key-value pairs can occur for automatically imported tags and tags set by rules if extractors are used.	optional
key	string	The key of the tag. For custom tags, put the tag value here. The key allows categorization of multiple tags. It is possible that there are multiple values for a single key which will all be represented as standalone tags. Therefore, the key does not have the semantic of a map key but is more like a key of a key-value tuple. In some cases, for example custom tags, the key represents the actual tag value and the value field is not set – those are called valueless tags.	required
context	string	The origin of the tag, such as AWS or Cloud Foundry. For custom tags use the `CONTEXTLESS` value. The context is set for tags that are automatically imported by OneAgent (for example, from the AWS console or environment variables). It’s useful for determining the origin of tags when not manually defined, and it also helps to prevent clashes with other existing tags. If the tag is not automatically imported, `CONTEXTLESS` set. The element can hold these values `AWS` `AWS_GENERIC` `AZURE` `CLOUD_FOUNDRY` `CONTEXTLESS` `ENVIRONMENT` `GOOGLE_COMPUTE_ENGINE` `KUBERNETES`	optional

The `UniversalTagKey` object

Element	Type	Description	Required
context	string	- The element can hold these values `AWS` `AWS_GENERIC` `AZURE` `CLOUD_FOUNDRY` `CONTEXTLESS` `ENVIRONMENT` `GOOGLE_COMPUTE_ENGINE` `KUBERNETES`	optional
key	string	-	optional

Request body JSON model

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.

json
{
  "tsmMetricKey": "calc:service.mymetric",
  "name": "My Metric",
  "enabled": true,
  "metricDefinition": {
    "metric": "CPU_TIME"
  },
  "managementZones": [
    "zone1"
  ],
  "unit": "MICRO_SECOND",
  "conditions": [
    {
      "attribute": "WEBREQUEST_URL_PATH",
      "comparisonInfo": {
        "type": "STRING",
        "comparison": "BEGINS_WITH",
        "value": "/url_path",
        "negate": false,
        "caseSensitive": false
      }
    }
  ],
  "dimensionDefinition": {
    "name": "my dimension",
    "dimension": "{myPlaceholder}",
    "placeholders": [
      {
        "name": "myPlaceholder",
        "attribute": "WEBREQUEST_URL_PATH",
        "kind": "BEFORE_DELIMITER",
        "delimiterOrRegex": "/booking",
        "normalization": "ORIGINAL",
        "useFromChildCalls": "false"
      }
    ],
    "topX": 10,
    "topXDirection": "DESCENDING",
    "topXAggregation": "AVERAGE"
  }
}

Response

Response codes

Code	Type	Description
201	EntityShortRepresentation	Success. The new calculated service metric has been created. Response contains the key of the new metric.
204		Success. The calculated service metric has been updated. Response doesn't have a body.
400	ErrorEnvelope	Failed. The input is invalid

Response body objects

The `EntityShortRepresentation` object

The short representation of a Dynatrace entity.

Element	Type	Description
id	string	The ID of the Dynatrace entity.
name	string	The name of the Dynatrace entity.
description	string	A short description of the Dynatrace entity.

Response body JSON model

json
{
  "id": "6a98d7bc-abb9-44f8-ae6a-73e68e71812a",
  "name": "Dynatrace entity",
  "description": "Dynatrace entity for the REST API example"
}

Validate payload

We recommend that you validate the payload before submitting it with an actual request. A response code of 204 indicates a valid payload.

The request consumes an application/json payload.

POST	ManagedDynatrace for Government	`https://{your-domain}/e/{your-environment-id}/api/config/v1/calculatedMetrics/service/{metricKey}/validator`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/config/v1/calculatedMetrics/service/{metricKey}/validator`
	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/calculatedMetrics/service/{metricKey}/validator`

Authentication

To execute this request, you need an access token with WriteConfig scope.

To learn how to obtain and use it, see Tokens and authentication.

Response

Response codes

Code	Type	Description
204		Validated. The submitted configuration is valid. Response doesn't have a body.
400	ErrorEnvelope	Failed. The input is invalid

Example

In this example, the request modifies the Requests by code calculated service metric created in the POST request example. The request restricts the metric to the Easytravel management zone and adds the condition of process group having the cardVerification tag.

The API token is passed in the Authorization header.

Because the request body is lengthy, it is truncated in this example Curl section. See the full body in the Request body section. You can download or copy the example request body to try it out on your own. Before using it, make sure that you're using management zone and tags that are available in your environment.

The response code of 204 indicates that the update was successful.

Curl

bash
curl -X PUT \
  https://mySampleEnv.live.dynatrace.com/api/config/v1/calculatedMetrics/service/calc:service.requestsbycode \
  -H 'Accept: Accept: application/json; charset=utf-8' \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
  -H 'Content-Type: application/json' \
  -d '{<truncated - see the Request body section >}
'

Request URL

plaintext
https://mySampleEnv.live.dynatrace.com/api/config/v1/calculatedMetrics/service/calc:service.requestsbycode

Request body

json
{
  "tsmMetricKey": "calc:service.requestsbycode",
  "name": "Requests by code",
  "enabled": true,
  "metricDefinition": {
    "metric": "REQUEST_COUNT",
    "requestAttribute": null
  },
  "unit": "COUNT",
  "unitDisplayName": "",
  "entityId": null,
  "managementZones": ["Easytravel"],
  "conditions": [
    {
      "attribute": "PROCESS_GROUP_TAG",
      "comparisonInfo": {
        "type": "TAG",
        "comparison": "TAG_KEY_EQUALS",
        "value": {
          "context": "CONTEXTLESS",
          "key": "payment"
        },
        "negate": false
      }
    },
    {
      "attribute": "PROCESS_GROUP_TAG",
      "comparisonInfo": {
        "type": "TAG",
        "comparison": "TAG_KEY_EQUALS",
        "value": {
          "context": "CONTEXTLESS",
          "key": "cardVerification"
        },
        "negate": false
      }
    }
  ],
  "dimensionDefinition": {
    "name": "HTTP Status class",
    "dimension": "{HTTP-StatusClass}",
    "placeholders": [],
    "topX": 10,
    "topXDirection": "DESCENDING",
    "topXAggregation": "SINGLE_VALUE"
  }
}

Response code

204

Service metrics API - PUT a metric

Authentication

Parameters

Request body objects

The CalculatedServiceMetric object

The ConfigurationMetadata object

The CalculatedMetricDefinition object

The Condition object

The ComparisonInfo object

The DimensionDefinition object

The Placeholder object

The PropagationSource object

The UniversalTag object

The UniversalTagKey object

Request body JSON model

Response

Response codes

Response body objects

The EntityShortRepresentation object

Response body JSON model

Validate payload

Authentication

Response

Response codes

Example

Curl

Request URL

Request body

Response code

The `CalculatedServiceMetric` object

The `ConfigurationMetadata` object

The `CalculatedMetricDefinition` object

The `Condition` object

The `ComparisonInfo` object

The `DimensionDefinition` object

The `Placeholder` object

The `PropagationSource` object

The `UniversalTag` object

The `UniversalTagKey` object

The `EntityShortRepresentation` object