Add monitor web page to Health Check test
[nonrtric.git] / test / usecases / healthcheck / README.md
1 # Use case Health Check test
2 # General
3
4 The Health Check use case test provides a python script that regularly creates, reads, updates, and deletes a policy
5 in all Near-RT RICs that support the type used by the script. A self refreshing web page provides a view of statistics
6 for these regular checks.
7
8 # Prerequisits
9 To run this script Python3 needs to be installed. To install the script's dependencies, run the following command from
10 the `src` folder: `pip install -r requirements.txt`
11
12 # How to run
13 Go to the `src/` folder and run `python3 main.py`. The script will start and run until stopped. Use the `-h` option to
14 see the options available for the script.
15
16 As default, the script uses the "Hello World" policy type with ID "2". To create the instances it uses the body file
17 `nonrtric/test/autotest/testdata/OSC/pihw_template.json`. The body file contains the string "XXX" as a parameter value.
18 This string vill be replaced with dynamic data during creation. It is possible to provide a custom policy type and
19 body file to the script at startup.
20
21 To see the web page, navigate to `localhost:9990/stats`. The page refreshes itself with the same interval as the script
22 uses.
23
24 ## License
25
26 Copyright (C) 2020 Nordix Foundation.
27 Licensed under the Apache License, Version 2.0 (the "License")
28 you may not use this file except in compliance with the License.
29 You may obtain a copy of the License at
30
31       http://www.apache.org/licenses/LICENSE-2.0
32
33 Unless required by applicable law or agreed to in writing, software
34 distributed under the License is distributed on an "AS IS" BASIS,
35 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
36 See the License for the specific language governing permissions and
37 limitations under the License.
38
39 For more information about license please see the [LICENSE](LICENSE.txt) file for details.