feat(client-application-signals): This release adds API support for reading Service Level Objectives and Services from monitoring accounts, from SLO and Service-scoped operations, including ListServices and ListServiceLevelObjectives.

Author: awstools

clients/client-application-signals/src/commands/CreateServiceLevelObjectiveCommand.ts

@@ -44,6 +44,10 @@ export interface CreateServiceLevelObjectiveCommandOutput extends CreateServiceL
  *          <p>The target performance quality that is defined for an SLO is the <i>attainment goal</i>.</p>
  *          <p>You can set SLO targets for your applications that are discovered by Application Signals, using critical metrics such as latency and availability.
  *         You can also set SLOs against any CloudWatch metric or math expression that produces a time series.</p>
+ *          <note>
+ *             <p>You can't create an SLO for a service operation that was discovered by Application Signals until after that operation has reported standard
+ *      metrics to Application Signals.</p>
+ *          </note>
  *          <p>When you create an SLO, you specify whether it is a <i>period-based SLO</i>
  *        or a <i>request-based SLO</i>. Each type of SLO has a different way of evaluating
  *     your application's performance against its attainment goal.</p>

clients/client-application-signals/src/commands/GetServiceCommand.ts

@@ -69,6 +69,7 @@ export interface GetServiceCommandOutput extends GetServiceOutput, __MetadataBea
  * //           },
  * //         ],
  * //         MetricName: "STRING_VALUE", // required
+ * //         AccountId: "STRING_VALUE",
  * //       },
  * //     ],
  * //     LogGroupReferences: [ // LogGroupReferences

clients/client-application-signals/src/commands/ListServiceDependenciesCommand.ts

@@ -74,6 +74,7 @@ export interface ListServiceDependenciesCommandOutput extends ListServiceDepende
  * //             },
  * //           ],
  * //           MetricName: "STRING_VALUE", // required
+ * //           AccountId: "STRING_VALUE",
  * //         },
  * //       ],
  * //     },

clients/client-application-signals/src/commands/ListServiceDependentsCommand.ts

@@ -72,6 +72,7 @@ export interface ListServiceDependentsCommandOutput extends ListServiceDependent
  * //             },
  * //           ],
  * //           MetricName: "STRING_VALUE", // required
+ * //           AccountId: "STRING_VALUE",
  * //         },
  * //       ],
  * //     },

clients/client-application-signals/src/commands/ListServiceLevelObjectivesCommand.ts

@@ -46,6 +46,8 @@ export interface ListServiceLevelObjectivesCommandOutput extends ListServiceLeve
  *   OperationName: "STRING_VALUE",
  *   MaxResults: Number("int"),
  *   NextToken: "STRING_VALUE",
+ *   IncludeLinkedAccounts: true || false,
+ *   SloOwnerAwsAccountId: "STRING_VALUE",
  * };
  * const command = new ListServiceLevelObjectivesCommand(input);
  * const response = await client.send(command);

clients/client-application-signals/src/commands/ListServiceOperationsCommand.ts

@@ -68,6 +68,7 @@ export interface ListServiceOperationsCommandOutput extends ListServiceOperation
  * //             },
  * //           ],
  * //           MetricName: "STRING_VALUE", // required
+ * //           AccountId: "STRING_VALUE",
  * //         },
  * //       ],
  * //     },

clients/client-application-signals/src/commands/ListServicesCommand.ts

@@ -46,6 +46,8 @@ export interface ListServicesCommandOutput extends ListServicesOutput, __Metadat
  *   EndTime: new Date("TIMESTAMP"), // required
  *   MaxResults: Number("int"),
  *   NextToken: "STRING_VALUE",
+ *   IncludeLinkedAccounts: true || false,
+ *   AwsAccountId: "STRING_VALUE",
  * };
  * const command = new ListServicesCommand(input);
  * const response = await client.send(command);
@@ -73,6 +75,7 @@ export interface ListServicesCommandOutput extends ListServicesOutput, __Metadat
  * //             },
  * //           ],
  * //           MetricName: "STRING_VALUE", // required
+ * //           AccountId: "STRING_VALUE",
  * //         },
  * //       ],
  * //     },

clients/client-application-signals/src/models/models_0.ts

@@ -1035,6 +1035,12 @@ export interface MetricReference {
    * @public
    */
   MetricName: string | undefined;
+
+  /**
+   * <p>Amazon Web Services account ID.</p>
+   * @public
+   */
+  AccountId?: string | undefined;
 }
 
 /**
@@ -1747,6 +1753,20 @@ export interface ListServicesInput {
    * @public
    */
   NextToken?: string | undefined;
+
+  /**
+   * <p>If you are using this operation in a monitoring account, specify <code>true</code> to include services from source accounts in the returned data.
+   *
+   *       </p>
+   * @public
+   */
+  IncludeLinkedAccounts?: boolean | undefined;
+
+  /**
+   * <p>Amazon Web Services Account ID.</p>
+   * @public
+   */
+  AwsAccountId?: string | undefined;
 }
 
 /**
@@ -2022,7 +2042,7 @@ export class ConflictException extends __BaseException {
  *       exactly 1 indicates that the SLO goal will be met exactly.</p>
  *          <p>For example, if you specify 60 as the number of minutes in the look-back window, the burn rate is calculated as the following:</p>
  *          <p>
- *             <i>burn rate = error rate over the look-back window / (1 - attainment goal percentage)</i>
+ *             <i>burn rate = error rate over the look-back window / (100% - attainment goal percentage)</i>
  *          </p>
  *          <p>For more information about burn rates, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-ServiceLevelObjectives.html#CloudWatch-ServiceLevelObjectives-burn">Calculate burn rates</a>.</p>
  * @public
@@ -2497,6 +2517,23 @@ export interface ListServiceLevelObjectivesInput {
    * @public
    */
   NextToken?: string | undefined;
+
+  /**
+   * <p>If you are using this operation in a monitoring account, specify <code>true</code> to include SLO from source accounts in the returned data.
+   *
+   *       </p>
+   *          <p>When you are monitoring an account, you can use Amazon Web Services account ID in <code>KeyAttribute</code> filter for service source account and <code>SloOwnerawsaccountID</code> for SLO source account with <code>IncludeLinkedAccounts</code> to filter the returned data to only a single source account.
+   *
+   *       </p>
+   * @public
+   */
+  IncludeLinkedAccounts?: boolean | undefined;
+
+  /**
+   * <p>SLO's Amazon Web Services account ID.</p>
+   * @public
+   */
+  SloOwnerAwsAccountId?: string | undefined;
 }
 
 /**

clients/client-application-signals/src/protocols/Aws_restJson1.ts

@@ -288,6 +288,8 @@ export const se_ListServiceLevelObjectivesCommand = async (
     [_ON]: [, input[_ON]!],
     [_MR]: [() => input.MaxResults !== void 0, () => input[_MR]!.toString()],
     [_NT]: [, input[_NT]!],
+    [_ILA]: [() => input.IncludeLinkedAccounts !== void 0, () => input[_ILA]!.toString()],
+    [_SOAAI]: [, input[_SOAAI]!],
   });
   let body: any;
   body = JSON.stringify(
@@ -342,6 +344,8 @@ export const se_ListServicesCommand = async (
     [_ET]: [__expectNonNull(input.EndTime, `EndTime`) != null, () => __serializeDateTime(input[_ET]!).toString()],
     [_MR]: [() => input.MaxResults !== void 0, () => input[_MR]!.toString()],
     [_NT]: [, input[_NT]!],
+    [_ILA]: [() => input.IncludeLinkedAccounts !== void 0, () => input[_ILA]!.toString()],
+    [_AAI]: [, input[_AAI]!],
   });
   let body: any;
   b.m("GET").h(headers).q(query).b(body);
@@ -1234,9 +1238,12 @@ const deserializeMetadata = (output: __HttpResponse): __ResponseMetadata => ({
 const collectBodyString = (streamBody: any, context: __SerdeContext): Promise<string> =>
   collectBody(streamBody, context).then((body) => context.utf8Encoder(body));
 
+const _AAI = "AwsAccountId";
 const _ET = "EndTime";
+const _ILA = "IncludeLinkedAccounts";
 const _MR = "MaxResults";
 const _NT = "NextToken";
 const _ON = "OperationName";
 const _RA = "ResourceArn";
+const _SOAAI = "SloOwnerAwsAccountId";
 const _ST = "StartTime";