Versions Compared

Old Version 1

changes.mady.by.user Vladimir Tayzhev

Saved on

compared with

New Version Current

changes.mady.by.user Technical Service Specialist

Saved on

Key

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

Для управления используются следующие запросыThe following queries are used for management:

addtrap - добавить уведомление по add SNMP notification. Дополнительные параметрыExtra options are:

  • k - идентификатор сессии пользователяuser session ID;
  • id - идентификатор уведомления по SNMP, если идентификатор отсутствует - создается новое уведомление, иначе - редактируется существующееSNMP notification ID, if there is no identifier, a new notification is created, otherwise the existing one is edited;
  • name - имя уведомления по name of SNMP , длина не более 63 символовnotification, length is not more than 63 characters;
  • server - SNMP сервер, длина не более 127 символовserver, no more than 127 characters;
  • port - порт службы SNMP на сервереthe SNMP service port on the server;
  • version - версия version of SNMP, возможные значения possible values ​​- 1, 2c, 3;
  • comunity - сообщество SNMP community (для версии for version 1, 2c), длина не более 31 символаthe length is not more than 31 characters;
  • user - имя пользователя (для версии user name (for version 3), длина не более 63 символовlength is not more than 63 characters;
  • level - уровень безопасности (для версии security level (for version 3), возможные значенияpossible values:
    • noauth - без авторизации и шифрованияwithout authorization and encryption;
    • auth - только авторизацияonly authorization;
    • priv - авторизация и шифрованиеauthorization and encryption;
  • auth_type - тип авторизации (для версии type of authorization (for version 3), возможные значения - possible values ​​are MD5, SHA;
  • auth_pass - пароль авторизации (для версии authorization password (for version 3), длина не более 63 символовlength is not more than 63 characters;
  • priv_type - тип шифрования (для версии type of encryption (for version 3), возможные значения possible values ​​- DES, AES;
  • priv_pass - пароль шифрования (для версии encryption password (for version 3), длина не более 63 символовlength is not more than 63 characters;
  • message - шаблон текста сообщения, длина не более 1023 символов, может не вводиться, тогда используется текст по умолчанию.

...

  • message text template, no more than 1023 characters in length; can be left empty, then the default text is used;
  • severity - severity level of the message (default warning):
    • emergency - system is unusable;
    • alert - action must be taken immediately;
    • critical - critical conditions;
    • error - error conditions;
    • warning - warning conditions;
    • notice - normal but significant condition;
    • informational - informational messages;
    • debug - debug-level messages.


If a new element is successfully created, the response contains the element identifier, and looks like:

<error type="no error" id="602001" />

При создании нового уведомления (id не указывается), обязательными являются параметры When creating a new notification (id is not specified), the parameters - name, server, port, version, остальные параметры указываются в зависимости от конфигурации версии are mandatory, other parameters are specified depending on the configuration of the version of SNMP (version) и уровня безопасности and the level of security (level). При изменении чувствительных параметров If you change the sensitive parameters (version и and level), необходимо явно указывать зависимые параметры, при этом неиспользуемые параметры будут стерты (например при version=3 и you must explicitly specify the dependent parameters, while the unused parameters will be erased (for example, if version=3 and level=auth, будут стерты неиспользуемые параметры unused comunity, priv_type и and priv_pass). Пустые параметры подразумевают стирание ранее присвоенного значения, кроме параметров parameters will be erased). Empty parameters imply erasing a previously assigned value, except for the parameters - name, server, port, version, для них пустые поля не допускаютсяfor which empty fields are not allowed.


deltrap - удалить уведомление по delete the notification by SNMP. Обязательные параметрыRequired parameters are:

  • k - идентификатор сессии пользователяuser session ID;
  • id - идентификатор уведомления по SNMP notification identifier.


testmessage - отправка тестового сообщения, при этом не создается новый элемент. Дополнительные параметрыsend a test message, without creating a new element. Extra options:

  • k - идентификатор сессии пользователяuser session ID;
  • type - тип тестового уведомления type of test notification (trap);
  • name - имя уведомления по name of SNMP , длина не более 63 символовnotification, length is not more than 63 characters;
  • server - SNMP сервер, длина не более 127 символовserver, no more than 127 characters;
  • port - порт службы SNMP на сервереthe SNMP service port on the server;
  • version - версия version of SNMP, возможные значения possible values ​​- 1, 2c, 3;
  • comunity - сообщество SNMP community (для версии for version 1, 2c), длина не более 31 символаthe length is not more than 31 characters;
  • user - имя пользователя (для версии user name (for version 3), длина не более 63 символовlength is not more than 63 characters;
  • level - уровень безопасности (для версии security level (for version 3), возможные значенияpossible values are:
    • noauth - без авторизации и шифрованияwithout authorization and encryption;
    • auth - только авторизацияonly authorization;
    • priv - авторизация и шифрованиеauthorization and encryption;
  • auth_type - тип авторизации (для версии type of authorization (for version 3), возможные значения - possible values ​​are MD5, SHA;
  • auth_pass - пароль авторизации (для версии authorization password (for version 3), длина не более 63 символовlength is not more than 63 characters;
  • priv_type - тип шифрования (для версии type of encryption (for version 3), возможные значения possible values ​​- DES, AES;
  • priv_pass - пароль шифрования (для версии encryption password (for version 3), длина не более 63 символовlength is not more than 63 characters;
  • message - шаблон текста сообщения, длина не более 1023 символов, может не вводиться, тогда используется текст по умолчаниюmessage text template, no more than 1023 characters in length; can be left empty, then the default text is used;
  • severity - severity level of the message.


getelement - чтение элемента. Обязательные параметрыread the element. Required parameters are:

  • k - идентификатор сессии пользователяuser session ID;
  • id - идентификатор элемента.

...

  • element ID.

The response contains information about the element:

<element id="602001" module="2004" num="1" clas="notifier" type="snmp trap" name="my_trap" state="off" server="192.168.0.55" port="162" 
version="3" comunity=""  user="admin" level="auth"  auth_type="SHA" auth_pass="somepass"  priv_type="" priv_pass=""  
message="Time: %3 Logic: %4, Element: %5, in state: %6, value: %7" severity="warning" />