MC2 REST API Troubleshooting

High Level Diagram

The diagram below depicts the high-level flows of current MC2 REST Services. 

Open

MC2 REST Services Deployment and Enablement

MC2 is enabled by the following steps:

1. Install the Eagle/MC2 "all-services" packages from the EagleML Installer. Reference EagleML / MC2 Release Deployment for detailed steps of the deployment.

2. After deploying, configure the Eagle Web Services front-end to enable REST and SOAP services. Reference the Installation additional configurations for MC2 for configuration details.

3. After front-end configuration, restart the Eagle WebServer and/or IIS to ensure the configuration changes take effect.

MC2 REST Endpoints Routing

MC2 currently supports the following REST Services:

• MC2 REST Endpoints for Simple Extracts

• MC2 REST Endpoints for the Generic Extractor (POST only)

• EDS/EQL Endpoints (POST only)

• Health Check Endpoints (backend access only)

• PACE report service (additional services outside MC2) to run OLAP reports (both POST and GET requests).

MC2 Rest Service Routes

For the MC2 Generic Load/Extract, it travels through the following route:

For an MC2 EDS Request, it travels through the following route:

For PACE Report Service REST Request, it takes the route below:

If an error occurs, it depends on the type of request and error code to resolve.  Review and identify the route and then check each endpoint of the route to diagnose the trouble endpoint(s).

General Troubleshooting

When invoking MC2 REST services, it returns a status code which follows the standard of HTTP response codes:

• 200+   OK

• 400+   bad client request

• 500+   internal server error

Possible Client-Side Requests Issues

When REST Invocation responds with an error code int range of 400+, it usually indicates that the error is on the client end with the exception of when server endpoint is down.

Frequently bad request error codes are:

• 400 - Bad request

• 401 - Unauthorized

• 403 - Forbidden

• 404 - Not Found

When encountering client-side errors:

• If the response code = 400 or 404, check if the requested URL is correct or the server URL is accessible.

• If the response code = 401, check if the correct authentication parameters, user name or password, is specified correctly as part of request.

• If the response code = 403, the specified URL is not allowed.

Possible Server Endpoint Services Issues

When the REST Invocation fails with error code >= 500, it indicates a server side error.

Review the following items:

• Are all corresponding backend endpoints up and running?

• Are are all System configurations accurate?

• Are all deployed Endpoints versions compatible?

There are multiple ways to check if all backend services are up and running. It is easier to log in to the backend servers with backend access to perform the following checks:

• Check MC2 health using the Healthcheck Url

• From the backend, check if the MC2 services (extractservicelb, extractserviceworker, kafkaservice and pyruleservices) are up and running:

• Check version incompatibilities

For an issue related to the pace-reportservice endpoint, check the following:

• Is the pace-reportservice deployed?

• Is the pace-reportservice up and running?

Frequently Encountered Issues and Troubleshooting Steps

Receive Eagle Landing Page When Invoking REST Service

When submitting the REST request, the request produces the landing page contents instead of the expected JSON data response.  This is usually due to a configuration issue and/or issues on the Eagle WebServer. Use the following steps to diagnose the issue:

Check Configuration

Check the ${EagleAppToRoot}/tpe/cfg/starsecuity.ini configurations specified in the Installation additional configurations for MC2 and validate all corresponding configuration from all WebServer nodes.

Repeat the above actions for all the WebServer nodes and ensure the changes have been made for all WebServer nodes.

Check the Status of WebServer(s)

From the System Management Console (sample image below), check all of the listed services "Type" equal to  "WEBSERVER" have the "last recycle" time greater than the timestamp of the starsecurity.ini and the "Status Message" reflects the value of "UP".

Open

URLs for a Quick Check of Rest Endpoints

The following URLs can be used for a quick diagnosis of the health of MC2 rest endpoints. Replace webserver with webserver hostname or IP address.

or more extract specific URLs such as: