IB Publication Contracts Stalled

IB Publication Contracts Stalled Alert

Alert ID: ib_pub_contract_stalled Category: Integration Broker Default threshold: 30 minutes

What This Alert Detects

This alert finds Integration Broker publication contracts that are stuck in New or Working status and have not progressed beyond that state within the configured threshold.

A stalled publication contract means PeopleSoft has published a message to a subscriber, but the delivery has not completed. The message is either waiting to be picked up (New) or is in the process of being delivered but taking too long (Working).

When This Matters

Check IB Nodes Down and IB Dispatcher Down first. A stalled pub contract is usually one of those two conditions.

Severity Logic

Condition	Severity
Stuck longer than `thresholdMinutes`	Warning
Stuck longer than `thresholdMinutes × 2`	Critical

Alert Details

Each alert item includes:

Publication contract ID
Service operation name
Current status (New or Working)
How long it has been stuck (in minutes)
The target subscribing node
A link to the IB Monitor detail page

Configuration

alerts:
  checks:
    ib_pub_contract_stalled:
      enabled: true
      thresholdMinutes: 30       # Minutes before flagging as Warning
      excludeOperations:         # Operation names to skip
        - LARGE_BATCH_SYNC

Setting	Default	Description
`thresholdMinutes`	`30`	Minutes a contract must be stuck to trigger a Warning. Critical fires at 2× this value.
`excludeOperations`	`[]`	List of IB operation names to exclude. Use for operations that legitimately take a long time.

How to Respond

Click the alert link to go to the IB Monitor entry for the stalled contract
Check whether the IB dispatchers are running on the PeopleSoft application server
Look for a larger backlog (many contracts in New status may mean the dispatcher is down)
Check whether the target node’s endpoint is reachable
Review connector configuration for the target node

Relationship to Other IB Alerts

For pub contracts that have already ended in error, see IB Publication Contract Errors.

For similar stalled alerts on operations and subscription contracts: