Hc_cluster_statistics - Управление системой сбора статистики для кластера
Hc_cluster_statistics_add
Команда позволяет добавить новую задачу по сбору статистики для кластера.
Аналог команды в CoCon:
/cluster/mediator/<md>/statistics/add
Метод HTTP-запроса:
POST
Шаблон HTTP-запроса:
http://host:port/commands/cluster_statistics_add
Код HTTP-ответа:
При выполнении команды HTTP-терминал может ответить следующими сообщениями:
- 201 – в случае успеха;
- 404 – в случае ошибки.
XSD-схема XML-файла запроса/ответа:
<?xml version="1.0" encoding="UTF-8" ?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:simpleType name = "moduleType">
<xs:restriction base="xs:string">
<xs:enumeration value="e502Type1"/>
<xs:enumeration value="e502Type10"/>
<xs:enumeration value="e502Type11"/>
<xs:enumeration value="e502Type12"/>
<xs:enumeration value="e502Type15"/>
<xs:enumeration value="e502Type16"/>
<xs:enumeration value="e502Type2"/>
<xs:enumeration value="e502Type20"/>
<xs:enumeration value="e502Type3"/>
<xs:enumeration value="e502Type4"/>
<xs:enumeration value="e502Type5"/>
<xs:enumeration value="e502Type6"/>
<xs:enumeration value="e502Type9"/>
<xs:enumeration value="hostResources"/>
<xs:enumeration value="mgTraffic"/>
<xs:enumeration value="q752Table1"/>
<xs:enumeration value="q752Table15"/>
<xs:enumeration value="q752Table2"/>
<xs:enumeration value="q752Table3"/>
<xs:enumeration value="q752Table4"/>
<xs:enumeration value="q752Table5"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name = "exportNameType">
<xs:restriction base="xs:string">
<xs:enumeration value="txt_file_export">
<xs:annotation>
<xs:documentation xml:lang="en">
For txt_file_export should be set 'stat' property.
</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="rpss_db_export">
<xs:annotation>
<xs:documentation xml:lang="en">
For rpss_db_export should be set 'connStringName', 'recoveryDir' properties.
</xs:documentation>
</xs:annotation>
</xs:enumeration>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="exportType">
<xs:attribute name="name" type="xs:string" use="required" />
<xs:attribute name="value" type="xs:string" use="required" />
</xs:complexType>
<xs:complexType name="filterType">
<xs:attribute name="name" type="xs:string" use="required" />
</xs:complexType>
<xs:complexType name="clusterType">
<xs:sequence>
<xs:element name="export" type="exportType" minOccurs="0" maxOccurs="unbounded" />
<xs:element name="filter" type="filterType" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="module" type="moduleType" use="required"/>
<xs:attribute name="interval" type="xs:integer" use="required"/>
<xs:attribute name="export" type="exportNameType" use="required"/>
</xs:complexType>
<xs:element name="in">
<xs:complexType>
<xs:all>
<xs:element name="cluster" type="clusterType" minOccurs="1"/>
</xs:all>
</xs:complexType>
</xs:element>
</xs:schema>
Пример 1:
Запрос: http://192.168.1.21:9999/commands/cluster_statistics_add
<?xml version="1.0" encoding="UTF-8"?>
<in
xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="cluster_statistics_add.xsd">
<cluster name="md1" module="e502Type1" interval="15" export="txt_file_export">
<export name="stat" value="/var/lib/ecss/statisics" />
<filter name="biysk.local" />
</cluster>
</in>
Ответ:201
Пример 2: (запись статистики в БД)
Запрос: http://192.168.1.21:9999/commands/cluster_statistics_add
<?xml version="1.0" encoding="UTF-8"?>
<in
xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="cluster_statistics_add.xsd">
<cluster name="md1" module="e502Type1" interval="10" export="rpss_db_export">
<export name="connStringName" value="stat_db" />
<export name="recoveryDir" value="/tmp" />
<filter name="biysk.local" />
</cluster>
</in>
Ответ:201
Hc_cluster_statistics_delete
Команда позволяет удалить задачу по сбору статистики в кластере.
Аналог команды в CoCon:
/cluster/mediator/<md>/statistics/delete
Метод HTTP-запроса:
POST
Шаблон HTTP-запроса: http://host:port/commands/cluster_statistics_delete
Код HTTP-ответа:
При выполнении команды HTTP-терминал может ответить следующими сообщениями:
- 204 – в случае успеха;
- 404 – в случае ошибки.
XSD-схема XML-файла запроса/ответа:
<?xml version="1.0" encoding="UTF-8" ?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexType name="clusterType">
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="id" type="xs:string" use="required"/>
</xs:complexType>
<xs:element name="in">
<xs:complexType>
<xs:all>
<xs:element name="cluster" type="clusterType" minOccurs="1"/>
</xs:all>
</xs:complexType>
</xs:element>
</xs:schema>
Пример:
Запрос: http://192.168.1.21:9999/commands/cluster_statistics_delete
<?xml version="1.0" encoding="UTF-8"?>
<in xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="domain_statistics_delete.xsd">
<cluster name="md1" id="65656461-6262-6236-3739-633230303936" />
</in>
Ответ:204
Hc_cluster_statistics_statmodinfo
Команда позволяет просмотреть информации по маппированию колонок в кластере.
Аналог команды в CoCon:
/cluster/mediator/<md>/statistics/statmodinfo <ModuleName> [-m]
Метод HTTP-запроса:
POST
Шаблон HTTP-запроса:
http://host:port/commands/cluster_statistics_statmodinfo
Код HTTP-ответа:
При выполнении команды HTTP-терминал может ответить следующими сообщениями:
- 200 – в случае успеха;
- 404 – в случае ошибки.
XSD-схема XML-файла запроса/ответа:
<?xml version="1.0" encoding="UTF-8" ?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexType name="clusterType">
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="module" type="xs:string" use="required"/>
<xs:attribute name="flag" type="xs:string" use="optional"/>
</xs:complexType>
<xs:complexType name="column1Type">
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="type" type="xs:string" use="required"/>
<xs:attribute name="constrait" type="xs:string" use="optional"/>
<xs:attribute name="description" type="xs:string" use="required"/>
</xs:complexType>
<xs:complexType name="columnsType">
<xs:sequence>
<xs:element name="column" type="column1Type" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="description" type="xs:string" use="required"/>
</xs:complexType>
<xs:complexType name="column2Type">
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="new_name" type="xs:string" use="required"/>
</xs:complexType>
<xs:complexType name="columns2Type">
<xs:sequence>
<xs:element name="column" type="column2Type" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:element name="in">
<xs:complexType>
<xs:all>
<xs:element name="cluster" type="clusterType" minOccurs="1" maxOccurs="1"/>
</xs:all>
</xs:complexType>
</xs:element>
<xs:element name="out">
<xs:complexType>
<xs:choice>
<xs:element name="columns" type="columnsType" />
<xs:element name="m_columns" type="columns2Type" />
</xs:choice>
</xs:complexType>
</xs:element>
</xs:schema>
Пример:
Запрос: http://192.168.1.21:9999/commands/cluster_statistics_statmodinfo
<?xml version="1.0" encoding="UTF-8"?>
<in
xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="cluster_statistics_statmodinfo.xsd">
<cluster name="md1" module="e502Type10" flag="-m"/>
</in>
Ответ:
200 ok
<?xml version="1.0"?>
<out
xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="cluster_statistics_statmodinfo.xsd">
<m_columns/>
</out>
Запрос: http://192.168.1.21:9999/commands/cluster_statistics_statmodinfo
<?xml version="1.0" encoding="UTF-8"?>
<in
xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="cluster_statistics_statmodinfo.xsd">
<cluster module="e502Type1" name="md1" />
</in>
Ответ:
200 ok
<?xml version="1.0"?>
<out
xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="cluster_statistics_statmodinfo.xsd">
<columns description="Overall measurements on originating traffic">
<column name="seizures" type="integer" constrait="undefined" description="Number of originating seizures"/>
<column name="notRouted" type="integer" constrait="undefined" description="Number of call attempts not routed due to: no dialling, incomplete dialling, invalid address"/>
<column name="congestion" type="integer" constrait="undefined" description="Number of call attempts lost due to internal congestion"/>
</columns>
</out>
Hc_cluster_statistics_addcolmap
Команда позволяет добавить маппирования колонок в кластере.
Аналог команды в CoCon:
/cluster/mediator/<md>/statistics/addcolmap
Метод HTTP-запроса:
POST
Шаблон HTTP-запроса:
http://host:port/commands/cluster_statistics_addcolmap
Код HTTP-ответа:
При выполнении команды HTTP-терминал может ответить двумя сообщениями:
- 201 – в случае успеха;
- 404 – в случае ошибки.
XSD-схема XML-файла запроса/ответа:
<?xml version="1.0" encoding="UTF-8" ?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:simpleType name = "moduleType">
<xs:restriction base="xs:string">
<xs:enumeration value="e502Type1"/>
<xs:enumeration value="e502Type10"/>
<xs:enumeration value="e502Type11"/>
<xs:enumeration value="e502Type12"/>
<xs:enumeration value="e502Type15"/>
<xs:enumeration value="e502Type16"/>
<xs:enumeration value="e502Type2"/>
<xs:enumeration value="e502Type20"/>
<xs:enumeration value="e502Type3"/>
<xs:enumeration value="e502Type4"/>
<xs:enumeration value="e502Type5"/>
<xs:enumeration value="e502Type6"/>
<xs:enumeration value="e502Type9"/>
<xs:enumeration value="hostResources"/>
<xs:enumeration value="mgTraffic"/>
<xs:enumeration value="q752Table1"/>
<xs:enumeration value="q752Table15"/>
<xs:enumeration value="q752Table2"/>
<xs:enumeration value="q752Table3"/>
<xs:enumeration value="q752Table4"/>
<xs:enumeration value="q752Table5"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="clusterType">
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="module" type="moduleType" use="required"/>
<xs:attribute name="column" type="xs:string" use="required"/>
<xs:attribute name="new_column" type="xs:string" use="required"/>
</xs:complexType>
<xs:element name="in">
<xs:complexType>
<xs:all>
<xs:element name="cluster" type="clusterType" minOccurs="1"/>
</xs:all>
</xs:complexType>
</xs:element>
</xs:schema>
Пример:
Запрос: http://192.168.1.21:9999/commands/cluster_statistics_addcolmap
<?xml version="1.0" encoding="UTF-8"?>
<in xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="cluster_statistics_addcolmap.xsd">
<cluster name="md1" module="e502Type1" column="notRouted" new_column="route_error" />
</in>
Ответ:
201
Hc_cluster_statistics_delcolmap
Команда позволяет удалить маппирования колонок в кластере.
Аналог команды в CoCon:
/cluster/mediator/<md>/statistics/delcolmap
Метод HTTP-запроса:
POST
Шаблон HTTP-запроса:
http://host:port/commands/cluster_statistics_delcolmap
Код HTTP-ответа:
При выполнении команды HTTP-терминал может ответить следующими сообщениями:
- 204 – в случае успеха;
- 404 – в случае ошибки.
XSD-схема XML-файла запроса/ответа:
<?xml version="1.0" encoding="UTF-8" ?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexType name="clusterType">
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="module" type="xs:string" use="required"/>
<xs:attribute name="column" type="xs:string" use="required"/>
</xs:complexType>
<xs:element name="in">
<xs:complexType>
<xs:all>
<xs:element name="cluster" type="clusterType" minOccurs="1"/>
</xs:all>
</xs:complexType>
</xs:element>
</xs:schema>
Пример:
Запрос: http://192.168.1.21:9999/commands/cluster_statistics_delcolmap
<?xml version="1.0" encoding="UTF-8"?>
<in xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="cluster_statistics_delcolmap.xsd">
<cluster name="md1" module="e502Type1" column="notRouted"/>
</in>
Ответ:204
Hc_cluster_statistics_list
Команда позволяет получить список задач по сбору статистики в кластере.
Аналог команды в CoCon:
/cluster/mediator/<md>/statistics/list
Метод HTTP-запроса:
POST
Шаблон HTTP-запроса:
http://host:port/commands/cluster_statistics_list
Код HTTP-ответа:
При выполнении команды HTTP-терминал может ответить следующими сообщениями:
- 200 – в случае успеха;
- 404 – в случае ошибки.
XSD-схема XML-файла запроса/ответа:
<?xml version="1.0" encoding="UTF-8" ?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexType name="clusterType">
<xs:attribute name="name" type="xs:string" use="required"/>
</xs:complexType>
<xs:simpleType name = "moduleType">
<xs:restriction base="xs:string">
<xs:enumeration value="e502Type1"/>
<xs:enumeration value="e502Type10"/>
<xs:enumeration value="e502Type11"/>
<xs:enumeration value="e502Type12"/>
<xs:enumeration value="e502Type15"/>
<xs:enumeration value="e502Type16"/>
<xs:enumeration value="e502Type2"/>
<xs:enumeration value="e502Type20"/>
<xs:enumeration value="e502Type3"/>
<xs:enumeration value="e502Type4"/>
<xs:enumeration value="e502Type5"/>
<xs:enumeration value="e502Type6"/>
<xs:enumeration value="e502Type9"/>
<xs:enumeration value="hostResources"/>
<xs:enumeration value="mgTraffic"/>
<xs:enumeration value="q752Table1"/>
<xs:enumeration value="q752Table15"/>
<xs:enumeration value="q752Table2"/>
<xs:enumeration value="q752Table3"/>
<xs:enumeration value="q752Table4"/>
<xs:enumeration value="q752Table5"/>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="idType">
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="module" type="moduleType" use="required"/>
<xs:attribute name="interval" type="xs:integer" use="required"/>
<xs:attribute name="start_time" type="xs:string" use="required"/>
<xs:attribute name="end_time" type="xs:string" use="required"/>
<xs:attribute name="exports" type="xs:string" use="required"/>
</xs:complexType>
<xs:element name="in">
<xs:complexType>
<xs:all>
<xs:element name="cluster" type="clusterType" minOccurs="1" maxOccurs="1"/>
</xs:all>
</xs:complexType>
</xs:element>
<xs:element name="out">
<xs:complexType>
<xs:sequence>
<xs:element name="id" type="idType" minOccurs="0" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
Пример:
Запрос: http://192.168.1.21:9999/commands/cluster_statistics_list
<?xml version="1.0" encoding="UTF-8"?>
<in xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="cluster_group_list.xsd">
<cluster name="md1" />
</in>
Ответ:
<?xml version="1.0"?>
<out
xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="cluster_statistics_list.xsd">
<id name="30363235-3262-3231-3163-333732343163" module="e502Type1" interval="900" start_time="2019/11/08 08:30:57" end_time="undefined" exports="txt_file_export"/>
</out>