Live Objects - complete developer guide

Alarm event

Alarm events for account metrics monitoring are integrated with LiveObjects 'Message routing' capabilities.

Summary

Whenever Live Objects triggers an alarm related to account metrics monitoring, it generates an alarm event. This event is routed to the destination defined in the action policy. The alarm event is a JSON message that contains information about the alarm, such as its type, reason and timestamp.

Alarm event data model

Description of the alarm events that can be routed through LiveObjects.

Field	Description
type	alarmEvent. The type of the event. Set by Live Objects platform.
version	Version number. See the existing versions in the summary. Default value is 1.
alarmRule	Information regarding the alarm rule that triggered the event.
alarmRule.type	The type of the alarm rule that triggered the event. You can filter the alarm events by this field. supported types are: messageDeliverySuccessRatio, actionSuspended Supported alarms full description is available in account alarming.
monitoredResource	Information regarding the resource being monitored. The format of this field depends on the type of resource being monitored. For example, if the monitored resource is an action, the field will contain information about the action, such as its ID, name and parent action policy.
triggerDetails	Details about the trigger that caused the alarm event.

Field

Description

type

alarmEvent. The type of the event. Set by Live Objects platform.

version

Version number. See the existing versions in the summary. Default value is 1.

alarmRule

Information regarding the alarm rule that triggered the event.

alarmRule.type

The type of the alarm rule that triggered the event. You can filter the alarm events by this field. supported types are: messageDeliverySuccessRatio, actionSuspended Supported alarms full description is available in account alarming.

monitoredResource

Information regarding the resource being monitored. The format of this field depends on the type of resource being monitored. For example, if the monitored resource is an action, the field will contain information about the action, such as its ID, name and parent action policy.

triggerDetails

Details about the trigger that caused the alarm event.

alarm event example for "alarmRule.type" : "messageDeliverySuccessRatio"

Here is an example of an alarm event generated by the Live Objects platform when a "message delivery success ratio" alarm is triggered by a default alarm rule. The event contains information about the alarm rule, the monitored resource (an action), and the trigger details (the timestamp and value that caused the alarm to be triggered).

{
    "type": "alarmEvent",
    "version": 1,
    "alarmRule": {
        "id": "message-delivery-success-ratio-default",
        "type": "messageDeliverySuccessRatio",
        "name": "Delivered message degradation",
        "trigger": {
            "condition": {
                "comparisonOperator": "lessThanOrEqualTo",
                "threshold": 90.0,
                "evaluationWindow": "PT24H"
            }
        },
        "default": true
    },
    "monitoredResource": {
        "id": "http_push_action_id_with_alarm",
        "type": "action",
        "name": "HTTPPUSH",
        "parent": {
            "id": "action_policy_id_with_alarm",
            "type": "actionPolicy",
            "name": "my action policy"
        },
        "portalLink": "https://liveobjects.orange-business.com/#/redirect?id=A00Z%22%2C"
    },
    "triggerDetails": {
        "triggeredAt": "2026-06-25T10:00:00Z",
        "triggerValue": 90.0
    }
}

alarm event example for "alarmRule.type" : "actionSuspended"

Here is an example of an alarm event generated by the Live Objects platform when a action suspended alarm is triggered by a default alarm rule. The event contains information about the alarm rule, the monitored resource (an action), and the trigger details (the timestamp and value that caused the alarm to be triggered).

Note: The action suspended alarm is triggered automatically when an action is suspended due to a failure in its execution persisting for more than 7 days. See account alarming chapter.

{
    "tenantId": "f3062f39-f051-415a-ba35-48c0b6a03d48",
    "alarmRule": {
        "id": "6a3e7c2532a723ed77b5829d",
        "type": "actionSuspended",
        "name": "alarm_name",
        "default": true
    },
    "monitoredResource": {
        "id": "actionId",
        "type": "action",
        "name": "HTTPPUSH",
        "parent": {
            "id": "actionPolicyId",
            "type": "actionPolicy",
            "name": "my action policy"
        },
        "portalLink": "https://liveobjects.orange-business.com/#/redirect?id=A00Z%22%2C"
    },
    "triggerDetails": {
        "triggeredAt": "2026-06-26T13:18:29.647Z",
        "triggerReason": "Failure rate > 90% for more than 7 consecutive days"
    }
}