X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=docs%2Fuser-guide.rst;h=7c1ab7e7ba31a1f19e14653f44550074a935e031;hb=refs%2Fchanges%2F67%2F12267%2F1;hp=e531f7c9d03c92502be7c0bf6008b5cc450f6915;hpb=00894a4120ea2c93bc58327fbb7c526a6f607bde;p=ric-plt%2Falarm-go.git diff --git a/docs/user-guide.rst b/docs/user-guide.rst index e531f7c..7c1ab7e 100755 --- a/docs/user-guide.rst +++ b/docs/user-guide.rst @@ -147,6 +147,8 @@ CLI commands can have some of the following parameters --atx Alarm text string, example string: E2 CONNECTIVITY LOST TO E-NODEB --ety Event type string, example string: Communication error --oin Operation instructions string, example string: Not defined + --rad Raise alarm delay in seconds. Default value = 0 + --cad Clear alarm delay in seconds. Default value = 0 --prf Performance profile id, possible values: 1 = peak performance test or 2 = endurance test --nal Number of alarms, example value: 50 --aps Alarms per second, example value: 1 @@ -226,11 +228,11 @@ CLI command examples: .. code-block:: none - Syntax: cli/alarm-cli define --aid 8007 --atx "E2 CONNECTIVITY LOST TO E-NODEB" --ety "Communication error" --oin "Not defined" [--host] [--port] + Syntax: cli/alarm-cli define --aid 8007 --atx "E2 CONNECTIVITY LOST TO E-NODEB" --ety "Communication error" --oin "Not defined" [--rad] [--cad] [--host] [--port] - Example: cli/alarm-cli define --aid 8007 --atx "E2 CONNECTIVITY LOST TO E-NODEB" --ety "Communication error" --oin "Not defined" + Example: cli/alarm-cli define --aid 8007 --atx "E2 CONNECTIVITY LOST TO E-NODEB" --ety "Communication error" --oin "Not defined" --rad 0 --cad 0 - Example: cli/alarm-cli define --aid 8007 --atx "E2 CONNECTIVITY LOST TO E-NODEB" --ety "Communication error" --oin "Not defined" --host localhost --port 8080 + Example: cli/alarm-cli define --aid 8007 --atx "E2 CONNECTIVITY LOST TO E-NODEB" --ety "Communication error" --oin "Not defined" --rad 0 --cad 0 --host localhost --port 8080 Delete existing alarm definition: @@ -271,9 +273,9 @@ Get alerts from Prometheus Alert Manager: .. code-block:: none - Syntax: cli/alarm-cli gapam --active --inhibited --silenced --unprocessed --host [--port] + Syntax: cli/alarm-cli alerts --active --inhibited --silenced --unprocessed --host [--port] - Example: cli/alarm-cli gapam --active true --inhibited true --silenced true --unprocessed true --host 10.102.36.121 --port 9093 + Example: cli/alarm-cli alerts --active true --inhibited true --silenced true --unprocessed true --host 10.102.36.121 --port 9093 REST interface usage guide @@ -319,11 +321,11 @@ Below are examples for REST interface. Curl tool is used to send REST commands. Add one new alarm definition: - Example: curl -X POST "http://localhost:8080/ric/v1/alarms/define" -H "accept: application/json" -H "Content-Type: application/json" -d "{\"alarmdefinitions\": [{\"alarmId\": 8007, \"alarmText\": \"E2 CONNECTIVITY LOST TO E-NODEB\", \"eventtype\": \"Communication error\", \"operationinstructions\": \"Not defined\"}]}" + Example: curl -X POST "http://localhost:8080/ric/v1/alarms/define" -H "accept: application/json" -H "Content-Type: application/json" -d "{\"alarmdefinitions\": [{\"alarmId\": 8007, \"alarmText\": \"E2 CONNECTIVITY LOST TO E-NODEB\", \"eventtype\": \"Communication error\", \"operationinstructions\": \"Not defined\, \"raiseDelay\": 1, \"clearDelay\": 1"}]}" Add two new alarm definitions: - Example: curl -X POST "http://localhost:8080/ric/v1/alarms/define" -H "accept: application/json" -H "Content-Type: application/json" -d "{\"alarmdefinitions\": [{\"alarmId\": 8007, \"alarmText\": \"E2 CONNECTIVITY LOST TO E-NODEB\", \"eventtype\": \"Communication error\", \"operationinstructions\": \"Not defined\"},{\"alarmId\": 8008, \"alarmText\": \"ACTIVE ALARM EXCEED MAX THRESHOLD\", \"eventtype\": \"storage warning\", \"operationinstructions\": \"Clear alarms or raise threshold\"}]}" + Example: curl -X POST "http://localhost:8080/ric/v1/alarms/define" -H "accept: application/json" -H "Content-Type: application/json" -d "{\"alarmdefinitions\": [{\"alarmId\": 8007, \"alarmText\": \"E2 CONNECTIVITY LOST TO E-NODEB\", \"eventtype\": \"Communication error\", \"operationinstructions\": \"Not defined\, \"raiseDelay\": 0, \"clearDelay\": 0"},{\"alarmId\": 8008, \"alarmText\": \"ACTIVE ALARM EXCEED MAX THRESHOLD\", \"eventtype\": \"storage warning\", \"operationinstructions\": \"Clear alarms or raise threshold\", \"raiseDelay\": 0, \"clearDelay\": 0}]}" Delete one existing alarm definition: @@ -354,7 +356,7 @@ Alarm library functions can be used directly from Golang code. Rising and cleari package main import ( - alarm "gerrit.o-ran-sc.org/r/ric-plt/alarm-go/alarm" + alarm "gerrit.o-ran-sc.org/r/ric-plt/alarm-go.git/alarm" ) func main() {