# InsightRule
<a name="API_InsightRule"></a>

This structure contains the definition for a Contributor Insights rule. For more information about this rule, see[ Using Constributor Insights to analyze high-cardinality data](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html) in the *Amazon CloudWatch User Guide*.

## Contents
<a name="API_InsightRule_Contents"></a>

 ** Definition **   <a name="ACW-Type-InsightRule-Definition"></a>
The definition of the rule, as a JSON object. The definition contains the keywords used to define contributors, the value to aggregate on if this rule returns a sum instead of a count, and the filters. For details on the valid syntax, see [Contributor Insights Rule Syntax](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights-RuleSyntax.html).  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 8192.  
Pattern: `[\x00-\x7F]+`   
Required: Yes

 ** Name **   <a name="ACW-Type-InsightRule-Name"></a>
The name of the rule.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `[\x20-\x7E]+`   
Required: Yes

 ** Schema **   <a name="ACW-Type-InsightRule-Schema"></a>
For rules that you create, this is always `{"Name": "CloudWatchLogRule", "Version": 1}`. For managed rules, this is `{"Name": "ServiceLogRule", "Version": 1}`   
Type: String  
Required: Yes

 ** State **   <a name="ACW-Type-InsightRule-State"></a>
Indicates whether the rule is enabled or disabled.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 32.  
Pattern: `[\x20-\x7E]+`   
Required: Yes

 ** ApplyOnTransformedLogs **   <a name="ACW-Type-InsightRule-ApplyOnTransformedLogs"></a>
Displays whether the rule is evaluated on the transformed versions of logs, for log groups that have [Log transformation](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation.html) enabled. If this is `false`, log events are evaluated before they are transformed.  
Type: Boolean  
Required: No

 ** ManagedRule **   <a name="ACW-Type-InsightRule-ManagedRule"></a>
 An optional built-in rule that AWS manages.   
Type: Boolean  
Required: No

## See Also
<a name="API_InsightRule_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/monitoring-2010-08-01/InsightRule) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/monitoring-2010-08-01/InsightRule) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/monitoring-2010-08-01/InsightRule)