Correlation - Get Correlation Engine

URI

https://164.99.19.131:8443/SentinelRESTServices/correlation/engines/{engineId}

Supported Methods

GET

This API gets information about the correlation engine specified by {engineId}, including its health.

Authentication

Authentication Types
Sentinel Permissions Needed

URL Parameters

None.

Success Codes

Fault Codes

Response Data

Object type: Correlation engine object.
All existing correlation engines in the Sentinel system
FieldDescription
activeThis is a boolean value. If true, the engine is started, otherwise it is stopped.
engineIdThis is the unique identifier of the Correlation engine.
enginenameThis is the name of the Correlation engine.
healthThe health data of the Correlation engine.
hostipHost ip of the engine.
hostnameHost name of the engine.
idleThis is a boolean value. If true, the engine is not reachable and unable to process any request.

Response Data

Object type: Correlation engine health object.
Correlation engine health object.
FieldDescription
AverageProcessingTimeThe average time to press the deployed rules.
EPSCapacityThe processing time the Correlation Engine consumes relative to the capacity of the engine.
ProcessedCountThe number of events processed by the deployed rules since they were deployed.
StatusDurationThis indicates the duration (in milliseconds) the engine is in its present state.

Sample Request

GET correlation/engines/696080E0-9A20-1029-ADDD-0003BAC9707D
Sample Response for application/json
Status: 200
{"engineId":"696080E0-9A20-1029-ADDD-0003BAC9707D","enginename":"atapas-test.blr.novell.com:164.99.84.125","active":"true","idle":"false","hostname":"atapas-test.blr.novell.com","hostip":"164.99.84.125","health":{"AverageProcessingTime":"7","StatusDuration":"207654387","ProcessedCount":"6288","EPSCapacity":"1.0E-4"}}

Sample Response for application/json
Status: 404
The resource not found.