feat(client-rum): CloudWatch RUM now supports unminification of JS error stack traces.

Author: awstools

Diff for: clients/client-rum/src/commands/CreateAppMonitorCommand.ts

@@ -45,7 +45,10 @@ export interface CreateAppMonitorCommandOutput extends CreateAppMonitorResponse,
  * const client = new RUMClient(config);
  * const input = { // CreateAppMonitorRequest
  *   Name: "STRING_VALUE", // required
- *   Domain: "STRING_VALUE", // required
+ *   Domain: "STRING_VALUE",
+ *   DomainList: [ // AppMonitorDomainList
+ *     "STRING_VALUE",
+ *   ],
  *   Tags: { // TagMap
  *     "<keys>": "STRING_VALUE",
  *   },
@@ -72,6 +75,12 @@ export interface CreateAppMonitorCommandOutput extends CreateAppMonitorResponse,
  *   CustomEvents: { // CustomEvents
  *     Status: "STRING_VALUE",
  *   },
+ *   DeobfuscationConfiguration: { // DeobfuscationConfiguration
+ *     JavaScriptSourceMaps: { // JavaScriptSourceMaps
+ *       Status: "STRING_VALUE", // required
+ *       S3Uri: "STRING_VALUE",
+ *     },
+ *   },
  * };
  * const command = new CreateAppMonitorCommand(input);
  * const response = await client.send(command);

Diff for: clients/client-rum/src/commands/GetAppMonitorCommand.ts

@@ -44,6 +44,9 @@ export interface GetAppMonitorCommandOutput extends GetAppMonitorResponse, __Met
  * //   AppMonitor: { // AppMonitor
  * //     Name: "STRING_VALUE",
  * //     Domain: "STRING_VALUE",
+ * //     DomainList: [ // AppMonitorDomainList
+ * //       "STRING_VALUE",
+ * //     ],
  * //     Id: "STRING_VALUE",
  * //     Created: "STRING_VALUE",
  * //     LastModified: "STRING_VALUE",
@@ -79,6 +82,12 @@ export interface GetAppMonitorCommandOutput extends GetAppMonitorResponse, __Met
  * //     CustomEvents: { // CustomEvents
  * //       Status: "STRING_VALUE",
  * //     },
+ * //     DeobfuscationConfiguration: { // DeobfuscationConfiguration
+ * //       JavaScriptSourceMaps: { // JavaScriptSourceMaps
+ * //         Status: "STRING_VALUE", // required
+ * //         S3Uri: "STRING_VALUE",
+ * //       },
+ * //     },
  * //   },
  * // };
  *

Diff for: clients/client-rum/src/commands/UpdateAppMonitorCommand.ts

@@ -48,6 +48,9 @@ export interface UpdateAppMonitorCommandOutput extends UpdateAppMonitorResponse,
  * const input = { // UpdateAppMonitorRequest
  *   Name: "STRING_VALUE", // required
  *   Domain: "STRING_VALUE",
+ *   DomainList: [ // AppMonitorDomainList
+ *     "STRING_VALUE",
+ *   ],
  *   AppMonitorConfiguration: { // AppMonitorConfiguration
  *     IdentityPoolId: "STRING_VALUE",
  *     ExcludedPages: [ // Pages
@@ -71,6 +74,12 @@ export interface UpdateAppMonitorCommandOutput extends UpdateAppMonitorResponse,
  *   CustomEvents: { // CustomEvents
  *     Status: "STRING_VALUE",
  *   },
+ *   DeobfuscationConfiguration: { // DeobfuscationConfiguration
+ *     JavaScriptSourceMaps: { // JavaScriptSourceMaps
+ *       Status: "STRING_VALUE", // required
+ *       S3Uri: "STRING_VALUE",
+ *     },
+ *   },
  * };
  * const command = new UpdateAppMonitorCommand(input);
  * const response = await client.send(command);

Diff for: clients/client-rum/src/models/models_0.ts

@@ -223,6 +223,60 @@ export interface DataStorage {
   CwLog?: CwLog | undefined;
 }
 
+/**
+ * @public
+ * @enum
+ */
+export const DeobfuscationStatus = {
+  DISABLED: "DISABLED",
+  ENABLED: "ENABLED",
+} as const;
+
+/**
+ * @public
+ */
+export type DeobfuscationStatus = (typeof DeobfuscationStatus)[keyof typeof DeobfuscationStatus];
+
+/**
+ * <p>
+ *          A structure that contains the configuration for how an app monitor can unminify JavaScript error stack traces using source maps.
+ *       </p>
+ * @public
+ */
+export interface JavaScriptSourceMaps {
+  /**
+   * <p>
+   *          Specifies whether JavaScript error stack traces should be unminified for this app monitor. The default is for JavaScript error stack trace unminification to be <code>DISABLED</code>.
+   *       </p>
+   * @public
+   */
+  Status: DeobfuscationStatus | undefined;
+
+  /**
+   * <p>
+   *          The S3Uri of the bucket or folder that stores the source map files. It is required if status is ENABLED.
+   *       </p>
+   * @public
+   */
+  S3Uri?: string | undefined;
+}
+
+/**
+ * <p>
+ *          A structure that contains the configuration for how an app monitor can deobfuscate stack traces.
+ *       </p>
+ * @public
+ */
+export interface DeobfuscationConfiguration {
+  /**
+   * <p>
+   *          A structure that contains the configuration for how an app monitor can unminify JavaScript error stack traces using source maps.
+   *       </p>
+   * @public
+   */
+  JavaScriptSourceMaps?: JavaScriptSourceMaps | undefined;
+}
+
 /**
  * @public
  * @enum
@@ -257,6 +311,14 @@ export interface AppMonitor {
    */
   Domain?: string | undefined;
 
+  /**
+   * <p>
+   *          List the domain names for which your application has administrative authority.
+   *       </p>
+   * @public
+   */
+  DomainList?: string[] | undefined;
+
   /**
    * <p>The unique ID of this app monitor.</p>
    * @public
@@ -308,6 +370,14 @@ export interface AppMonitor {
    * @public
    */
   CustomEvents?: CustomEvents | undefined;
+
+  /**
+   * <p>
+   *          A structure that contains the configuration for how an app monitor can deobfuscate stack traces.
+   *       </p>
+   * @public
+   */
+  DeobfuscationConfiguration?: DeobfuscationConfiguration | undefined;
 }
 
 /**
@@ -1251,7 +1321,15 @@ export interface CreateAppMonitorRequest {
    * <p>The top-level internet domain name for which your application has administrative authority.</p>
    * @public
    */
-  Domain: string | undefined;
+  Domain?: string | undefined;
+
+  /**
+   * <p>
+   *          List the domain names for which your application has administrative authority. The <code>CreateAppMonitor</code> requires either the domain or the domain list.
+   *       </p>
+   * @public
+   */
+  DomainList?: string[] | undefined;
 
   /**
    * <p>Assigns one or more tags (key-value pairs) to the app monitor.</p>
@@ -1295,6 +1373,14 @@ export interface CreateAppMonitorRequest {
    * @public
    */
   CustomEvents?: CustomEvents | undefined;
+
+  /**
+   * <p>
+   *          A structure that contains the configuration for how an app monitor can deobfuscate stack traces.
+   *       </p>
+   * @public
+   */
+  DeobfuscationConfiguration?: DeobfuscationConfiguration | undefined;
 }
 
 /**
@@ -1870,6 +1956,14 @@ export interface UpdateAppMonitorRequest {
    */
   Domain?: string | undefined;
 
+  /**
+   * <p>
+   *          List the domain names for which your application has administrative authority. The <code>UpdateAppMonitor</code> allows either the domain or the domain list.
+   *       </p>
+   * @public
+   */
+  DomainList?: string[] | undefined;
+
   /**
    * <p>A structure that contains much of the configuration data for the app monitor. If you are using
    *          Amazon Cognito for authorization, you must include this structure in your request, and it must include the ID of the
@@ -1898,6 +1992,14 @@ export interface UpdateAppMonitorRequest {
    * @public
    */
   CustomEvents?: CustomEvents | undefined;
+
+  /**
+   * <p>
+   *          A structure that contains the configuration for how an app monitor can deobfuscate stack traces.
+   *       </p>
+   * @public
+   */
+  DeobfuscationConfiguration?: DeobfuscationConfiguration | undefined;
 }
 
 /**

Diff for: clients/client-rum/src/protocols/Aws_restJson1.ts

@@ -84,8 +84,10 @@ import {
   AppMonitorDetails,
   ConflictException,
   CustomEvents,
+  DeobfuscationConfiguration,
   InternalServerException,
   InvalidPolicyRevisionIdException,
+  JavaScriptSourceMaps,
   MalformedPolicyDocumentException,
   MetricDefinitionRequest,
   PolicyNotFoundException,
@@ -188,7 +190,9 @@ export const se_CreateAppMonitorCommand = async (
       AppMonitorConfiguration: (_) => se_AppMonitorConfiguration(_, context),
       CustomEvents: (_) => _json(_),
       CwLogEnabled: [],
+      DeobfuscationConfiguration: (_) => _json(_),
       Domain: [],
+      DomainList: (_) => _json(_),
       Name: [],
       Tags: (_) => _json(_),
     })
@@ -510,7 +514,9 @@ export const se_UpdateAppMonitorCommand = async (
       AppMonitorConfiguration: (_) => se_AppMonitorConfiguration(_, context),
       CustomEvents: (_) => _json(_),
       CwLogEnabled: [],
+      DeobfuscationConfiguration: (_) => _json(_),
       Domain: [],
+      DomainList: (_) => _json(_),
     })
   );
   b.m("PATCH").h(headers).b(body);
@@ -1234,12 +1240,18 @@ const se_AppMonitorConfiguration = (input: AppMonitorConfiguration, context: __S
 
 // se_AppMonitorDetails omitted.
 
+// se_AppMonitorDomainList omitted.
+
 // se_CustomEvents omitted.
 
+// se_DeobfuscationConfiguration omitted.
+
 // se_DimensionKeysMap omitted.
 
 // se_FavoritePages omitted.
 
+// se_JavaScriptSourceMaps omitted.
+
 // se_MetricDefinitionRequest omitted.
 
 // se_MetricDefinitionsRequest omitted.
@@ -1293,7 +1305,9 @@ const de_AppMonitor = (output: any, context: __SerdeContext): AppMonitor => {
     Created: __expectString,
     CustomEvents: _json,
     DataStorage: _json,
+    DeobfuscationConfiguration: _json,
     Domain: __expectString,
+    DomainList: _json,
     Id: __expectString,
     LastModified: __expectString,
     Name: __expectString,
@@ -1319,6 +1333,8 @@ const de_AppMonitorConfiguration = (output: any, context: __SerdeContext): AppMo
   }) as any;
 };
 
+// de_AppMonitorDomainList omitted.
+
 // de_AppMonitorSummary omitted.
 
 // de_AppMonitorSummaryList omitted.
@@ -1337,12 +1353,16 @@ const de_AppMonitorConfiguration = (output: any, context: __SerdeContext): AppMo
 
 // de_DataStorage omitted.
 
+// de_DeobfuscationConfiguration omitted.
+
 // de_DimensionKeysMap omitted.
 
 // de_EventDataList omitted.
 
 // de_FavoritePages omitted.
 
+// de_JavaScriptSourceMaps omitted.
+
 // de_MetricDefinition omitted.
 
 // de_MetricDefinitionIds omitted.