Integration Broker Down

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

Integration Broker Down Alert

Alert ID: ib_down Category: Integration Broker Default threshold: Immediate

What This Alert Detects

This alert fires when the SWS endpoint returns a connection error, timeout, 404, or 5xx. psLens cannot fetch IB data without SWS, so this also blocks every other psLens IB check. A connection failure indicates that the Integration Broker gateway, local node, or application server is down.

Severity Logic

ConditionSeverity
SWS connection attempt failsCritical

What Gets Checked

The alert invokes the standard SWS connection test method. If it receives any network connection error (e.g., HTTP gateway timeout, connection refused, dns resolving failure, or HTTP 404/500 errors), a Critical alert is raised immediately.

Alert Details

Each alert item includes:

  • The base REST URL of the SWS endpoint (baseURL)
  • The raw network or connection error message
  • Troubleshooting links to verify connection settings

Configuration

alerts:
  checks:
    ib_down:
      enabled: true
SettingDefaultDescription
enabledtrueWhether this check is active.

How to Respond

  1. Verify that the PeopleSoft Web Server and PIA are up and running.
  2. Check the Integration Gateway web application status (typically /PSIGW/PeopleSoftListeningConnector).
  3. Ensure that the application server domain is booted and the Integration Broker handlers/dispatchers are active.
  4. Verify there are no firewalls, proxies, or security policies blocking outbound HTTPS traffic from the psLens server to the Integration Broker gateway port.
  5. Inspect the basic auth credentials in the config.yaml to ensure the API service user has not expired or been locked.