Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions Commands/monitor/readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,5 +43,8 @@ Manage the Azure Monitor Service.
- [private-link-scope](/Commands/monitor/private-link-scope/readme.md)
: Manage monitor private link scope resource.

- [sli](/Commands/monitor/sli/readme.md)
: Manage Service Level Indicators (SLIs) in Azure Monitor.

- [tenant-action-group](/Commands/monitor/tenant-action-group/readme.md)
: monitor tenant-action-group
16 changes: 16 additions & 0 deletions Commands/monitor/sli/_create.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# [Command] _monitor sli create_

Create an SLI resource.

## Versions

### [2025-03-01-preview](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQubWFuYWdlbWVudC9zZXJ2aWNlZ3JvdXBzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQubW9uaXRvci9zbGlzL3t9/2025-03-01-preview.xml) **Stable**

<!-- mgmt-plane /providers/microsoft.management/servicegroups/{}/providers/microsoft.monitor/slis/{} 2025-03-01-preview -->

#### examples

- CreateSli
```bash
monitor sli create --service-group-name testSG --sli-name testSli --description Measures the performance characteristics of the GetContosoUsers() API. --category Latency --evaluation-type WindowBased --enable-alert True --destination-amw-accounts "[{resource-id:/subscriptions/<subId>/resourcegroups/<rgId>/providers/microsoft.monitor/accounts/<dest>,identity:/subscriptions/<subId>/resourcegroups/<rgId>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<idName>}]" --baseline-properties "{baseline:{value:99,evaluation-period-days:30,evaluation-calculation-type:CalendarDays}}" --sli-properties "{window-uptime-criteria:{target:95,comparator:gte},signals:{signalSources:[{signalSourceId:A,sourceAmwAccountManagedIdentity:/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity,sourceAmwAccountResourceId:/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/microsoft.monitor/accounts/myAccount,metricNamespace:ContosoMetricsWest,metricName:Stamp1Latency,filters:[{dimensionName:ApiName,operator:eq,value:GetContosoUsers}],spatialAggregation:{type:Average,dimensions:[Region,ResponseCode]},temporalAggregation:{type:Average,windowSizeMinutes:5}},{signalSourceId:B,sourceAmwAccountManagedIdentity:/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity,sourceAmwAccountResourceId:/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/microsoft.monitor/accounts/myAccount,metricNamespace:ContosoMetricsEast,metricName:Stamp2Latency,filters:[{dimensionName:ApiName,operator:eq,value:GetContosoUsers}],spatialAggregation:{type:Average,dimensions:[Region,ResponseCode]},temporalAggregation:{type:Average,windowSizeMinutes:5}}],signalFormula:'(A + B) /2'}}"
```
16 changes: 16 additions & 0 deletions Commands/monitor/sli/_delete.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# [Command] _monitor sli delete_

Delete an SLI resource.

## Versions

### [2025-03-01-preview](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQubWFuYWdlbWVudC9zZXJ2aWNlZ3JvdXBzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQubW9uaXRvci9zbGlzL3t9/2025-03-01-preview.xml) **Stable**

<!-- mgmt-plane /providers/microsoft.management/servicegroups/{}/providers/microsoft.monitor/slis/{} 2025-03-01-preview -->

#### examples

- DeleteSli
```bash
monitor sli delete --service-group-name testSG --sli-name testSli
```
16 changes: 16 additions & 0 deletions Commands/monitor/sli/_list.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# [Command] _monitor sli list_

List all SLI resources under a parent resource.

## Versions

### [2025-03-01-preview](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQubWFuYWdlbWVudC9zZXJ2aWNlZ3JvdXBzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQubW9uaXRvci9zbGlz/2025-03-01-preview.xml) **Stable**

<!-- mgmt-plane /providers/microsoft.management/servicegroups/{}/providers/microsoft.monitor/slis 2025-03-01-preview -->

#### examples

- SlisListByParent
```bash
monitor sli list --service-group-name testSG
```
16 changes: 16 additions & 0 deletions Commands/monitor/sli/_show.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# [Command] _monitor sli show_

Get an SLI resource.

## Versions

### [2025-03-01-preview](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQubWFuYWdlbWVudC9zZXJ2aWNlZ3JvdXBzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQubW9uaXRvci9zbGlzL3t9/2025-03-01-preview.xml) **Stable**

<!-- mgmt-plane /providers/microsoft.management/servicegroups/{}/providers/microsoft.monitor/slis/{} 2025-03-01-preview -->

#### examples

- GetSli
```bash
monitor sli show --service-group-name testSG --sli-name testSli
```
16 changes: 16 additions & 0 deletions Commands/monitor/sli/_update.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# [Command] _monitor sli update_

Update an SLI resource.

## Versions

### [2025-03-01-preview](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQubWFuYWdlbWVudC9zZXJ2aWNlZ3JvdXBzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQubW9uaXRvci9zbGlzL3t9/2025-03-01-preview.xml) **Stable**

<!-- mgmt-plane /providers/microsoft.management/servicegroups/{}/providers/microsoft.monitor/slis/{} 2025-03-01-preview -->

#### examples

- CreateSli
```bash
monitor sli update --service-group-name testSG --sli-name testSli
```
22 changes: 22 additions & 0 deletions Commands/monitor/sli/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# [Group] _monitor sli_

Manage Service Level Indicators (SLIs) in Azure Monitor.

Only user-assigned managed identities (UAMIs) are supported. System-assigned identity is not supported by the SLI service. The service requires the same set of UAMIs to be referenced consistently in three places (`identity.userAssignedIdentities`, every `destinationAmwAccounts[].identity`, and every signal source's `sourceAmwAccountManagedIdentity`); they must be updated together in a single `az monitor sli update` invocation using `--set/--add/--remove`. See `az monitor sli --help` for the rotation recipe.

## Commands

- [create](/Commands/monitor/sli/_create.md)
: Create an SLI resource.

- [delete](/Commands/monitor/sli/_delete.md)
: Delete an SLI resource.

- [list](/Commands/monitor/sli/_list.md)
: List all SLI resources under a parent resource.

- [show](/Commands/monitor/sli/_show.md)
: Get an SLI resource.

- [update](/Commands/monitor/sli/_update.md)
: Update an SLI resource.
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
{"plane": "mgmt-plane", "resources": [{"id": "/providers/microsoft.management/servicegroups/{}/providers/microsoft.monitor/slis", "version": "2025-03-01-preview", "swagger": "mgmt-plane/monitoringservice/ResourceProviders/Microsoft.Monitor/Paths/L3Byb3ZpZGVycy9NaWNyb3NvZnQuTWFuYWdlbWVudC9zZXJ2aWNlR3JvdXBzL3tzZXJ2aWNlR3JvdXBOYW1lfS9wcm92aWRlcnMvTWljcm9zb2Z0Lk1vbml0b3Ivc2xpcw==/V/MjAyNS0wMy0wMS1wcmV2aWV3"}], "commandGroups": [{"name": "monitor sli", "commands": [{"name": "list", "version": "2025-03-01-preview", "resources": [{"id": "/providers/microsoft.management/servicegroups/{}/providers/microsoft.monitor/slis", "version": "2025-03-01-preview", "swagger": "mgmt-plane/monitoringservice/ResourceProviders/Microsoft.Monitor/Paths/L3Byb3ZpZGVycy9NaWNyb3NvZnQuTWFuYWdlbWVudC9zZXJ2aWNlR3JvdXBzL3tzZXJ2aWNlR3JvdXBOYW1lfS9wcm92aWRlcnMvTWljcm9zb2Z0Lk1vbml0b3Ivc2xpcw==/V/MjAyNS0wMy0wMS1wcmV2aWV3"}], "argGroups": [{"name": "", "args": [{"type": "string", "var": "$Path.serviceGroupName", "options": ["service-group-name"], "required": true, "help": {"short": "The name of the service group."}, "format": {"pattern": "^[A-Za-z0-9._()~-]{1,250}$"}}]}], "operations": [{"operationId": "Slis_ListByParent", "http": {"path": "/providers/Microsoft.Management/serviceGroups/{serviceGroupName}/providers/Microsoft.Monitor/slis", "request": {"method": "get", "path": {"params": [{"type": "string", "name": "serviceGroupName", "arg": "$Path.serviceGroupName", "required": true, "format": {"pattern": "^[A-Za-z0-9._()~-]{1,250}$"}}]}, "query": {"consts": [{"readOnly": true, "const": true, "default": {"value": "2025-03-01-preview"}, "type": "string", "name": "api-version", "required": true, "format": {"minLength": 1}}]}}, "responses": [{"statusCode": [200], "body": {"json": {"var": "$Instance", "schema": {"type": "object", "props": [{"type": "string", "name": "nextLink"}, {"type": "array<object>", "name": "value", "required": true, "item": {"type": "object", "props": [{"readOnly": true, "type": "ResourceId", "name": "id", "format": {"template": "/providers/Microsoft.Management/serviceGroups/{}/providers/Microsoft.Monitor/slis/{}"}}, {"type": "IdentityObject", "name": "identity", "props": [{"readOnly": true, "type": "uuid", "name": "principalId"}, {"readOnly": true, "type": "uuid", "name": "tenantId"}, {"type": "string", "name": "type", "required": true, "enum": {"items": [{"value": "None"}, {"value": "SystemAssigned"}, {"value": "SystemAssigned,UserAssigned"}, {"value": "UserAssigned"}]}}, {"type": "object", "name": "userAssignedIdentities", "additionalProps": {"item": {"nullable": true, "type": "object", "props": [{"readOnly": true, "type": "uuid", "name": "clientId"}, {"readOnly": true, "type": "uuid", "name": "principalId"}]}}}]}, {"readOnly": true, "type": "string", "name": "name"}, {"type": "object", "name": "properties", "props": [{"type": "object", "name": "baselineProperties", "required": true, "props": [{"type": "object", "name": "baseline", "required": true, "props": [{"type": "string", "name": "evaluationCalculationType", "required": true, "enum": {"items": [{"value": "CalendarDays"}, {"value": "RollingDays"}]}}, {"type": "integer32", "name": "evaluationPeriodDays", "required": true, "format": {"maximum": 90, "minimum": 1}}, {"type": "float32", "name": "value", "required": true, "format": {"maximum": 100.0, "minimum": 0}}]}]}, {"type": "string", "name": "category", "required": true, "enum": {"items": [{"value": "Availability"}, {"value": "Latency"}]}}, {"type": "string", "name": "description", "required": true, "format": {"pattern": "^[\\s\\S]{0,1000}$"}}, {"type": "array<object>", "name": "destinationAmwAccounts", "required": true, "item": {"type": "object", "props": [{"type": "ResourceId", "name": "identity", "required": true}, {"type": "ResourceId", "name": "resourceId", "required": true}]}, "identifiers": ["resourceId"]}, {"readOnly": true, "type": "array<object>", "name": "destinationMetrics", "item": {"type": "object", "props": [{"type": "string", "name": "metricName", "required": true}, {"type": "string", "name": "metricNamespace", "required": true}]}, "identifiers": ["metricName", "metricNamespace"]}, {"type": "boolean", "name": "enableAlert", "required": true}, {"type": "string", "name": "evaluationType", "required": true, "enum": {"items": [{"value": "RequestBased"}, {"value": "WindowBased"}]}}, {"readOnly": true, "type": "object", "name": "executionState", "props": [{"type": "string", "name": "message"}, {"type": "string", "name": "state", "required": true}]}, {"readOnly": true, "type": "string", "name": "provisioningState", "enum": {"items": [{"value": "Canceled"}, {"value": "Failed"}, {"value": "Succeeded"}]}}, {"type": "object", "name": "sliProperties", "required": true, "props": [{"type": "object", "name": "goodSignals", "props": [{"type": "string", "name": "signalFormula", "required": true}, {"type": "array<object>", "name": "signalSources", "required": true, "item": {"type": "object", "props": [{"type": "array<object>", "name": "filters", "required": true, "item": {"type": "object", "props": [{"type": "string", "name": "dimensionName"}, {"type": "string", "name": "operator", "required": true, "enum": {"items": [{"value": "contains"}, {"value": "eq"}, {"value": "gt"}, {"value": "gte"}, {"value": "in"}, {"value": "lt"}, {"value": "lte"}, {"value": "ne"}, {"value": "notcontains"}, {"value": "notin"}, {"value": "notstartswith"}, {"value": "startswith"}]}}, {"type": "string", "name": "samplingType", "enum": {"items": [{"value": "Average"}, {"value": "Count"}, {"value": "Max"}, {"value": "Min"}, {"value": "Sum"}]}}, {"type": "string", "name": "scalarFunction", "enum": {"items": [{"value": "avg"}, {"value": "max"}, {"value": "min"}, {"value": "sum"}]}}, {"type": "string", "name": "value", "required": true}]}, "identifiers": ["value", "operator", "samplingType", "dimensionName", "scalarFunction"]}, {"type": "string", "name": "metricName", "required": true}, {"type": "string", "name": "metricNamespace", "required": true}, {"type": "string", "name": "signalSourceId", "required": true}, {"type": "ResourceId", "name": "sourceAmwAccountManagedIdentity", "required": true}, {"type": "ResourceId", "name": "sourceAmwAccountResourceId", "required": true}, {"type": "object", "name": "spatialAggregation", "required": true, "props": [{"type": "array<string>", "name": "dimensions", "required": true, "item": {"type": "string"}}, {"type": "string", "name": "type", "required": true, "enum": {"items": [{"value": "Average"}, {"value": "Count"}, {"value": "Max"}, {"value": "Min"}, {"value": "Sum"}]}}]}, {"type": "object", "name": "temporalAggregation", "required": true, "props": [{"type": "string", "name": "type", "required": true, "enum": {"items": [{"value": "Average"}, {"value": "Delta"}, {"value": "IDelta"}, {"value": "IRate"}, {"value": "Increase"}, {"value": "Max"}, {"value": "Min"}, {"value": "Rate"}, {"value": "Sum"}]}}, {"type": "integer32", "name": "windowSizeMinutes"}]}]}, "identifiers": ["signalSourceId"]}], "cls": "Signal_read"}, {"type": "@Signal_read", "name": "signals"}, {"type": "@Signal_read", "name": "totalSignals"}, {"type": "object", "name": "windowUptimeCriteria", "props": [{"type": "string", "name": "comparator", "required": true, "enum": {"items": [{"value": "gt"}, {"value": "gte"}, {"value": "lt"}, {"value": "lte"}]}}, {"type": "float32", "name": "target", "required": true}]}]}, {"readOnly": true, "type": "string", "name": "streamingRuleId"}, {"readOnly": true, "type": "dateTime", "name": "streamingRuleLastUpdatedTimestamp", "format": {"protocol": "iso"}}]}, {"readOnly": true, "type": "object", "name": "systemData", "props": [{"type": "dateTime", "name": "createdAt", "format": {"protocol": "iso"}}, {"type": "string", "name": "createdBy"}, {"type": "string", "name": "createdByType", "enum": {"items": [{"value": "Application"}, {"value": "Key"}, {"value": "ManagedIdentity"}, {"value": "User"}]}}, {"type": "dateTime", "name": "lastModifiedAt", "format": {"protocol": "iso"}}, {"type": "string", "name": "lastModifiedBy"}, {"type": "string", "name": "lastModifiedByType", "enum": {"items": [{"value": "Application"}, {"value": "Key"}, {"value": "ManagedIdentity"}, {"value": "User"}]}}]}, {"readOnly": true, "type": "string", "name": "type"}]}}]}}}}, {"isError": true, "body": {"json": {"schema": {"type": "@MgmtErrorFormat"}}}}]}}], "outputs": [{"type": "array", "ref": "$Instance.value", "clientFlatten": true, "nextLink": "$Instance.nextLink"}]}]}]}
Loading
Loading