---
type: resource-type
title: CustomMetric
description: aws resource type AWS::IoT::CustomMetric
name: CustomMetric
lexicon: aws
resource_type: AWS::IoT::CustomMetric
---
`AWS::IoT::CustomMetric`, a resource type of the aws lexicon.

## Properties

- `MetricType` (`"ip-address-list" | "number" | "number-list" | "string-list"`, required): The type of the custom metric. Types include string-list, ip-address-list, number-list, and number.
- `DisplayName` (`string`, optional): Field represents a friendly name in the console for the custom metric; it doesn't have to be unique. Don't use this name as the metric identifier in the device metric report. Can be updated once defined.
- `MetricArn` (`string`, optional): The Amazon Resource Number (ARN) of the custom metric.
- `MetricName` (`string`, optional): The name of the custom metric. This will be used in the metric report submitted from the device/thing. Shouldn't begin with aws: . Cannot be updated once defined.
- `Tags` (`CustomMetric_Tag[]`, optional): An array of key-value pairs to apply to this resource.

## Attributes

- `MetricArn`