Skip to content

Commit ff05cf2

Browse files
[MetricsAdvisor] Rename methods (Azure#12231)
1 parent 82ff76f commit ff05cf2

File tree

16 files changed

+169
-156
lines changed

16 files changed

+169
-156
lines changed

sdk/metricsadvisor/ai-metrics-advisor/CHANGELOG.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,24 @@
2020
- [Breaking] `IncidentRootCause` property `dimensionKey` is renamed to `seriesKey`. `AnomalyIncident.dimensionKey` is renamed to `rootDimensionKey`
2121
- [Breaking] The `-List` suffix is removed from Array properties in `MetricSeriesData` and `MetricsEnrichedSeriesData`. Plural form is used instead.
2222
- [Breaking] `*PageResponse` types now extends from `Array<ItemType>` instead of wrapping an array of `ItemType`. Their types names are also shortened.
23+
- [Breaking] Rename method for listing alerts
24+
- `listAlertsForAlertConfiguration(alertConfigId, startTime, endTime, timemode, options)` to `listAlerts(alertConfigId, startTime, endTime, timemode, options)`
25+
- [Breaking] Rename feedback methods :
26+
- `listMetricFeedbacks()` to `listFeedback()`
27+
- `getMetricFeedback()` to `getFeedback()`
28+
- `createMetricFeedback()` to `createFeedback()`
29+
- [Breaking] Rename detection configuration methods:
30+
- `createMetricAnomalyDetectionConfiguration(anomalyConfig)` to `createDetectionConfig(anomalyConfig)`
31+
- `getMetricAnomalyDetectionConfiguration(detectionConfigId)` to `getDetectionConfig(detectionConfigId)`
32+
- `createMetricAnomalyDetectionConfiguration(config)` to `createDetectionConfig(config)`
33+
- `updateMetricAnomalyDetectionConfiguration(configId, patch)` to `updateDetectionConfig(configId, patch)`
34+
- `deleteMetricAnomalyDetectionConfiguration(detectionConfigId)` to `deleteDetectionConfig(detectionConfigId)`
35+
- `listMetricAnomalyDetectionConfigurations(metricId)` to `listDetectionConfigs(metricId)`
36+
- [Breaking] Rename anomaly alert configuration methods:
37+
- `createAnomalyAlertConfiguration(anomalyAlertConfig)` to `createAlertConfig(anomalyAlertConfig)`
38+
- `updateAnomalyAlertConfiguration(alertConfigId, patch)` to `updateAlertConfig(alertConfigId, patch)`
39+
- `deleteAnomalyAlertConfiguration(alertConfigId)` to `deleteAlertConfig(alertConfigId)`
40+
- `listAnomalyAlertConfigurations(detectdionConfigId)` to `listAlertConfigs(detectdionConfigId)`
2341
- [Breaking] Data feed ingestion granularity now has `"PerMinute"` and `"PerSecond"` instead of `"Minutely"` and `"Secondly"`.
2442
- [Breaking] Change the type of following timestamp properties from `Date` to `number`
2543
- `AnomalyAlert.timestamp`

sdk/metricsadvisor/ai-metrics-advisor/README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -298,7 +298,7 @@ async function configureAnomalyDetectionConfiguration(adminClient, metricId) {
298298
},
299299
description: "Detection configuration description"
300300
};
301-
return await adminClient.createMetricAnomalyDetectionConfiguration(anomalyConfig);
301+
return await adminClient.createDetectionConfig(anomalyConfig);
302302
}
303303
```
304304

@@ -391,7 +391,7 @@ async function configureAlertConfiguration(adminClient, detectionConfigId, hookI
391391
hookIds,
392392
description: "Alerting config description"
393393
};
394-
return await adminClient.createAnomalyAlertConfiguration(anomalyAlertConfig);
394+
return await adminClient.createAlertConfig(anomalyAlertConfig);
395395
}
396396
```
397397

@@ -429,7 +429,7 @@ async function main() {
429429

430430
async function queryAlerts(client, alertConfigId, startTime, endTime) {
431431
let alerts = [];
432-
for await (const alert of client.listAlertsForAlertConfiguration(
432+
for await (const alert of client.listAlerts(
433433
alertConfigId,
434434
startTime,
435435
endTime,

sdk/metricsadvisor/ai-metrics-advisor/review/ai-metrics-advisor.api.md

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -624,13 +624,13 @@ export type ListDataFeedsOptions = {
624624
} & OperationOptions;
625625

626626
// @public
627-
export type ListDimensionValuesForDetectionConfigurationOptions = {
627+
export type ListDimensionValuesForDetectionConfigOptions = {
628628
skip?: number;
629629
dimensionFilter?: DimensionKey;
630630
} & OperationOptions;
631631

632632
// @public
633-
export type ListFeedbacksOptions = {
633+
export type ListFeedbackOptions = {
634634
skip?: number;
635635
filter?: {
636636
dimensionFilter?: DimensionKey;
@@ -802,30 +802,30 @@ export type MetricPeriodFeedback = {
802802
// @public
803803
export class MetricsAdvisorAdministrationClient {
804804
constructor(endpointUrl: string, credential: MetricsAdvisorKeyCredential, options?: MetricsAdvisorAdministrationClientOptions);
805-
createAnomalyAlertConfiguration(config: Omit<AnomalyAlertConfiguration, "id">, options?: OperationOptions): Promise<GetAnomalyAlertConfigurationResponse>;
805+
createAlertConfig(config: Omit<AnomalyAlertConfiguration, "id">, options?: OperationOptions): Promise<GetAnomalyAlertConfigurationResponse>;
806806
createDataFeed(feed: Omit<DataFeed, "id" | "metricIds" | "isAdmin" | "status" | "creator" | "createdTime">, operationOptions?: OperationOptions): Promise<GetDataFeedResponse>;
807+
createDetectionConfig(config: Omit<AnomalyDetectionConfiguration, "id">, options?: OperationOptions): Promise<GetAnomalyDetectionConfigurationResponse>;
807808
createHook(hookInfo: EmailNotificationHook | WebNotificationHook, options?: OperationOptions): Promise<GetHookResponse>;
808-
createMetricAnomalyDetectionConfiguration(config: Omit<AnomalyDetectionConfiguration, "id">, options?: OperationOptions): Promise<GetAnomalyDetectionConfigurationResponse>;
809-
deleteAnomalyAlertConfiguration(id: string, options?: OperationOptions): Promise<RestResponse>;
809+
deleteAlertConfig(id: string, options?: OperationOptions): Promise<RestResponse>;
810810
deleteDataFeed(id: string, options?: OperationOptions): Promise<RestResponse>;
811+
deleteDetectionConfig(id: string, options?: OperationOptions): Promise<RestResponse>;
811812
deleteHook(id: string, options?: OperationOptions): Promise<RestResponse>;
812-
deleteMetricAnomalyDetectionConfiguration(id: string, options?: OperationOptions): Promise<RestResponse>;
813813
readonly endpointUrl: string;
814-
getAnomalyAlertConfiguration(id: string, options?: OperationOptions): Promise<GetAnomalyAlertConfigurationResponse>;
814+
getAlertConfig(id: string, options?: OperationOptions): Promise<GetAnomalyAlertConfigurationResponse>;
815815
getDataFeed(id: string, options?: OperationOptions): Promise<GetDataFeedResponse>;
816816
getDataFeedIngestionProgress(dataFeedId: string, options?: {}): Promise<GetIngestionProgressResponse>;
817+
getDetectionConfig(id: string, options?: OperationOptions): Promise<GetAnomalyDetectionConfigurationResponse>;
817818
getHook(id: string, options?: OperationOptions): Promise<GetHookResponse>;
818-
getMetricAnomalyDetectionConfiguration(id: string, options?: OperationOptions): Promise<GetAnomalyDetectionConfigurationResponse>;
819-
listAnomalyAlertConfigurations(detectionConfigId: string, options?: OperationOptions): PagedAsyncIterableIterator<AnomalyAlertConfiguration, AlertConfigurationsPageResponse, undefined>;
819+
listAlertConfigs(detectionConfigId: string, options?: OperationOptions): PagedAsyncIterableIterator<AnomalyAlertConfiguration, AlertConfigurationsPageResponse, undefined>;
820820
listDataFeedIngestionStatus(dataFeedId: string, startTime: Date | string, endTime: Date | string, options?: ListDataFeedIngestionStatusOptions): PagedAsyncIterableIterator<IngestionStatus, IngestionStatusPageResponse>;
821821
listDataFeeds(options?: ListDataFeedsOptions): PagedAsyncIterableIterator<DataFeed, DataFeedsPageResponse>;
822+
listDetectionConfigs(metricId: string, options?: OperationOptions): PagedAsyncIterableIterator<AnomalyDetectionConfiguration, DetectionConfigurationsPageResponse, undefined>;
822823
listHooks(options?: ListHooksOptions): PagedAsyncIterableIterator<NotificationHookUnion, HooksPageResponse>;
823-
listMetricAnomalyDetectionConfigurations(metricId: string, options?: OperationOptions): PagedAsyncIterableIterator<AnomalyDetectionConfiguration, DetectionConfigurationsPageResponse, undefined>;
824824
refreshDataFeedIngestion(dataFeedId: string, startTime: Date | string, endTime: Date | string, options?: OperationOptions): Promise<RestResponse>;
825-
updateAnomalyAlertConfiguration(id: string, patch: Partial<Omit<AnomalyAlertConfiguration, "id">>, options?: OperationOptions): Promise<GetAnomalyAlertConfigurationResponse>;
825+
updateAlertConfig(id: string, patch: Partial<Omit<AnomalyAlertConfiguration, "id">>, options?: OperationOptions): Promise<GetAnomalyAlertConfigurationResponse>;
826826
updateDataFeed(dataFeedId: string, patch: DataFeedPatch, options?: OperationOptions): Promise<GetDataFeedResponse>;
827+
updateDetectionConfig(id: string, patch: Partial<Omit<AnomalyDetectionConfiguration, "id" | "metricId">>, options?: OperationOptions): Promise<GetAnomalyDetectionConfigurationResponse>;
827828
updateHook(id: string, patch: EmailNotificationHookPatch | WebNotificationHookPatch, options?: OperationOptions): Promise<GetHookResponse>;
828-
updateMetricAnomalyDetectionConfiguration(id: string, patch: Partial<Omit<AnomalyDetectionConfiguration, "id" | "metricId">>, options?: OperationOptions): Promise<GetAnomalyDetectionConfigurationResponse>;
829829
}
830830

831831
// @public
@@ -835,21 +835,21 @@ export interface MetricsAdvisorAdministrationClientOptions extends PipelineOptio
835835
// @public
836836
export class MetricsAdvisorClient {
837837
constructor(endpointUrl: string, credential: MetricsAdvisorKeyCredential, options?: MetricsAdvisorClientOptions);
838-
createMetricFeedback(feedback: MetricFeedbackUnion, options?: OperationOptions): Promise<GetFeedbackResponse>;
838+
createFeedback(feedback: MetricFeedbackUnion, options?: OperationOptions): Promise<GetFeedbackResponse>;
839839
readonly endpointUrl: string;
840+
getFeedback(id: string, options?: OperationOptions): Promise<GetFeedbackResponse>;
840841
getIncidentRootCauses(detectionConfigId: string, incidentId: string, options?: OperationOptions): Promise<GetIncidentRootCauseResponse>;
841842
getMetricEnrichedSeriesData(detectionConfigId: string, startTime: Date | string, endTime: Date | string, seriesToFilter: DimensionKey[], options?: GetMetricEnrichedSeriesDataOptions): Promise<GetMetricEnrichedSeriesDataResponse>;
842-
getMetricFeedback(id: string, options?: OperationOptions): Promise<GetFeedbackResponse>;
843843
getMetricSeriesData(metricId: string, startTime: Date | string, endTime: Date | string, seriesToFilter: DimensionKey[], options?: GetMetricSeriesDataOptions): Promise<GetMetricSeriesDataResponse>;
844-
listAlertsForAlertConfiguration(alertConfigId: string, startTime: Date | string, endTime: Date | string, timeMode: AlertQueryTimeMode, options?: ListAlertsOptions): PagedAsyncIterableIterator<AnomalyAlert, AlertsPageResponse>;
844+
listAlerts(alertConfigId: string, startTime: Date | string, endTime: Date | string, timeMode: AlertQueryTimeMode, options?: ListAlertsOptions): PagedAsyncIterableIterator<AnomalyAlert, AlertsPageResponse>;
845845
listAnomalies(alert: AnomalyAlert, options?: ListAnomaliesForAlertConfigurationOptions): PagedAsyncIterableIterator<DataPointAnomaly, AnomaliesPageResponse>;
846846
listAnomalies(detectionConfigId: string, startTime: Date | string, endTime: Date | string, options?: ListAnomaliesForDetectionConfigurationOptions): PagedAsyncIterableIterator<DataPointAnomaly, AnomaliesPageResponse>;
847-
listDimensionValuesForDetectionConfiguration(detectionConfigId: string, startTime: Date | string, endTime: Date | string, dimensionName: string, options?: ListDimensionValuesForDetectionConfigurationOptions): PagedAsyncIterableIterator<string, DimensionValuesPageResponse>;
847+
listDimensionValuesForDetectionConfig(detectionConfigId: string, startTime: Date | string, endTime: Date | string, dimensionName: string, options?: ListDimensionValuesForDetectionConfigOptions): PagedAsyncIterableIterator<string, DimensionValuesPageResponse>;
848+
listFeedback(metricId: string, options?: ListFeedbackOptions): PagedAsyncIterableIterator<MetricFeedbackUnion, MetricFeedbackPageResponse>;
848849
listIncidents(alert: AnomalyAlert, options?: ListIncidentsForAlertOptions): PagedAsyncIterableIterator<AnomalyIncident, IncidentsPageResponse>;
849850
listIncidents(detectionConfigId: string, startTime: Date | string, endTime: Date | string, options?: ListIncidentsForDetectionConfigurationOptions): PagedAsyncIterableIterator<AnomalyIncident, IncidentsPageResponse>;
850851
listMetricDimensionValues(metricId: string, dimensionName: string, options?: ListMetricDimensionValuesOptions): PagedAsyncIterableIterator<string, DimensionValuesPageResponse>;
851852
listMetricEnrichmentStatus(metricId: string, startTime: Date | string, endTime: Date | string, options?: ListMetricEnrichmentStatusOptions): PagedAsyncIterableIterator<EnrichmentStatus, MetricEnrichmentStatusPageResponse>;
852-
listMetricFeedbacks(metricId: string, options?: ListFeedbacksOptions): PagedAsyncIterableIterator<MetricFeedbackUnion, MetricFeedbackPageResponse>;
853853
listMetricSeriesDefinitions(metricId: string, activeSince: Date | string, options?: ListMetricSeriesDefinitionsOptions): PagedAsyncIterableIterator<MetricSeriesDefinition, MetricSeriesPageResponse>;
854854
}
855855

sdk/metricsadvisor/ai-metrics-advisor/samples/javascript/alertingConfig.js

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ async function createAlertConfig(adminClient, detectionConfigId) {
6767
hookIds: [],
6868
description: "alerting config description"
6969
};
70-
const result = await adminClient.createAnomalyAlertConfiguration(alertConfig);
70+
const result = await adminClient.createAlertConfig(alertConfig);
7171
console.log(result);
7272
return result;
7373
}
@@ -96,19 +96,19 @@ async function updateAlertConfig(adminClient, alertConfigId, detectionConfigId,
9696
]
9797
};
9898
console.log(`Updating alerting configuration ${detectionConfigId}`);
99-
const updated = await adminClient.updateAnomalyAlertConfiguration(alertConfigId, patch);
99+
const updated = await adminClient.updateAlertConfig(alertConfigId, patch);
100100
return updated;
101101
}
102102

103103
async function deleteAlertConfig(adminClient, alertConfigId) {
104104
console.log(`Deleting alerting configuration ${alertConfigId}`);
105-
await adminClient.deleteAnomalyAlertConfiguration(alertConfigId);
105+
await adminClient.deleteAlertConfig(alertConfigId);
106106
}
107107

108108
async function listAlertingConfig(adminClient, detectdionConfigId) {
109109
console.log(`Listing alerting configurations for detection configuration ${detectdionConfigId}`);
110110
let i = 1;
111-
for await (const config of adminClient.listAnomalyAlertConfigurations(detectdionConfigId)) {
111+
for await (const config of adminClient.listAlertConfigs(detectdionConfigId)) {
112112
console.log(`Alert configuration ${i++}`);
113113
console.log(config);
114114
}

sdk/metricsadvisor/ai-metrics-advisor/samples/javascript/detectionConfig.js

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ async function main() {
4646

4747
async function getDetectionConfig(adminClient, detectionConfigId) {
4848
console.log("Retrieving an existing detection configuration...");
49-
const result = await adminClient.getMetricAnomalyDetectionConfiguration(detectionConfigId);
49+
const result = await adminClient.getDetectionConfig(detectionConfigId);
5050
console.log(result);
5151
return result;
5252
}
@@ -110,7 +110,7 @@ async function createDetectionConfig(adminClient, metricId) {
110110
seriesDetectionConditions
111111
};
112112
console.log("Creating a new anomaly detection configuration...");
113-
return await adminClient.createMetricAnomalyDetectionConfiguration(config);
113+
return await adminClient.createDetectionConfig(config);
114114
}
115115

116116
// updating an detection configuration
@@ -160,20 +160,20 @@ async function updateDetectionConfig(adminClient, configId) {
160160
};
161161

162162
console.log(`Updating existing detection configuration '${configId}'`);
163-
const result = await adminClient.updateMetricAnomalyDetectionConfiguration(configId, patch);
163+
const result = await adminClient.updateDetectionConfig(configId, patch);
164164
console.log(result);
165165
return result;
166166
}
167167

168168
async function deleteDetectionConfig(adminClient, detectionConfigId) {
169169
console.log(`Deleting detection configuration '${detectionConfigId}'`);
170-
await adminClient.deleteMetricAnomalyDetectionConfiguration(detectionConfigId);
170+
await adminClient.deleteDetectionConfig(detectionConfigId);
171171
}
172172

173173
async function listDetectionConfig(adminClient, metricId) {
174174
console.log(`Listing detection configurations for metric '${metricId}'...`);
175175
let i = 1;
176-
for await (const config of adminClient.listMetricAnomalyDetectionConfigurations(metricId)) {
176+
for await (const config of adminClient.listDetectionConfigs(metricId)) {
177177
console.log(` detection configuration ${i++}`);
178178
console.log(config);
179179
}

sdk/metricsadvisor/ai-metrics-advisor/samples/javascript/metricFeedback.js

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ async function provideAnomalyFeedback(client, metricId) {
3838
value: "NotAnomaly",
3939
dimensionKey: { city: "Manila", category: "Handmade" }
4040
};
41-
return await client.createMetricFeedback(anomalyFeedback);
41+
return await client.createFeedback(anomalyFeedback);
4242
}
4343

4444
async function providePeriodFeedback(client, metricId) {
@@ -50,7 +50,7 @@ async function providePeriodFeedback(client, metricId) {
5050
periodValue: 4,
5151
dimensionKey: { city: "Manila", category: "Handmade" }
5252
};
53-
return await client.createMetricFeedback(periodFeedback);
53+
return await client.createFeedback(periodFeedback);
5454
}
5555

5656
async function provideChangePointFeedback(client, metricId) {
@@ -62,7 +62,7 @@ async function provideChangePointFeedback(client, metricId) {
6262
value: "ChangePoint",
6363
dimensionKey: { city: "Manila", category: "Handmade" }
6464
};
65-
return await client.createMetricFeedback(changePointFeedback);
65+
return await client.createFeedback(changePointFeedback);
6666
}
6767

6868
async function provideCommentFeedback(client, metricId) {
@@ -73,19 +73,19 @@ async function provideCommentFeedback(client, metricId) {
7373
dimensionKey: { city: "Manila", category: "Handmade" },
7474
comment: "This is a comment"
7575
};
76-
return await client.createMetricFeedback(commendFeedback);
76+
return await client.createFeedback(commendFeedback);
7777
}
7878

7979
async function getFeedback(client, feedbackId) {
8080
console.log(`Retrieving feedback with id '${feedbackId}'...`);
81-
const feedback = await client.getMetricFeedback(feedbackId);
81+
const feedback = await client.getFeedback(feedbackId);
8282
console.log(feedback);
8383
}
8484

8585
async function listFeedback(client, metricId, startTime, endTime) {
8686
console.log("Listing feedbacks...");
8787
console.log(" using for-await-of syntax");
88-
for await (const feedback of client.listMetricFeedbacks(metricId, {
88+
for await (const feedback of client.listFeedback(metricId, {
8989
filter: {
9090
startTime: new Date("08/01/2020"),
9191
endTime: new Date("08/03/2020"),
@@ -111,7 +111,7 @@ async function listFeedback(client, metricId, startTime, endTime) {
111111

112112
console.log(" first two pages using iterator");
113113
const iterator = client
114-
.listMetricFeedbacks(metricId, {
114+
.listFeedback(metricId, {
115115
filter: {
116116
timeMode: "FeedbackCreatedTime"
117117
}

sdk/metricsadvisor/ai-metrics-advisor/samples/javascript/quickstart.js

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -162,7 +162,7 @@ async function configureAnomalyDetectionConfiguration(adminClient, metricId) {
162162
},
163163
description: "Detection configuration description"
164164
};
165-
return await adminClient.createMetricAnomalyDetectionConfiguration(dataFeed);
165+
return await adminClient.createDetectionConfig(dataFeed);
166166
}
167167

168168
async function createWebhookHook(adminClient) {
@@ -210,15 +210,15 @@ async function configureAlertConfiguration(adminClient, detectionConfigId, hookI
210210
hookIds,
211211
description: "Alerting config description"
212212
};
213-
return await adminClient.createAnomalyAlertConfiguration(anomalyAlert);
213+
return await adminClient.createAlertConfig(anomalyAlert);
214214
}
215215

216216
async function queryAlerts(client, alertConfigId, startTime, endTime) {
217217
console.log(`Listing alerts for alert configuration '${alertConfigId}'`);
218218
// This shows how to use `for-await-of` syntax to list alerts
219219
console.log(" using for-await-of syntax");
220220
let alerts = [];
221-
for await (const alert of client.listAlertsForAlertConfiguration(
221+
for await (const alert of client.listAlerts(
222222
alertConfigId,
223223
startTime,
224224
endTime,
@@ -233,7 +233,7 @@ async function queryAlerts(client, alertConfigId, startTime, endTime) {
233233
// alternatively we could list results by pages
234234
console.log(` by pages`);
235235
const iterator = client
236-
.listAlertsForAlertConfiguration(alertConfigId, startTime, endTime, "AnomalyTime")
236+
.listAlerts(alertConfigId, startTime, endTime, "AnomalyTime")
237237
.byPage({ maxPageSize: 2 });
238238

239239
let result = await iterator.next();

0 commit comments

Comments
 (0)