Type object
Schema URL https://catalog.lintel.tools/schemas/schemastore/serverless-framework-configuration/_shared/latest--aws-rum-appmonitor.json
Parent schema serverless-framework-configuration
Type: object

Resource Type definition for AWS::RUM::AppMonitor. Source:- https://github.com/aws-cloudformation/aws-cloudformation-rpdk.git

Properties

Name string | Aws_CF_FunctionString required

A name for the app monitor

Domain string | Aws_CF_FunctionString required

The top-level internet domain name for which your application has administrative authority.

CwLogEnabled boolean

Data collected by RUM is kept by RUM for 30 days and then deleted. This parameter specifies whether RUM sends a copy of this telemetry data to CWLlong in your account. This enables you to keep the telemetry data for more than 30 days, but it does incur CWLlong charges. If you omit this parameter, the default is false

Tags Tag[]

Assigns one or more tags (key-value pairs) to the app monitor. Tags can help you organize and categorize your resources. You can also use them to scope user permissions by granting a user permission to access or change only resources with certain tag values. Tags don't have any semantic meaning to AWS and are interpreted strictly as strings of characters.You can associate as many as 50 tags with an app monitor.

uniqueItems=true
AppMonitorConfiguration object

AppMonitor configuration

10 nested properties
IdentityPoolId string | Aws_CF_FunctionString

The ID of the identity pool that is used to authorize the sending of data to RUM.

ExcludedPages Url[]

List of url pages

minItems=0maxItems=50
IncludedPages Url[]

List of url pages

minItems=0maxItems=50
FavoritePages string[]

List of favorite pages

minItems=0maxItems=50
SessionSampleRate number

Specifies the percentage of user sessions to use for RUM data collection. Choosing a higher percentage gives you more data but also incurs more costs. The number you specify is the percentage of user sessions that will be used. If you omit this parameter, the default of 10 is used.

min=0max=1
GuestRoleArn string | Aws_CF_FunctionString

Resource ARN

AllowCookies boolean

If you set this to true, the RUM web client sets two cookies, a session cookie and a user cookie. The cookies allow the RUM web client to collect data relating to the number of users an application has and the behavior of the application across a sequence of events. Cookies are stored in the top-level domain of the current page.

Telemetries Telemetry[]

An array that lists the types of telemetry data that this app monitor is to collect.

EnableXRay boolean

If you set this to true, RUM enables xray tracing for the user sessions that RUM samples. RUM adds an xray trace header to allowed HTTP requests. It also records an xray segment for allowed HTTP requests. You can see traces and segments from these user sessions in the xray console and the CW ServiceLens console.

MetricDestinations MetricDestination[]

An array of structures which define the destinations and the metrics that you want to send.

minItems=0maxItems=20uniqueItems=true
CustomEvents object

AppMonitor custom events configuration

1 nested properties
Status string | Aws_CF_FunctionString

Definitions

AppMonitorConfiguration object

AppMonitor configuration

IdentityPoolId string | Aws_CF_FunctionString

The ID of the identity pool that is used to authorize the sending of data to RUM.

ExcludedPages Url[]

List of url pages

minItems=0maxItems=50
IncludedPages Url[]

List of url pages

minItems=0maxItems=50
FavoritePages string[]

List of favorite pages

minItems=0maxItems=50
SessionSampleRate number

Specifies the percentage of user sessions to use for RUM data collection. Choosing a higher percentage gives you more data but also incurs more costs. The number you specify is the percentage of user sessions that will be used. If you omit this parameter, the default of 10 is used.

min=0max=1
GuestRoleArn string | Aws_CF_FunctionString

Resource ARN

AllowCookies boolean

If you set this to true, the RUM web client sets two cookies, a session cookie and a user cookie. The cookies allow the RUM web client to collect data relating to the number of users an application has and the behavior of the application across a sequence of events. Cookies are stored in the top-level domain of the current page.

Telemetries Telemetry[]

An array that lists the types of telemetry data that this app monitor is to collect.

EnableXRay boolean

If you set this to true, RUM enables xray tracing for the user sessions that RUM samples. RUM adds an xray trace header to allowed HTTP requests. It also records an xray segment for allowed HTTP requests. You can see traces and segments from these user sessions in the xray console and the CW ServiceLens console.

MetricDestinations MetricDestination[]

An array of structures which define the destinations and the metrics that you want to send.

minItems=0maxItems=20uniqueItems=true
TagDef Tag[]

Assigns one or more tags (key-value pairs) to the app monitor. Tags can help you organize and categorize your resources. You can also use them to scope user permissions by granting a user permission to access or change only resources with certain tag values. Tags don't have any semantic meaning to AWS and are interpreted strictly as strings of characters.You can associate as many as 50 tags with an app monitor.

Tag object

A key-value pair to associate with a resource.

Key string | Aws_CF_FunctionString required

The key name of the tag. You can specify a value that is 1 to 128 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.

Value string | Aws_CF_FunctionString required

The value for the tag. You can specify a value that is 0 to 256 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.

Pages Url[]

List of url pages

FavoritePages string[]

List of favorite pages

Url string | Aws_CF_FunctionString

Page Url

Arn string | Aws_CF_FunctionString

Resource ARN

Telemetry string | Aws_CF_FunctionString
MetricDestination object

An structure which defines the destination and the metrics that you want to send.

Destination string | Aws_CF_FunctionString required

Defines the destination to send the metrics to. Valid values are CloudWatch and Evidently. If you specify Evidently, you must also specify the ARN of the Evidently experiment that is to be the destination and an IAM role that has permission to write to the experiment.

DestinationArn string | Aws_CF_FunctionString

Use this parameter only if Destination is Evidently. This parameter specifies the ARN of the Evidently experiment that will receive the extended metrics.

IamRoleArn string | Aws_CF_FunctionString

This parameter is required if Destination is Evidently. If Destination is CloudWatch, do not use this parameter.

This parameter specifies the ARN of an IAM role that RUM will assume to write to the Evidently experiment that you are sending metrics to. This role must have permission to write to that experiment.

MetricDefinitions MetricDefinition[]

An array of structures which define the metrics that you want to send.

minItems=0maxItems=2000uniqueItems=true
MetricDefinition object

A single metric definition

Name string | Aws_CF_FunctionString required

The name for the metric that is defined in this structure. For extended metrics, valid values are the following:

PerformanceNavigationDuration

PerformanceResourceDuration

NavigationSatisfiedTransaction

NavigationToleratedTransaction

NavigationFrustratedTransaction

WebVitalsCumulativeLayoutShift

WebVitalsFirstInputDelay

WebVitalsLargestContentfulPaint

JsErrorCount

HttpErrorCount

SessionCount

Namespace string | Aws_CF_FunctionString

The namespace used by CloudWatch Metrics for the metric that is defined in this structure

ValueKey string | Aws_CF_FunctionString

The field within the event object that the metric value is sourced from.

If you omit this field, a hardcoded value of 1 is pushed as the metric value. This is useful if you just want to count the number of events that the filter catches.

If this metric is sent to Evidently, this field will be passed to Evidently raw and Evidently will handle data extraction from the event.

UnitLabel string | Aws_CF_FunctionString

The CloudWatch metric unit to use for this metric. If you omit this field, the metric is recorded with no unit.

DimensionKeys object

Use this field only if you are sending the metric to CloudWatch.

This field is a map of field paths to dimension names. It defines the dimensions to associate with this metric in CloudWatch. For extended metrics, valid values for the entries in this field are the following:

"metadata.pageId": "PageId"

"metadata.browserName": "BrowserName"

"metadata.deviceType": "DeviceType"

"metadata.osName": "OSName"

"metadata.countryCode": "CountryCode"

"event_details.fileType": "FileType"

All dimensions listed in this field must also be included in EventPattern.

EventPattern string | Aws_CF_FunctionString

The pattern that defines the metric, specified as a JSON object. RUM checks events that happen in a user's session against the pattern, and events that match the pattern are sent to the metric destination.

When you define extended metrics, the metric definition is not valid if EventPattern is omitted.

Example event patterns:

'{ "event_type": ["com.amazon.rum.js_error_event"], "metadata": { "browserName": [ "Chrome", "Safari" ], } }'

'{ "event_type": ["com.amazon.rum.performance_navigation_event"], "metadata": { "browserName": [ "Chrome", "Firefox" ] }, "event_details": { "duration": [{ "numeric": [ "<", 2000 ] }] } }'

'{ "event_type": ["com.amazon.rum.performance_navigation_event"], "metadata": { "browserName": [ "Chrome", "Safari" ], "countryCode": [ "US" ] }, "event_details": { "duration": [{ "numeric": [ ">=", 2000, "<", 8000 ] }] } }'

If the metrics destination' is CloudWatch and the event also matches a value in DimensionKeys, then the metric is published with the specified dimensions.

CustomEventsStatus string | Aws_CF_FunctionString
CustomEvents object

AppMonitor custom events configuration

Status string | Aws_CF_FunctionString