Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Go to the web interface of the self-diagnostics service: http://127.0.0.1:20040/.
  2. Select the required metric in the list (1) or enter the query in the Expression field.

    Expand
    title Description of useful metrics


    Metric

    Description

    ALERTS_FOR_STATE

    Troubleshooting by the self-diagnostics service.

    Code Block
    titleExample
    ALERTS_FOR_STATE{alertname="ipint_is_not_activated",ep_name="hosts/Server1/DeviceIpint.99",instance="127.0.0.1:20108",job="ngp_exportexporter",ngp_alert="true"}

    Possible values of the alert name parameteralertname parameter (see What is the self-diagnostics service):

    • low_os_memory out of RAM;
    • ipint_is_not_activated camera is connected but does not send data;
    • no_samples_in_detector no events from a detection tool;
    • restart_services_when_archive_source_not_activated  the archive is not working;
    • restart_services_when_no_samples_in_archive recording to archive with 0 FPS;
    • restart_services_when_no_ping_from_detector_to_archive − no footage is recorded on detectionarchive  no recording to the archive on detection tool triggering;
    • logs_disk_space_is_low/db_disk_space_is_low out of system disk space.

    ngp_archive_channel_fps

    The frame rate of all video cameras recording to archive.

    ngp_cpu_total_usage

    The percentage of CPU load on a Server.

    ngp_fps

    The frame rate of all Server video cameras, all detection tools and their decoders.


    The request allows for:

    1. Using multiple metrics.

    2. Using expressions to find issuesproblems. For example, a query like ngp_fps <17 will return all metrics, where fps FPS was less than 17. The full For a complete list of logical and arithmetic operators is listed in , see the official Prometheus documentation.  

    3. Filtering by any of the parameters. For example, a query like ngp_fps{ep_name=~"hosts/V-BELYAKOV/DeviceIpint.2/SourceEndpoint.video:0:0"} will return fps FPS values only for the specified source.

      Examples of useful queries for Windows:
      The CPU loading graph similar to the Windows System monitor:

      Code Block
      sum by (process_id) (100 / scalar(wmi_cs_logical_processors) * (irate(wmi_process_cpu_time_total{job="os_export", process="AppHost"}[10m]))) or ngp_cpu_total_usage

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

      Code Block
      sum by (process_id) (avg_over_time(wmi_process_working_set{job=~"os_export", process="AppHost"}[5m])) / 1024 or avg_over_time(wmi_os_virtual_memory_bytes{job=~"os_export"}[5m]) / 1024

      The percentage of RAM usage:

      Code Block
      100.0 - 100 * avg_over_time(wmi_os_virtual_memory_free_bytes{job=~"os_export"}[5m]) / avg_over_time(wmi_os_virtual_memory_bytes{job=~"os_export"}[5m])

      Examples of useful queries for Linux:
      The graph of RAM usage by the AppHost processes and a total memory space in bytes:

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

      The percentage of RAM usage:

      Code Block
      100 - node_memory_MemAvailable_bytes * 100 / node_memory_MemTotal_bytes

      The graph of the CPU load by the AppHost processes as a percentage:

      Code Block
      sum by (groupname) (rate(namedprocess_namegroup_cpu_seconds_total[1m])) * 100

      The graph of the CPU load as a percentage:

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


  3. Click the Execute  button (2).
    The Console tab will issue display all possible values of all items elements at the time the request query is completed.

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

  5. To build a graph, go to the Graph tab.

    In the field (1), set the time slot interval of the graph, in . In the field (2) , set its end point, in . In the filed (3) , set the interval between the data points. To fill the chart, select set the stacked (4) checkbox.