Skip to content

Commit f509c08

Browse files
authored
Merge pull request #246141 from t-vnamani/patch-1
Update event-overview.md
2 parents 07f2183 + 9ec878a commit f509c08

File tree

1 file changed

+36
-7
lines changed

1 file changed

+36
-7
lines changed

articles/governance/policy/concepts/event-overview.md

Lines changed: 36 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -16,23 +16,52 @@ pushed through [Azure Event Grid](../../../event-grid/index.yml) to subscribers
1616
Critically, you only pay for what you use.
1717

1818
Azure Policy events are sent to the Azure Event Grid, which provides reliable delivery services to
19-
your applications through rich retry policies and dead-letter delivery. To learn more, see
20-
[Event Grid message delivery and retry](../../../event-grid/delivery-and-retry.md).
21-
22-
The common Azure Policy event scenario is tracking when the compliance state of a resource changes
23-
during policy evaluation. Event-based architecture is an efficient way to react to these changes
24-
instead of scanning the compliance state of resources on a fixed schedule.
19+
your applications through rich retry policies and dead-letter delivery. Event Grid takes
20+
care of the proper routing, filtering, and multicasting of the events to destinations via Event Grid subscriptions.
21+
To learn more, see [Event Grid message delivery and retry](../../../event-grid/delivery-and-retry.md).
2522

2623
> [!NOTE]
2724
> Azure Policy state change events are sent to Event Grid after an
2825
> [evaluation trigger](../how-to/get-compliance-data.md#evaluation-triggers) finishes resource
2926
> evaluation.
3027
28+
## Event Grid Benefits
29+
Event Grid has a few benefits for customers and services in the Azure ecosystem:
30+
- Automation: To stay current with your policy environment, Event Grid offers an automated mechanism to generate
31+
alerts and trigger tasks depending on compliance states.
32+
- Durable delivery: In order for services and user applications to respond in real-time to policy compliance events,
33+
Event Grid seeks to offer policy events with minimum latency. Event Grid retries transmission of an event if a subscriber's
34+
endpoint fails to acknowledge receipt of it or if it doesn't, according to a predetermined retry schedule and retry policy.
35+
- Custom event producer: Event Grid event producers and consumers don't need to be Azure or Microsoft services.
36+
External applications can receive an alert, show the creation of a remediation task or collect messages on who responds to the
37+
state change.
3138
See
3239
[Route policy state change events to Event Grid with Azure CLI](../tutorials/route-state-change-events.md)
3340
for a full tutorial.
3441

35-
:::image type="content" source="../../../event-grid/media/overview/functional-model.png" alt-text="Event Grid model of sources and handlers" lightbox="../../../event-grid/media/overview/functional-model-big.png":::
42+
There are two primary entities when using Event Grid:
43+
- Events: These events can be anything a user may want to react to that includes if a policy compliance state is
44+
created, changed, and deleted of a resource such as a VM or storage accounts.
45+
- Event Grid Subscriptions: These event subscriptions are user configured entities that direct the proper set of events
46+
from a publisher to a subscriber. Event subscriptions can filter events based on the resource path the event
47+
originated from and the type of event. Additionally, Event Subscriptions can also filter by scope between
48+
Azure subscription and Management group.
49+
50+
A common Azure Policy event scenario is tracking when the compliance state of a resource changes
51+
during policy evaluation. Event-based architecture is an efficient way to react to these changes
52+
and aids in the event based reaction to compliance state changes.
53+
54+
Another scenario is to automatically trigger remediation tasks without manually ticking off _create
55+
remediation task_ on the policy page. Event Grid checks for compliance state and resources that are currently
56+
noncompliant can be remedied. Learn more about [remediation structure](../concepts/remediation-structure.md).
57+
Remediation requires a managed identity and policies must be in Modify or DeployIfNotExists effect. [Learn more about
58+
effect types](../how-to/remediate-resources.md).
59+
60+
Additionally, Event Grid is helpful as an audit system to store state changes and understand cause of noncompliance over
61+
time. The scenarios for Event Grid are endless and based on the motivation, Event Grid is configurable.
62+
63+
64+
:::image type="content" source="../../../event-grid/media/overview/functional-model.png" alt-text="Screenshot of Event Grid model of sources and handlers." lightbox="../../../event-grid/media/overview/functional-model-big.png":::
3665

3766
[!INCLUDE [policy-events.md](../../../../includes/policy/policy-events.md)]
3867

0 commit comments

Comments
 (0)