software.amazon.awscdk.services.rum

Interface CfnAppMonitor.AppMonitorConfigurationProperty

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CfnAppMonitor.AppMonitorConfigurationProperty.Jsii$Proxy

Enclosing class:

CfnAppMonitor

@Stability(value=Stable)
public static interface CfnAppMonitor.AppMonitorConfigurationProperty
extends software.amazon.jsii.JsiiSerializable

This structure contains much of the configuration data for the app monitor.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.rum.*;
 AppMonitorConfigurationProperty appMonitorConfigurationProperty = AppMonitorConfigurationProperty.builder()
         .allowCookies(false)
         .enableXRay(false)
         .excludedPages(List.of("excludedPages"))
         .favoritePages(List.of("favoritePages"))
         .guestRoleArn("guestRoleArn")
         .identityPoolId("identityPoolId")
         .includedPages(List.of("includedPages"))
         .sessionSampleRate(123)
         .telemetries(List.of("telemetries"))
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	CfnAppMonitor.AppMonitorConfigurationProperty.Builder A builder for CfnAppMonitor.AppMonitorConfigurationProperty
static class	CfnAppMonitor.AppMonitorConfigurationProperty.Jsii$Proxy An implementation for CfnAppMonitor.AppMonitorConfigurationProperty

Method Summary

Modifier and Type	Method and Description
static CfnAppMonitor.AppMonitorConfigurationProperty.Builder	builder()
default Object	getAllowCookies() If you set this to `true` , the CloudWatch RUM web client sets two cookies, a session cookie and a user cookie.
default Object	getEnableXRay() If you set this to `true` , CloudWatch RUM sends client-side traces to X-Ray for each sampled session.
default List<String>	getExcludedPages() A list of URLs in your website or application to exclude from RUM data collection.
default List<String>	getFavoritePages() A list of pages in your application that are to be displayed with a "favorite" icon in the CloudWatch RUM console.
default String	getGuestRoleArn() The ARN of the guest IAM role that is attached to the Amazon Cognito identity pool that is used to authorize the sending of data to CloudWatch RUM.
default String	getIdentityPoolId() The ID of the Amazon Cognito identity pool that is used to authorize the sending of data to CloudWatch RUM.
default List<String>	getIncludedPages() If this app monitor is to collect data from only certain pages in your application, this structure lists those pages.
default Number	getSessionSampleRate() Specifies the portion of user sessions to use for CloudWatch RUM data collection.
default List<String>	getTelemetries() An array that lists the types of telemetry data that this app monitor is to collect.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getAllowCookies

@Stability(value=Stable)
 @Nullable
default Object getAllowCookies()

If you set this to `true` , the CloudWatch RUM web client sets two cookies, a session cookie and a user cookie.

The cookies allow the CloudWatch 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.

getEnableXRay

@Stability(value=Stable)
 @Nullable
default Object getEnableXRay()

If you set this to `true` , CloudWatch RUM sends client-side traces to X-Ray for each sampled session.

You can then see traces and segments from these user sessions in the RUM dashboard and the CloudWatch ServiceLens console. For more information, see What is AWS X-Ray ?

getExcludedPages

@Stability(value=Stable)
 @Nullable
default List<String> getExcludedPages()

A list of URLs in your website or application to exclude from RUM data collection.

You can't include both ExcludedPages and IncludedPages in the same app monitor.

getFavoritePages

@Stability(value=Stable)
 @Nullable
default List<String> getFavoritePages()

A list of pages in your application that are to be displayed with a "favorite" icon in the CloudWatch RUM console.

getGuestRoleArn

@Stability(value=Stable)
 @Nullable
default String getGuestRoleArn()

The ARN of the guest IAM role that is attached to the Amazon Cognito identity pool that is used to authorize the sending of data to CloudWatch RUM.

getIdentityPoolId

@Stability(value=Stable)
 @Nullable
default String getIdentityPoolId()

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

getIncludedPages

@Stability(value=Stable)
 @Nullable
default List<String> getIncludedPages()

If this app monitor is to collect data from only certain pages in your application, this structure lists those pages.

You can't include both ExcludedPages and IncludedPages in the same app monitor.

getSessionSampleRate

@Stability(value=Stable)
 @Nullable
default Number getSessionSampleRate()

Specifies the portion of user sessions to use for CloudWatch RUM data collection.

Choosing a higher portion gives you more data but also incurs more costs.

The range for this value is 0 to 1 inclusive. Setting this to 1 means that 100% of user sessions are sampled, and setting it to 0.1 means that 10% of user sessions are sampled.

If you omit this parameter, the default of 0.1 is used, and 10% of sessions will be sampled.

getTelemetries

@Stability(value=Stable)
 @Nullable
default List<String> getTelemetries()

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

• errors indicates that RUM collects data about unhandled JavaScript errors raised by your application.
• performance indicates that RUM collects performance data about how your application and its resources are loaded and rendered. This includes Core Web Vitals.
• http indicates that RUM collects data about HTTP errors thrown by your application.

builder

@Stability(value=Stable)
static CfnAppMonitor.AppMonitorConfigurationProperty.Builder builder()

Returns:

a CfnAppMonitor.AppMonitorConfigurationProperty.Builder of CfnAppMonitor.AppMonitorConfigurationProperty