This page helps a user know the process of providing an NDE service and how that service is utilized by generic REST service. The user would need to know only the Uniform Resource Locator (URL) of the server where the data is stored. The server, after processing the request, converts the content into the JSON information and sends it back to the caller.
To create a URL of the server, user needs to specify the following parameters:
Host Name / IP Address
Specify the Host Name/IP address along with the port of the server. Also, specify the server path.
For example: http://10.10.50.17/DashboardServer/web/dev/checkGraphDatav3?
Start Date-Time and End Date-Time
Specify the Start Date-Time and End Date-Time of the sample data in mm/dd/yyyy hh:mm:ss format.
This is an optional input. The user needs to specify the configured NDE continuous Test run number.
Group ID and Graph ID
Group ID and Graph ID are always numeric. Graphs belong to a specific group. The user must know the group name to obtain Group ID and Graph ID. A graph ID is the exact name of a graph, which is already mapped in generic REST service.
To obtain Group ID and Graph ID, the user needs to make an ND REST call. For example:
The output of above REST call is 10108,18 where Group ID is 10108 and Graph ID is 18 (these are separated by a comma in the output).
Specify the vector (Tier) name for which data is to be retrieved. This can be pattern based or a complete vector, and must be same as in GDF file.
For example: vectorName=*tomcat* or tomcat1
‘Mode’ decides for RTG files read mode. The value must always be 2 (which means normal RTG files). The value of Modes can be from 1 to 4, but for generic REST service, use only 2.
This gets the data based on vector pattern. We use generic REST service for derived graphs, so the value of this parameter needs to be ‘true’.
This is used with the ‘isPattern’ parameter. It gets the data of those graphs that are deleted in specified time period.
It is the ‘Derived Formula’ which is mapped for graphs.
For example: (MIN, MAX, AVG, NORAVG, SUM)
The default value of this parameter is ‘false’, in which case sample wise data is calculated. If ‘true’ is selected, aggregated data is calculated.
|Multiple groups and graphs are not supported currently as this may cause performance issues.|
An authentication token is required to be passed in the URL. The user can generate a token via Generate Token () menu in NetDiagnostics. The user is required to provide the time duration after which the token is expired and click the Generate button.
A sample URL consisting of the parameters mentioned in the above section looks like the following:
Generating Response in JSON
Once the URL is specified, the user can generate the response in JSON format. To generate the response, specify the URL at any browser and press ENTER. The response is generated and displayed.
Formatting the Response
The response generated can be formatted by using any JSON editor (for example, https://jsoneditoronline.org/).
Once the response is formatted, it is easy to view the response details. User needs to click the icon to expand a node and icon to collapse it.