Skip to content

Commit 3ba2ca3

Browse files
committed
Various updates
1 parent 44b581c commit 3ba2ca3

File tree

10 files changed

+81
-14
lines changed

10 files changed

+81
-14
lines changed

articles/azure-monitor/health-models/create-model.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,6 +127,22 @@ The list of available metrics for the selected resource type are getting populat
127127

128128
:::image type="content" source="./media/health-model-create-modify-with-designer/edit-metric-signal-dialog.png" lightbox="./media/health-model-create-modify-with-designer/edit-metric-signal-dialog.png" alt-text="Screenshot of the Edit metric signal dialog in the Azure portal.":::
129129

130+
## Edit log signals
131+
Before you can add a log signal to an entity, you connect it to a Log Analytics workspace. For an Azure resource entity, click **select a workspace**in the **Log Signals** section of the **Signals** tab. For an aggregate entity, click **Log Analytics signals** in the **General** tab.
132+
133+
| Setting | Description |
134+
|:---|:---|
135+
| Name | Name of the signal as it appears in the health model. |
136+
| Query text | The text of the log query to run. Click **Edit query** to create a new query or edit an existing one. Log Analytics interface is displayed where you can write queries and test the results. |
137+
| Query time range | The frequency that the query is run. The query will only retrieve data from this time range. The value is set in the query editor when you edit the query. It is only displayed here. |
138+
| Value column name | The name of the column returned from the query that contains the value to compare to the thresholds. |
139+
| Unit | Label for the units of the value returned from the query. This doesn't affect the results but only how the value is displayed. |
140+
| Data type | The data type of the value returned from the query, either **Numeric** or **Text**. If numeric, then only numeric comparisons are avilable in the threshold. If text, then a particular string of text can be used for the threshold. |
141+
| Enabled | Determines whether the signal is used to calculate the health state of the entity. |
142+
| Degraded threshold | If this calculation is true, and the Unhealthy calculation is false, then the state of the entity is set to **Degraded**. If both this and the Unhealthy calculation are false, then the health of the entity is set to **Healthy**. |
143+
| Unhealthy threshold | If this calculation is true, then the state of the entity is set to **Unhealthy**. If this calculation is false, then the **Degraded** threshold is checked. |
144+
145+
130146
### Create Alert rule
131147

132148
After clicking the **Create alert rule for health of this entity**, the Azure Alert rule creation wizard appears. The default **Signal name** is set to **Health score per node**, and health status is quantified numerically as follows: `100` for healthy, `50` for degraded, and `0` for unhealthy.

articles/azure-monitor/health-models/health-state.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -22,13 +22,14 @@ The health state is updated regularly, so you can always view an up-to-date heal
2222
| Unhealthy | The entity is not working but or is working with unacceptable performance. Counts as downtime for service level. |
2323

2424
## Signals
25-
The health of an entity is determined by one or more signals. A signal is a metric or log query that is evaluated on a schedule. The result of the signal is compared to a threshold to determine the health state of the entity.
25+
The health of an entity is determined by one or more signals. A signal is a metric or log query that is evaluated on a schedule. The result of the signal is compared to a threshold to determine the health state of the entity. You can automatically enable a set of recommended signals for many resource types, and you can also create your own custom signals.
26+
27+
The health state may also be affected by any children entities depending on their impact setting. If there are multiple signals affecting an entity's health, the worst case will be used. For example, if a an entity has two signals, one that is degraded and one that is unhealthy, the entity will be unhealthy.
28+
2629

2730

28-
## Impact
29-
*Impact* refers to how the health an entity impacts the health of its parents. The different impact settings are described in the following table.
3031

31-
### Impact
32+
## Impact
3233
The *impact* of an entity determines how its health state is propagated to its parent(s). Each entity in the health model has an impact setting that applies to any of the parent entities that entity is connected to. The following table describes the different impact settings.
3334

3435
| Option | Description |
@@ -41,4 +42,6 @@ The following sample shows the effect of each impact setting. Each of the child
4142

4243
This sample also shows the worst-case rollup of the parent health states to the root entity. Each of the parent entities are configured for standard impact meaning their health state will propagate to the root entity which is their parent. The root entity is in an unhealthy state because this is the worst case of the entities directly underneath it.
4344

44-
:::image type="content" source="media/health-state/health-impact.png" lightbox="media/health-state/health-impact.png" alt-text="Screenshot of an example health model showing different impact settings. ":::
45+
:::image type="content" source="media/health-state/health-impact.png" lightbox="media/health-state/health-impact.png" alt-text="Screenshot of an example health model showing different impact settings. ":::
46+
47+
## Next steps
11.7 KB
Loading

articles/azure-monitor/health-models/overview.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,4 +31,6 @@ Set a service level for the health model to define your commitment to your custo
3131

3232
:::image type="content" source="media/overview/sample-service-level.png" lightbox="media/overview/sample-service-level.png" alt-text="Screenshot of service level view for an example health model. ":::
3333

34-
## Next steps
34+
## Next steps
35+
36+
- [Create a health model](./create-model.md).
Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
title: Query health data in Azure Monitor health models
3+
description: Learn how to query health data in Azure Monitor health models.
4+
ms.topic: conceptual
5+
author: bwren
6+
ms.author: bwren
7+
ms.date: 12/12/2023
8+
---
9+
10+
# Query health data in Azure Monitor health models
11+
12+
13+
14+
## Next steps
15+

articles/azure-monitor/health-models/resource-manager-health-model.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ ms.date: 08/08/2023
1212

1313
This article includes sample [Azure Resource Manager templates](../../azure-resource-manager/templates/syntax.md) to create and define an [Azure Monitor health model](./overview.md) in Azure Monitor. Each sample includes a template file and a parameters file with sample values to provide to the template.
1414

15-
The `node` section of the JSON includes the definition of the health model. See [Code view in Azure Monitor health models](./code-view.md) for details on this definition. One method is to define the health model using the [designer view](./designer-view.md) and the copy and paste the definition from the code view.
15+
The `node` section of the JSON includes the definition of the health model. See [Code view in Azure Monitor health models](./create-model.md#designer-view) for details on this definition. One method is to define the health model using the [designer view](./designer-view.md) and the copy and paste the definition from the code view.
1616

1717
[!INCLUDE [azure-monitor-samples](../../../includes/azure-monitor-resource-manager-samples.md)]
1818

@@ -25,7 +25,7 @@ The `node` section of the JSON includes the definition of the health model. See
2525
"parameters": {
2626
"healthModelName": {
2727
"type": "string",
28-
"metadata": {
28+
"metadata": {3
2929
"description": "The name of the health model to create."
3030
}
3131
},
@@ -97,7 +97,8 @@ The `node` section of the JSON includes the definition of the health model. See
9797
"value": "eastus"
9898
}
9999
}
100-
}```
100+
}
101+
```
101102

102103
## Next steps
103104

articles/azure-monitor/health-models/views.md

Lines changed: 30 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,42 @@
11
---
2-
title: Query health data in Azure Monitor health models
2+
title: View state of Azure Monitor health model (preview)
33
description: Learn how to query health data in Azure Monitor health models.
44
ms.topic: conceptual
55
author: bwren
66
ms.author: bwren
77
ms.date: 12/12/2023
88
---
99

10-
# Query health data in Azure Monitor health models
10+
# View state of Azure Monitor health model (preview)
1111

12+
## Graph view
13+
The graph view shows the latest snapshot of a health model with its full structure displayed and the current state of each node. The **Generated** timestamp on the top right specifies when the snapshot was taken and the current refresh interval for the model.
14+
15+
:::image type="content" source="./media/health-model-snapshot-graph/health-model-resource-graph-view-pane.png" lightbox="./media/health-model-snapshot-graph/health-model-resource-graph-view-pane.png" alt-text="Screenshot of a health model resource in the Azure portal with the Graph pane selected.":::
16+
17+
## Entity details
18+
19+
Hover over an entity view its type and current health state. Click on an entity to view its detail.
20+
When you click on an entity, you can see more detail like its health state history.
21+
22+
:::image type="content" source="./media/health-model-snapshot-graph/graph-tab-entity-detail.png" lightbox="./media/health-model-snapshot-graph/graph-tab-entity-detail.png" alt-text="Screenshot of the Entity detail dialog for a health model resource in the Azure portal.":::
23+
24+
| Section | |
25+
|:---|:---|
26+
| Entity health history | Graphical history of the health of this entity over time. Click the time range to specify another time range. The time grain is set automatically based on the length of the time range. |
27+
| Metric signals | List of any metric signals for the entity and their last result and health state. Click on a metric to open it in metrics explorer for further analysis.<br>Only displayed for entities with metric signals.|
28+
| Log signals | List of any log signals for the entity and their last result and health state. <br>Only displayed for entities with log signals.|
29+
| Triggered alerts | Displays any active alerts for the entity from the last 24 hours. Azure resource will have a tab for **Health model** and **Azure resource** alerts. Aggregation entities will have a tab only for **Health model** alerts.|
30+
| Azure resource health | Current [Azure Resource health](../../service-health/overview.md) status of the entity. |
31+
| Azure resource health events | List of any [Azure Resource health](../../service-health/overview.md) events for the entity.
32+
33+
34+
### Snapshot history
35+
36+
Click **History** at the top of the graph view to see a history of snapshots for the health model. The history shows the time of the snapshot and the number of entities in the model at that time. Select a snapshot and click **Open snapshot** to view it in the graph view.
37+
38+
39+
## Timeline view
1240

1341

1442
## Next steps

articles/azure-monitor/toc.yml

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -59,10 +59,12 @@ items:
5959
href: health-models/nested-health-models.md
6060
- name: Analyze
6161
items:
62-
- name: Views
63-
href: health-models/views.md
64-
- name: Queries
62+
- name: Health state
63+
href: health-models/graph-view.md
64+
- name: Service levels
6565
href: health-models/service-levels.md
66+
- name: Query health state
67+
href: health-models/query-health.md
6668
- name: Troubleshoot
6769
items:
6870
- name: Troubleshoot health models

0 commit comments

Comments
 (0)