---
# generated by https://github.com/hashicorp/terraform-plugin-docs
page_title: "awscc_iot_custom_metric Resource - terraform-provider-awscc"
subcategory: ""
description: |-
A custom metric published by your devices to Device Defender.
---
# awscc_iot_custom_metric (Resource)
A custom metric published by your devices to Device Defender.
## Schema
### Required
- `metric_type` (String) The type of the custom metric. Types include string-list, ip-address-list, number-list, and number.
### Optional
- `display_name` (String) 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.
- `metric_name` (String) 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` (Attributes Set) An array of key-value pairs to apply to this resource. (see [below for nested schema](#nestedatt--tags))
### Read-Only
- `id` (String) Uniquely identifies the resource.
- `metric_arn` (String) The Amazon Resource Number (ARN) of the custom metric.
### Nested Schema for `tags`
Optional:
- `key` (String) The tag's key.
- `value` (String) The tag's value.
## Import
Import is supported using the following syntax:
```shell
$ terraform import awscc_iot_custom_metric.example
```