# Dynatrace::Environment::Metric Manage a timeseries metric (V1) in Dynatrace. ## Syntax To declare this entity in your AWS CloudFormation template, use the following syntax: ### JSON

{
    "Type" : "Dynatrace::Environment::Metric",
    "Properties" : {
        "DisplayName" : String,
        "Unit" : String,
        "Dimensions" : [ String, ... ],
        "Types" : [ String, ... ],
        "TimeseriesId" : String,
        "PluginId" : String,
        "Warnings" : [ String, ... ]
    }
}

### YAML

Type: Dynatrace::Environment::Metric
Properties:
    DisplayName: String
    Unit: String
    Dimensions: 
      - String
    Types: 
      - String
    TimeseriesId: String
    PluginId: String
    Warnings: 
      - String

## Properties #### DisplayName The name of the metric in the user interface. It is limited to 256 characters. _Required_: No _Type_: String _Minimum Length_: 1 _Maximum Length_: 256 _Update requires_: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) #### Unit The unit of the metric. _Required_: No _Type_: String _Allowed Values_: Billion (bilcount) | Bit (bit) | BitPerHour (bit/h) | BitPerMinute (bit/min) | BitPerSecond (bit/s) | Byte (B) | BytePerHour (B/h) | BytePerMinute (B/min) | BytePerSecond (B/s) | Cores | Count (count) | Day (ds) | DecibelMilliWatt (dBm) | G | GibiByte (GiB) | GigaByte (GB) | Hour (hs) | KibiByte (KiB) | KibiBytePerHour (KiB/h) | KibiBytePerMinute (KiB/min) | KibiBytePerSecond (KiB/s) | KiloByte (kB) | KiloBytePerHour (kB/h) | KiloBytePerMinute (kB/min) | KiloBytePerSecond (kB/s) | M | MSU | MebiByte (MiB) | MebiBytePerHour (MiB/h) | MebiBytePerMinute (MiB/min) | MebiBytePerSecond (MiB/s) | MegaByte (MB) | MegaBytePerHour (MB/h) | MegaBytePerMinute (MB/min) | MegaBytePerSecond (MB/s) | MicroSecond (µs) | MilliSecond (ms) | MilliSecondPerMinute (ms/min) | Million (milcount) | Minute (mins) | Month (mos) | N/A | NanoSecond (ns) | NanoSecondPerMinute (ns/min) | PerHour (count/h) | PerMinute (count/min) | PerSecond (count/s) | Percent (%) | Pixel (px) | Promille (‰) | Ratio | Second (s) | State | Unspecified | Week (ws) | Year (ys) | k | km/h | m/h | m/s | mCores _Update requires_: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) #### Dimensions The metric dimension key that will be used to report multiple dimensions. For example, a dimension key to report the metric for different network cards for the same firewall. The CUSTOM_DEVICE dimension is added to each new custom metric automatically. _Required_: No _Type_: List of String _Update requires_: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) #### Types The definition of the technology type. It is used to group metrics under a logical technology name in the UI. Metrics must be assigned a software technology type that is identical to the technology type of the custom device you are sending the metric to. For example, if you define your custom device using type F5-Firewall you must also register all related custom metrics as type F5-Firewall. The field is required when creating a new metric. _Required_: No _Type_: List of String _Update requires_: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) #### TimeseriesId The ID of the metric. _Required_: No _Type_: String _Pattern_: ^custom\:([a-zA-Z][a-zA-Z0-9]*([\.\_\-][a-zA-Z])?)+$ _Update requires_: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement) #### PluginId The ID of the plugin, where the metric originates. _Required_: No _Type_: String _Update requires_: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) #### Warnings The warnings that occurred while creating the metric. _Required_: No _Type_: List of String _Update requires_: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt) ## Return Values ### Ref When you pass the logical ID of this resource to the intrinsic `Ref` function, Ref returns the TimeseriesId. ### Fn::GetAtt The `Fn::GetAtt` intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values. For more information about using the `Fn::GetAtt` intrinsic function, see [Fn::GetAtt](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html). #### AggregationTypes The list of allowed aggregations for this metric. #### Filter The feature, where the metric originates. #### DetailedSource The feature, where the metric originates.