Page History

General information

The

To view the system status data, you need to:

...

web interface of the self-diagnostics service is available for monitoring the system statuses and analyzing its performance.

Access to the self-diagnostics service

To go to the monitoring interface, do the following:

1. Open the web browser.
2. In the address line, enter: http://127.0.0.1:20040/.
Image Removed
3. Click the Enter button.

Interface and queries execution

The service interface allows viewing metrics as a table or graphs. To run a query, do the following:

1. Select the

required

2. metric

in

3. from the drop-down list

(

4. 1

)

5. or enter the query manually in the Expression field.

Expandtitle Description of useful metrics

6. You can:

   1. Use several metrics at a time. The system has the following available metrics:
      

      Metric	Description
      ALERTS_FOR_STATE

Troubleshooting by the self-diagnostics service

7. 1. Found and fixed malfunctions. Contains the alertname parameter with the problem type. Code Block language go title Example ALERTS_FOR_STATE{alertname="ipint_is_not_activated",ep_name="hosts/Server1/DeviceIpint.99",instance="127.0.0.1:20108",job="ngp_exporter",ngp_alert="true"}

Possible values

8. 1. Decryption of the alertname

parameter

9. 1. values (see

What is

10. 1. General information about the self-diagnostics service) for the ALERTS_FOR_STATE metric: low_os_memory

— out

11. 1. —out of RAM

;

12. 1. . ipint_is_not_activated

— camera

13. 1. —camera is connected

but does not send data;

14. 1. , but there is no data from it. no_samples_in_detector

— no

15. 1. —no events from

a detection tool;

16. 1. the detector. restart_services_when_archive_source_not_activated

— the archive is not working;

17. 1. —the archive recording isn't working. restart_services_when_no_samples_in_archive

— recording

18. 1. —recording to archive with 0

FPS;

19. 1. fps. restart_services_when_no_ping_from_detector_to_archive

— no

20. 1. —no recording to the archive

on detection tool triggering;

21. 1. at the event from the detector. logs_disk_space_is_low / db_disk_space_is_low

— out

22. 1. —out of system disk space.
       ngp_archive_channel_fps	The frame rate of all

video

23. 1. cameras when recording to the archive
       ngp_archive_volume_size	The current total size of the archive (in bytes)
       ngp_cpu_total_usage	The

percentage of

24. 1. CPU load

on a Server

25. 1. of the server
       ngp_fps	The frame rate of all

Server video

26. 1. server cameras,

all detection tools

27. 1. detectors and

their

28. 1. decoders

The request allows for:

29. Using multiple metrics.

30. Using expressions to find problems. For example, a query like ngp_fps <17 will return all metrics, where FPS was less than 17. For a complete list of logical and arithmetic operators, see the official Prometheus documentation.  

Filtering by any of the parameters. For example, a query like

31. 1. ngp_people_count	The last captured number of people in the frame by the Crowd estimation VA detector
       ngp_errors	Number of errors in the detectors' operation: Neural tracker Neural counter Human pose detector Neural classifier Stopped object detector Smoke detector Fire detector Water level detector with a neural network Barcode detector Meta-detector Person-based privacy masking Object tracker (with a Neural filter) Crowd estimation VA
       ngp_skipped_pp	Number of missed frames by the Crowd estimation VA detector due to the lack of resources for processing

    2. Apply logic and arithmetic operators for anomaly searching. The full list of logic and arithmetic operators is specified in the official Prometheus documentation.
       

       Code Block
       language go title Example. All metrics where fps is less than 17
       ngp_fps < 17

    3. Faltering by metrics parameters using curly brackets.
       

       Code Block
       language go title Example. Fps values only for the specified source

32. 1. ngp_fps{ep_name=~"hosts/

V-BELYAKOV

33. 1. TEST/DeviceIpint.2/SourceEndpoint.video:0:0"}

will return FPS values only for the specified source.
34. 1. Image Added
35. If necessary, set the time range for the data.

36. Click the Execute button.

Viewing results:

• The Console tab displays the current metrics values in the table format.
  Image Added
  When you specify the date and time in the calendar, the data is updated.
  Image Added
  
• On the Graph tab you can create the graph of selected metrics at the specified period.
  • The 1 field—sets the graph time interval.
  • The 2 field—specifies the end graph point.
  • The 3 field—sets the interval between data points.
  • The 4 checkbox—enables the display mode with accumulation (filling the areas under the graph).
    Image Added
    

Examples of useful queries for Windows

...

OS

1. The CPU loading graph
similar to
2. (analog of the
Windows
3. System monitor):
   

   Code Block
   language go
   sum by (process_id) (100 / scalar(wmi_cs_logical_processors) * (irate(wmi_process_cpu_time_total{

job="os_export",

4. process="AppHost"}[10m]))) or ngp_cpu_total_usage

The graph of
5. RAM usage by
the
6. the AppHost processes and a total memory space:
   

   Code Block
   language go
   sum by (process_id) (avg_over_time(wmi_process_working_set{

job=~"os_export",

7. process="AppHost"}[5m])) / 1024 or avg_over_time(wmi_os_virtual_memory_bytes

{job=~"os_export"}

8. [5m]) / 1024

9. The percentage of RAM usage:
   

   Code Block
   100.0 - 100 * avg_over_time(wmi_os_virtual_memory_free_bytes

{job=~"os_export"}

10. [5m]) / avg_over_time(wmi_os_virtual_memory_bytes

{job=~"os_export"}

11. [5m])

Examples of useful queries for Linux

...

OS

1. The
graph of
2. total RAM usage by
the
3. the AppHost processes
and a total memory space in bytes
4. :
   

   Code Block
   language go
   sum by (groupname) (namedprocess_namegroup_memory_bytes{memtype="resident"})

5. The percentage of RAM usage:
   

   Code Block
   language go
   100 - node_memory_MemAvailable_bytes * 100 / node_memory_MemTotal_bytes

6. The
graph of the
7. CPU load by
the
8. the AppHost processes as a percentage:
   

   Code Block
   sum by (

groupname

9. object_id) (rate(namedprocess_namegroup_cpu_seconds_total{groupname="AppHost"}[1m])) * 100

10. The
graph of the
11. total CPU load
 as
12. as a percentage:
    

    Code Block
    language go
    100 * avg without (cpu) (1 - rate(node_cpu_seconds_total{mode="idle"}[1m]))

13. Click the Execute button (2).
    The Console tab will display all possible values of all elements at the time the query is completed.
    Image Removed
    

14. When you set a date and time in your calendar, the data will be updated.
    Image Removed
    

15. RAM usage by the AppHost processes to detect the memory leak:
    

    Code Block
    language go
    namedprocess_namegroup_memory_bytes{object_id=~"APP_HOST.*",memtype="proportionalResident"}

To build a graph, go to the Graph tab.
Image Removed
In the field 1, set the time interval of the graph. In the field 2, set its end point. In the filed 3, set the interval between the data points. To fill the chart, set the stacked (4) checkbox.