IB Publication Contract Errors

Tailored Operational Context
  • Target Database:
  • Context Type:
  • Alert Severity:
  • Triggered Time:
  • Firing Context:

IB Publication Contract Errors Alert

Alert ID: ib_pub_contract_errors Category: Integration Broker Default lookback: 24 hours

What This Alert Detects

This alert finds Integration Broker publication contracts that are in Error or Timeout status within a configurable lookback window.

In the PeopleSoft Integration Broker architecture, a publication contract tracks the delivery of a published message to a specific subscribing node. When a publication contract fails, it means a message that PeopleSoft published was not successfully delivered to one or more subscribers.

When This Matters

Publication contract errors typically mean:

  • An outbound message from PeopleSoft was not delivered to a downstream system
  • An integration partner did not receive data it was expecting
  • A workflow or data sync that depends on this message may be incomplete

Severity Logic

StatusSeverity
ErrorCritical
TimeoutWarning

Alert Details

Each alert item includes:

  • Publication contract ID
  • Service operation name
  • Status (Error or Timeout)
  • The target subscribing node
  • When the contract was created
  • A link to the IB Monitor detail page

Configuration

alerts:
  checks:
    ib_pub_contract_errors:
      enabled: true
      lookbackHours: 24          # How far back to look for errors
      excludeOperations:         # Operation names to skip
        - HIGH_VOLUME_SYNC
SettingDefaultDescription
lookbackHours24Number of hours back to search for error/timeout contracts
excludeOperations[]List of IB operation names to exclude from this check

How to Respond

  1. Click the alert link to go to the IB Monitor entry for the failed contract
  2. Review the error details. The IB Monitor shows the error message
  3. Check whether the target subscribing node is reachable and its connector is configured correctly
  4. Review the node’s authentication settings (see the Nodes with No Password report if auth may be the issue)
  5. If the message can be safely reprocessed, resubmit from PeopleSoft’s Publication Contracts Monitor

Relationship to Other IB Alerts

For pub contracts stuck in progress, see IB Publication Contracts Stalled.

For similar alerts on async operations and subscription contracts: