OBLYTECH Logo
OBLYTECH Logo
ServiceNow Event Management Integration Patterns

ServiceNow Event Management Integration Patterns

Common Integration Patterns

Inbound Pattern (Monitoring to ServiceNow): monitoring tools (Splunk, Datadog, Prometheus, Nagios) send events to ServiceNow Event Management. ServiceNow receives alerts, deduplicates them, groups related events, and creates incidents. This is the most common pattern.

Outbound Pattern (ServiceNow to Monitoring): when an incident is resolved in ServiceNow, send a signal to monitoring systems to clear alerts or update dashboards. This keeps monitoring tools in sync with incident resolution.

Bidirectional Pattern: events flow both directions. Monitoring alerts trigger incidents in ServiceNow. When an incident is resolved, the notification goes back to monitoring to clear the alert. This keeps both systems synchronized.

Inbound Versus Outbound: Choosing Between Approaches

Inbound only: good if you want ServiceNow to be the central incident hub. All alerts land in ServiceNow; that is where incident handlers work. Monitoring systems feed data but do not consume it. This simplifies architecture: monitoring systems do not need to know about ServiceNow incident state.

Outbound only: less common. Useful if ServiceNow is purely a ticketing system and you want incident state to flow back to monitoring. Typically used alongside inbound integration.

Bidirectional: more complex but most powerful. Monitoring feeds events; ServiceNow feeds back incident resolution and context. Teams see unified view in either tool. Bidirectional requires careful conflict resolution: if monitoring and ServiceNow disagree on state, which one wins?

Event Integration Approaches

Direct Syslog or HTTP Integration: monitoring tool sends events directly to ServiceNow via HTTP REST API or Syslog protocol. Simplest approach. The monitoring tool connects directly to ServiceNow. Requires network connectivity from monitoring to ServiceNow and ServiceNow API credentials. Low latency, direct control over event format.

Event Gateway or Hub: third-party tool (Kafka, message queue) sits between monitoring and ServiceNow. Monitoring tools send to the gateway, the gateway routes to ServiceNow. Adds complexity but provides buffering (if ServiceNow is down, events wait in the queue) and flexibility (easy to send events to multiple tools).

Integration Platform (MCP or custom middleware): a ServiceNow integration plugin or custom middleware transforms events from different monitoring tools into a common format before sending to Event Management. Useful if you have many monitoring tools with different formats.

Error Handling and Reliability

What happens if the ServiceNow API is down? Events are lost unless the monitoring tool has a queue or retry mechanism. Design for this: use a monitoring tool that can buffer events, or use an integration platform with persistence. Test failover by simulating ServiceNow outage.

What if an event arrives malformed or incomplete? ServiceNow should either reject it with a clear error message or apply defaults for missing fields. Do not silently accept bad data. Log rejections so you can investigate why the monitoring tool is sending malformed events.

How do we handle duplicate events? The same alert from the monitoring tool might be sent twice due to retries. Event Management should deduplicate by event ID. If the event ID is missing or duplicated, use a combination of source, timestamp, and event type to identify duplicates.

Data Ownership and Responsibility

Who owns the event format and field mappings? If monitoring sends a “hostname” field but ServiceNow expects “ci_name,” someone has to define that mapping. Is this the monitoring team, the integration team, or ServiceNow admin? Define ownership before implementation.

If event data changes the incident state (e.g., resolved the incident because the alert cleared), who is responsible? The monitoring team should not unilaterally resolve incidents. Incidents should be resolved by humans (or by an automated workflow rule, not by event arrival). Define which events trigger state changes and which are information only.

Who is on the hook if event integration fails and incidents are not created? This is typically split: the monitoring team ensures alerts are sent, the integration team ensures data reaches ServiceNow, and ServiceNow admins ensure Event Management is configured correctly. Define escalation: if events stop arriving, who investigates?

Monitoring and Troubleshooting the Integration

How do we know the integration is working? Set up a synthetic test: send a test event from monitoring to ServiceNow and verify it arrives and creates an incident. Run this test hourly to catch failures early.

What metrics matter? Event latency (time from alert in monitoring to event in ServiceNow), event drop rate (events sent but not received), and deduplication accuracy (duplicates actually removed). Monitor these metrics and alert if they degrade.

How do we troubleshoot event arrival issues? Check network connectivity from monitoring to ServiceNow, verify API credentials are valid, review integration logs for errors, and manually test API connectivity (curl or Postman). Do this in staging first, then production.

Design Checklist

  • Choose integration pattern: inbound, outbound, or bidirectional.
  • Identify all monitoring tools that will send events.
  • Define event format and field mappings for each monitoring tool.
  • Plan error handling: what happens when events are malformed or arrival fails?
  • Set up authentication: API keys, OAuth, or service accounts for monitoring tools.
  • Configure Event Management to receive events and create incidents.
  • Test integration in a staging environment with realistic event volume.
  • Set up monitoring and alerting for the integration itself.
  • Document the integration: data flows, field mappings, troubleshooting steps.
  • Plan maintenance: who maintains the integration, how often is it reviewed?

Deciding which source fields become the canonical event fields

Field mapping is where many event integrations quietly go wrong. The monitoring tool sends a hostname in one field, an IP address in another and a free-text message that contains both, and the event table expects a single configuration item reference. Someone has to decide which source value wins, what happens when the value is missing, and whether the transformation belongs in the source, in an integration layer or in ServiceNow. This section is for the integration engineer who builds the mapping and needs to justify each decision to the people who will later have to troubleshoot it.

Source attribute Where the mapping decision belongs Common trap
Host name or address Resolve to a configuration item in the integration, keeping the raw value for audit Mapping by address alone breaks when addresses are reassigned
Severity or level text Translate in one shared table used by every source Two sources both say critical but mean different things by it
Timestamp Normalize to one time standard on arrival, and keep the source time as a separate field Clock drift between hosts makes correctly ordered events look reversed
Event identifier Use the source’s own identifier, with a composite key as the fallback A fallback key built from fields that change between repeats defeats deduplication
Free-text message Keep it whole, and extract only the fields that routing needs Extraction rules that match one wording pattern fail silently when a vendor updates a message

Onboarding one event source from start to finish

A repeatable onboarding sequence can make the second and third sources far cheaper than the first. The sequence below assumes the source can send events to ServiceNow directly or through an intermediary, and it treats the mapping as code that must be reviewed like any other change.

  1. Capture a sample of raw events from the source across different fault types, including the messages that are hardest to parse.
  2. Write the mapping for each attribute in the decision table above, and record the reason for each choice next to the mapping.
  3. Send the sample through the mapping in a non-production environment and inspect the resulting event records, not just the success response from the endpoint.
  4. Test the failure paths: a missing host, a malformed timestamp, and a duplicate event sent twice in quick succession.
  5. Confirm credentials and the transport route, including what happens when the endpoint is unreachable and whether the source retries or drops the event.
  6. Enable the source in production for a limited set of events, and compare the counts received against the counts the source reports it sent.

Three integration problems that look like monitoring problems

When a team reports that events from one source are missing or wrong, the cause is often in the integration rather than the monitoring tool. Clock differences between the source and the platform can reorder events so that a recovery appears before the fault it cleared. Retries from the source can deliver the same event after a later event for the same resource, which confuses any rule that expects a sequence. Credential rotation on the source side can stop delivery silently if the rotation is not coordinated with the integration owner. Each of these is visible in the event records if the team knows to look at the source time, the arrival time and the credential history together.

Routing source events through an intermediary

An intermediary such as a message queue or a middleware layer gives buffering when the platform is briefly unavailable, and it lets one source feed several destinations. The cost is one more component to monitor and one more place where a mapping can drift. If you use an intermediary, decide early which layer owns the field mapping, because mapping in two places is a common source of unexplained differences between what the source sent and what the platform shows.

Do on-premises sources need a MID Server?

Often they do, when the source lives behind a boundary the platform cannot open. The mid server pattern gives a controlled route through the firewall and keeps credentials inside the customer network. The choice depends on the network design rather than on the event volume, so settle the route before the mapping work begins.

Should enrichment happen at the source or in ServiceNow?

Enrich where the knowledge lives. Host ownership and service membership usually live in the configuration data inside ServiceNow, so enrichment there stays current as the data changes. Enrichment performed at the source copies a snapshot that goes stale the first time a host changes hands. The exception is data that exists only in the monitoring tool, such as a tag the monitoring team maintains, which is then best carried across as a field.

How do we test a mapping without flooding production?

Replay a captured sample through the same mapping in a non-production instance, and check the resulting events and the correlation groups they form. Keep the sample in version control with the mapping, so each change can be replayed against the same events and the difference in output is visible.

The mid server integration patterns cover integration patterns for MID Servers, the integration error handling article covers what to do when deliveries fail, and the security and access design page covers access for event management.

Frequently asked questions

Should all events from monitoring create incidents in ServiceNow?

No. Most events are noise and should not create incidents. Use Event Management correlation and filtering rules to identify only the events that matter. Too many incidents overwhelm the team.

What if monitoring and ServiceNow disagree on event state?

Define a source of truth. Typically, ServiceNow is authoritative: once an incident is resolved in ServiceNow, that is the truth. Monitoring can send additional context, but ServiceNow state wins. This avoids conflicts.

Can we integrate with tools we do not have full control over?

Yes, if the tool has an API or Webhook integration. You do not need to control the monitoring tool, just receive its events. If a tool does not have an API, use log parsing: have ServiceNow listen to syslog from that tool.

Talk to Oblytech

Planning, running or fixing a ServiceNow programme? Tell us where you are and we will suggest a sensible next step.

Contact us