====== ServiceNow Event Management ======

===== Purpose =====
  * Sends SAP alarms, metrics and configuration items to ServiceNow Event Management
  * Alarms and metrics are buffered and posted regularly, CIs are pushed directly to the CMDB
  * If alarm rules are active, only matching alarms are forwarded

===== Requirements =====
  * ServiceNow ITOM with Event Management enabled

===== Configuration =====


{{:products:cockpit:1.0:userguide:settings:screenshot_53.png?600|}}


^ Parameter ^ Description ^
| Active | Enable or disable the plugin |
| Name | Plugin display name |
| Host | ServiceNow instance URL (''<nowiki>https://[INSTANCE].service-now.com</nowiki>'') |
| User / Password | ServiceNow API credentials |
| Config API URL | Endpoint for CI sync (default: ''/api/now/identifyreconcile'') |
| Events API URL | Endpoint for alarms/events (default: ''/api/global/em/jsonv2'') |
| Metrics API URL | Endpoint for metrics (default: ''/api/global/em/jsonv2'') |
| Chunk size | Max items sent per request (default: 100) |

===== Severity Mapping =====

^ RedPeaks ^ ServiceNow EM Severity ^
| CRITICAL | 1 |
| MAJOR | 2 |
| MINOR | 3 |
| WARNING | 4 |
| INFO | 5 |
| CLEAR | 0 |

===== CMDB CI Auto-Discovery =====
  * The plugin automatically pushes SAP system metadata to the CMDB via ''/api/now/identifyreconcile''.
  * Three CI types are created:
    * ''cmdb_ci_service_manual'' — Business services (one per organization)
    * ''cmdb_ci_appl_sap_system'' — SAP systems (one per SID)
    * ''cmdb_ci_hardware'' — Hosts (one per server)
  * Relations between CIs are set automatically (system → service, host → system).
  * CIs can be found in ServiceNow under **Configuration > CMDB**, filtered by ''discovery_source = "Other Automated"''.