Получение статистики Сервера по использованию ресурсов

Параметры запроса

Запрос не имеет параметров.

 

Пример запроса

http://192.168.1.1:9080/api/server/usage.ds

Ниже представлены примеры ответов в формате XML и в формате JSON.

 

Ответ в формате XML

<drweb-es-api api_version="4.3.0" timestamp="1558521947" server="192.168.1.1" srv_version="12.00.0.201909260" status="true">
  <usage>
    <alert total="0" size="0" failed="0" sent="0"/>

    <client agents="0" consoles="0" installs="0" links="0" newbies="0" proxies="0"/>

    <cluster bytes_in="0" bytes_out="0" messages_in="0" messages_out="0"/>

    <connections total="1" current="0" maximum="1"/>

    <vm context_switches="98688" cpu_kernel="455193400" cpu_user="2568140100" page_faults="34240" read_cnt="0" write_cnt="1504624" threads="36" virtual_memory="389767168" working_set="93057024"/>

    <db rows_read="542526" rows_written="51448" statements_fail="0" statements_ok="93240" transactions_rolledback="1" transactions_comitted="50800"/>

    <repository bytes_in="0" bytes_out="0" files_added="0" files_deleted="0" files_replaced="0" http_fail="0" http_ok="0"/>

    <cache>
        <dns hit="0" missed="0" size="0"/>

        <file hit="1136" max_msize="249" max_vsize="249" vsize="249" missed="1" msize="249"/>

        <mcastupdate bytes_in="0" bytes_out="0" packets_in="0" packets_out="0"/>

        <repository hit="619" max_msize="3605106" max_vsize="3615410" missed="0" msize="3605106" vsize="3605106"/>
    </cache>

    <load-average>
        <load1>0.88</load1>

        <load5>0.57</load5>

        <load15>0.27</load15>
    </load-average>

    <memory>
        <total>3944</total>

        <free>328</free>

        <used-by-server>29</used-by-server>
    </memory>

    <fd>
        <opened>90</opened>

        <soft-limit>131170</soft-limit>

        <hard-limit>131170</hard-limit>
    </fd>
  </usage>
</drweb-es-api>

 

Описание параметров ответного XML

Элемент <usage /> содержит информацию по использованию ресурсов Сервера.

•Элемент <alert /> содержит информацию об уведомлениях Сервера.

Атрибуты элемента <alert />:

Атрибут

Описание

total

Общее количество сгенерированных уведомлений

size

Общие размер сгенерированных уведомлений

failed

Количество неотправленных уведомлений

sent

Количество успешно отправленных уведомлений

•Элемент <client /> содержит информацию о клиентах, подключенных к Серверу.

Атрибуты элемента <client />:

Атрибут

Описание

agents

Количество подключенных Агентов

consoles

Количество подключенных Центров управления

installs

Количество установок Агента, запущенных в данный момент

links

Количество связанных соседних Серверов

newbies

Количество новичков

proxies

Количество прокси-серверов

•Элемент <cluster /> содержит информацию о кластере Серверов.

Атрибуты элемента <cluster />:

Атрибут

Описание

bytes_in

Количество принятых данных в байтах

bytes_out

Количество переданных данных в байтах

messages_in

Количество принятых сообщений

messages_out

Количество отправленных сообщений

•Элемент <connections /> содержит информацию о сетевых подключениях к Серверу.

Атрибуты элемента <connections />:

Атрибут

Описание

total

Общее количество разрешенных подключений

current

Количество активных подключений в данный момент

maximum

Зафиксированный максимум одновременных подключений

•Элемент <vm /> содержит информацию об использовании системных ресурсов на компьютере с установленным Сервером.

Атрибуты элемента <vm />:

Атрибут

Описание

context_switches

Количество переключений контекста

cpu_kernel

Время работы процессора в режиме ядра

cpu_user

Время работы процессора в режиме пользователя

page_faults

Количество ошибок страниц

read_cnt

Количество чтений из памяти

write_cnt

Количество записей в память

virtual_memory

Объем виртуальной памяти, выделенной для Сервера в данный момент

threads

Количество запущенных потоков

working_set

Рабочий набор

•Элемент <db /> содержит информацию об использовании базы данных Сервера.

Атрибуты элемента <db />:

Атрибут

Описание

rows_read

Количество прочитанных строк

rows_written

Количество записанных строк

statements_fail

Количество неуспешных операторов

statements_ok

Количество успешных операторов

transactions_rolledback

Количество отмененных транзакций

transactions_comitted

Количество завершенных транзакций

•Элемент <repository /> содержит информацию о репозитории Сервера.

Атрибуты элемента <repository />:

Атрибут

Описание

bytes_in

Количество принятых данных в байтах

bytes_out

Количество переданных данных в байтах

files_added

Количество новых файлов

files_deleted

Количество удаленных файлов

files_replaced

Количество замененных файлов

http_fail

Количество неуспешных HTTP-запросов

http_ok

Количество успешных HTTP-запросов

•Элемент <cache /> содержит информацию об использовании кэша.

▫Элемент <dns /> содержит информацию об использовании DNS-кэша.

Атрибуты элемента <dns />:

Атрибут

Описание

hit

Количество попаданий кэша

missed

Количество промахов кэша

size

Текущий размер кэша

▫Элемент <file /> содержит информацию об использовании файлового кэша.

Атрибуты элемента <file />:

Атрибут

Описание

hit

Количество попаданий кэша

max_msize

Максимальный размер кэша

max_vsize

Максимальный виртуальный размер кэша

vsize

Виртуальный размер кэша

missed

Количество промахов кэша

msize

Текущий размер кэша

▫Элемент <mcastupdate /> содержит информацию об использовании кэша при передаче групповых обновлений.

Атрибуты элемента <mcastupdate />:

Атрибут

Описание

bytes_in

Количество принятых данных в байтах

bytes_out

Количество переданных данных в байтах

packets_in

Количество принятых пакетов

packets_out

Количество переданных пакетов

▫Элемент <repository /> содержит информацию об использовании кэша репозитория.

Атрибуты элемента <repository />:

Атрибут

Описание

hit

Количество попаданий кэша

max_msize

Максимальный размер кэша

max_vsize

Максимальный виртуальный размер кэша

missed

Количество промахов кэша

msize

Текущий размер кэша

vsize

Виртуальный размер кэша

•Элемент <load-average /> содержит среднее значение загрузки системы за определенный период.

Вложенные элементы элемента <load-average />:

Элемент

Описание

<load1 />

Процент загрузки системы за 1 минуту

<load5 />

Процент загрузки системы за 5 минут

<load15 />

Процент загрузки системы за 15 минут

Среднее значение загрузки системы вычисляется только для устройств под управлением UNIX-подобных ОС. Для ОС Windows всегда возвращается значение "-1".

•Элемент <memory /> содержит информацию об оперативной памяти компьютера, на котором установлен Сервер.

Вложенные элементы элемента <memory />:

Элемент

Описание

<total />

Общий объем оперативной памяти

<free />

Объем свободной оперативной памяти

<used-by-server />

Объем оперативной памяти, используемой Сервером

•Элемент <fd /> содержит информацию об открытых файлых на Сервере.

Вложенные элементы элемента <fd />:

Элемент

Описание

<opened />

Количество открытых файлов на Сервере

<soft-limit />

Рекомендуемое ограничение количества открытых файлов

<hard-limit />

Жесткое ограничение количества открытых файлов

Ограничения количества открытых файлов актуальны только для устройств под управлением UNIX-подобных ОС.

 

Ответ в формате JSON

{ "head": {
    "status": true,

    "timestamp": 1558522035,

    "api": {
      "version": 40300,
      "versionString": 4.3.0},

    "server": {
      "name": "192.168.1.1",

      "version": "12.00.0.201909260",
      "uuid": "27671337-e0b0-4f60-aeb0-ab1f2ca47f77"}},

"data": {
    "usage": {
      "alert": {
          "failed": 0,

          "sent": 0,

          "size": 0,
          "total": 0},

      "cache": {
          "dns": {
            "hit": 0,

            "missed": 0},
             "size": 0},

          "file": {
            "hit": 1136,

            "max_msize": 249,

            "max_vsize": 249,

            "missed": 1,

            "msize": 249,
            "vsize": 249},

          "mcastupdate": {
            "bytes_in": 0,

            "bytes_out": 0,

            "packets_in": 0,
            "packets_out": 0},

          "repository": {
            "hit": 619,

            "max_msize": 3605106,

            "max_vsize": 3615410,

            "missed": 0,

            "msize": 3605106,
            "vsize": 3605106}},

      "client": {
          "agents": 0,

          "consoles": 0,

          "installs": 0,

          "links": 0,

          "newbies": 0,
          "proxies": 0},

      "cluster": {
          "bytes_in": 0,

          "bytes_out": 0,

          "messages_in": 0,
          "messages_out": 0},

      "connect": {
          "current": 0,

          "maximum": 1,
          "total": 1},

      "db": {
          "rows_read": 543261,

          "rows_written": 51448,

          "statements_fail": 0,

          "statements_ok": 93305,

          "transactions_comitted": 50865,
          "transactions_rolledback": 1},

      "fd": {
          "hard_limit": 131170,

          "opened": 97,
          "soft_limit": 131170},

      "load_average": {
          "load1": 1.12,

          "load15": 0.35,
          "load5": 0.72},

      "memory": {
          "free": 311,

          "total": 3944,
          "used_by_server": 29},

      "repository": {
          "bytes_in": 0,

          "bytes_out": 0,

          "files_added": 0,

          "files_deleted": 0,

          "files_replaced": 0,

          "http_fail": 0,
          "http_ok": 0},

      "vm": {
          "context_switches": 98105,

          "cpu_kernel": 552177500,

          "cpu_user": 2671634000,

          "page_faults": 35579,

          "read_cnt": 0,

          "threads": 36,

          "virtual_memory": 384000000,

          "working_set": 94928896,
          "write_cnt": 1502632}}}}

 

Описание параметров ответного JSON

Блок usage содержит информацию по использованию ресурсов Сервера.

•Блок alert содержит информацию об уведомлениях Сервера.

Элементы блока alert:

Название поля

Описание

failed

Количество неотправленных уведомлений

sent

Количество успешно отправленных уведомлений

size

Общие размер сгенерированных уведомлений

total

Общее количество сгенерированных уведомлений

•Блок cache содержит информацию об использовании кэша.

▫Блок dns содержит информацию об использовании DNS-кэша.

Элементы блока dns:

Название поля

Описание

hit

Количество попаданий кэша

missed

Количество промахов кэша

size

Текущий размер кэша

▫Блок file содержит информацию об использовании файлового кэша.

Элементы блока file:

Название поля

Описание

hit

Количество попаданий кэша

max_msize

Максимальный размер кэша

max_vsize

Максимальный виртуальный размер кэша

missed

Количество промахов кэша

msize

Текущий размер кэша

vsize

Виртуальный размер кэша

▫Блок mcastupdate содержит информацию об использовании кэша при передаче групповых обновлений.

Элементы блока mcastupdate:

Название поля

Описание

bytes_in

Количество принятых данных в байтах

bytes_out

Количество переданных данных в байтах

packets_in

Количество принятых пакетов

packets_out

Количество переданных пакетов

▫Блок repository, входящий в блок cache, содержит информацию об использовании кэша репозитория.

Элементы блока repository:

Название поля

Описание

hit

Количество попаданий кэша

max_msize

Максимальный размер кэша

max_vsize

Максимальный виртуальный размер кэша

missed

Количество промахов кэша

msize

Текущий размер кэша

vsize

Виртуальный размер кэша

•Блок client содержит информацию о клиентах, подключенных к Серверу.

Элементы блока client:

Название поля

Описание

agents

Количество подключенных Агентов

consoles

Количество подключенных Центров управления

installs

Количество установок Агента, запущенных в данный момент

links

Количество связанных соседних Серверов

newbies

Количество новичков

proxies

Количество прокси-серверов

•Блок cluster содержит информацию о кластере Серверов.

Элементы блока cluster:

Название поля

Описание

bytes_in

Количество принятых данных в байтах

bytes_out

Количество переданных данных в байтах

messages_in

Количество принятых сообщений

messages_out

Количество отправленных сообщений

•Блок connect содержит информацию о сетевых подключениях к Серверу.

Элементы блока connect:

Название поля

Описание

current

Количество активных подключений в данный момент

maximum

Зафиксированный максимум одновременных подключений

total

Общее количество разрешенных подключений

•Блок db содержит информацию об использовании базы данных Сервера.

Элементы блока db:

Название поля

Описание

rows_read

Количество прочитанных строк

rows_written

Количество записанных строк

statements_fail

Количество неуспешных операторов

statements_ok

Количество успешных операторов

transactions_comitted

Количество завершенных транзакций

transactions_rolledback

Количество отмененных транзакций

•Блок fd содержит информацию об открытых файлых на Сервере.

Элементы блока fd:

Название поля

Описание

hard_limit

Жесткое ограничение количества открытых файлов

opened

Количество открытых файлов на Сервере

soft_limit

Рекомендуемое ограничение количества открытых файлов

Ограничения количества открытых файлов актуальны только для устройств под управлением UNIX-подобных ОС.

•Блок load_average содержит среднее значение загрузки системы за определенный период.

Элементы блока load_average:

Название поля

Описание

load1

Процент загрузки системы за 1 минуту

load15

Процент загрузки системы за 15 минут

load5

Процент загрузки системы за 5 минут

Среднее значение загрузки системы вычисляется только для устройств под управлением UNIX-подобных ОС. Для ОС Windows всегда возвращается значение "-1".

•Блок memory содержит информацию об оперативной памяти компьютера, на котором установлен Сервер.

Элементы блока memory:

Название поля

Описание

free

Объем свободной оперативной памяти

total

Общий объем оперативной памяти

used_by_server

Объем оперативной памяти, используемой Сервером

•Блок repository, содержит информацию о репозитории Сервера.

Элементы блока repository:

Название поля

Описание

bytes_in

Количество принятых данных в байтах

bytes_out

Количество переданных данных в байтах

files_added

Количество новых файлов

files_deleted

Количество удаленных файлов

files_replaced

Количество замененных файлов

http_fail

Количество неуспешных HTTP-запросов

http_ok

Количество успешных HTTP-запросов

•Блок vm содержит информацию об использовании системных ресурсов на компьютере с установленным Сервером.

Элементы блока vm:

Название поля

Описание

context_switches

Количество переключений контекста

cpu_kernel

Время работы процессора в режиме ядра

cpu_user

Время работы процессора в режиме пользователя

page_faults

Количество ошибок страниц

read_cnt

Количество чтений из памяти

threads

Количество запущенных потоков

virtual_memory

Объем виртуальной памяти, выделенной для Сервера в данный момент

working_set

Рабочий набор

write_cnt

Количество записей в память