int zbx_module_api_version(void);

int zbx_module_init(void);

ZBX_METRIC *zbx_module_item_list(void);

void zbx_module_item_timeout(int timeout);

ZBX_HISTORY_WRITE_CBS zbx_module_history_write_cbs(void);

int zbx_module_uninit(void);

typedef struct
       {
           char *key;
           unsigned flags;
           int (*function)();
           char *test_param;
       }
       ZBX_METRIC;

static ZBX_METRIC keys[] =
       {
           { "dummy.random", CF_HAVEPARAMS, zbx_module_dummy_random, "1,1000" },
           {NULL}
       }

int zbx_module_dummy_random(AGENT_REQUEST *request, AGENT_RESULT *result)
       {
           ...
       
           SET_UI64_RESULT(result, from + rand() % (to - from + 1));
       
           return SYSINFO_RET_OK;
       }

typedef struct
       {
           void  (*history_float_cb)(const ZBX_HISTORY_FLOAT *history, int history_num);
           void  (*history_integer_cb)(const ZBX_HISTORY_INTEGER *history, int history_num);
           void  (*history_string_cb)(const ZBX_HISTORY_STRING *history, int history_num);
           void  (*history_text_cb)(const ZBX_HISTORY_TEXT *history, int history_num);
           void  (*history_log_cb)(const ZBX_HISTORY_LOG *history, int history_num);
       }
       ZBX_HISTORY_WRITE_CBS;

typedef struct
       {
           zbx_uint64_t  itemid;
           int  clock;
           int  ns;
           double  value;
       }
       ZBX_HISTORY_FLOAT;
       
       typedef struct
       {
           zbx_uint64_t  itemid;
           int  clock;
           int  ns;
           zbx_uint64_t  value;
       }
       ZBX_HISTORY_INTEGER;
       
       typedef struct
       {
           zbx_uint64_t  itemid;
           int  clock;
           int  ns;
           const char  *value;
       }
       ZBX_HISTORY_STRING;
       
       typedef struct
       {
           zbx_uint64_t  itemid;
           int  clock;
           int  ns;
           const char  *value;
       }
       ZBX_HISTORY_TEXT;
       
       typedef struct
       {
           zbx_uint64_t  itemid;
           int  clock;
           int  ns;
           const char  *value;
           const char  *source;
           int  timestamp;
           int  logeventid;
           int  severity;
       }
       ZBX_HISTORY_LOG;

LoadModulePath=/usr/local/lib/zabbix/agent/
       LoadModule=mariadb.so
       LoadModule=apache.so
       LoadModule=kernel.so
       LoadModule=/usr/local/lib/zabbix/dummy.so

 alex@alex:~trunk/src/modules/dummy$ ls -l
        -rw-rw-r-- 1 alex alex 9019 Apr 24 17:54 dummy.c
        -rw-rw-r-- 1 alex alex67 Apr 24 17:54 Makefile
        -rw-rw-r-- 1 alex alex245 Apr 24 17:54 README

/*
       ** Zabbix
       ** Copyright (C) 2001-2020 Zabbix SIA
       **
       ** Овај програм је бесплатан софтвер; можете га редистрибуирати и/или модификовати
       ** под условима GNU Опште јавне лиценце коју је објавио
       ** Фондација за слободни софтвер; било верзију 2 лиценце, или
       ** (по вашој жељи) било коју каснију верзију.
       **
       ** Овај програм се дистрибуира у нади да ће бити користан,
       ** али БЕЗ ИКАКВЕ ГАРАНЦИЈЕ; чак и без подразумеване гаранције о
       ** ПРИЛИКА ЗА ПРОДАЈУ или ПРИКЛАДНОСТ ЗА ОДРЕЂЕНУ НАМЕНУ. Видите
       ** GNU General Public License за више детаља.
       **
       ** Требало је да добијете копију GNU General Public License
       ** уз овај програм; ако не, пишите слободном софтверу
       ** Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA02110-1301, USA.
       **/
       
       #include <stdlib.h>
       #include <string.h>
       #include <time.h>
       #include <stdint.h>
       
       #include "module.h"
       
       /*променљива задржава подешавање временског ограничења за обраду ставке*/
       static int  item_timeout = 0;
       
       /*модул ТРЕБА да дефинише унутрашње функције као статичке и да користи образац именовања различит од Zabbix интерног */
       /* symbols (zbx_*) и функције API модула које се могу учитати (zbx_module_*) да би се избегли конфликти  */
       static int  dummy_ping(AGENT_REQUEST *request, AGENT_RESULT *result);
       static int  dummy_echo(AGENT_REQUEST *request, AGENT_RESULT *result);
       static int  dummy_random(AGENT_REQUEST *request, AGENT_RESULT *result);
       
       static ZBX_METRIC keys[] =
       /*  KEY  FLAG  FUNCTION  TEST PARAMETERS */
       {
         {"dummy.ping",  0,  dummy_ping, NULL},
         {dummy.echo",  CF_HAVEPARAMS,  dummy_echo, "a message"},
         {"dummy.random",  CF_HAVEPARAMS,  dummy_random,  "1,1000"},
         {NULL}
       };
       
       /******************************************************************************
       *  *
       * Функција: zbx_module_api_version  *
       *  *
       * Сврха: враћа број верзије интерфејса модула  *
       *  *
       * Враћа вредности: ZBX_MODULE_API_VERSION - верзија module.h модул је  *
       *  компајлиран са, да би се модул успешно учитао Zabbix  *
       *  МОРА се компајлирати са истом верзијом ове датотеке заглавља  *
       *  *
       ******************************************************************************/
       int zbx_module_api_version(void)
       {
         return ZBX_MODULE_API_VERSION;
       }
       
       /******************************************************************************
       *  *
       * Функција: zbx_module_item_timeout  *
       *  *
       * Сврха: подешавање времена чекања за обраду ставки  *
       *  *
       * Параметри: timeout - временско ограничење у секундама, 0 - није подешено временско ограничење  *
       *  *
       ******************************************************************************/
       void  zbx_module_item_timeout(int timeout)
       {
         item_timeout = timeout;
       }
       
       /******************************************************************************
       *  *
       * Функција: zbx_module_item_list  *
       *  *
       * Сврха: враћа листу кључева ставки које подржава модул  *
       *  *
       * Повратна вредност: листа кључева ставки  *
       *  *
       ******************************************************************************/
       ZBX_METRIC  *zbx_module_item_list(void)
       {
         return keys;
       }
       
       static int  dummy_ping(AGENT_REQUEST *request, AGENT_RESULT *result)
       {
         SET_UI64_RESULT(result, 1);
       
         return SYSINFO_RET_OK;
       }
       
       static int  dummy_echo(AGENT_REQUEST *request, AGENT_RESULT *result)
       {
         char  *param;
       
         if (1 != request->nparam)
         {
         /* set optional error message */
         SET_MSG_RESULT(result, strdup("Invalid number of parameters."));
         return SYSINFO_RET_FAIL;
         }
       
         param = get_rparam(request, 0);
       
         SET_STR_RESULT(result, strdup(param));
       
         return SYSINFO_RET_OK;
       }
       
       /******************************************************************************
       *  *
       * Функција: dummy_random  *
       *  *
       * Сврха: главна улазна тачка за обраду ставке  *
       *  *
       * Параметри: захтев - структура која садржи кључ ставке и параметре  *
       *  request->key - item key without parameters  *
       *  request->nparam - number of parameters  *
       *  request->params[N-1] - pointers to item key parameters  *
       *  request->types[N-1] - item key parameters types:  *
       *  REQUEST_PARAMETER_TYPE_UNDEFINED (key parameter is empty) *
       *  REQUEST_PARAMETER_TYPE_ARRAY (array)  *
       *  REQUEST_PARAMETER_TYPE_STRING (quoted or unquoted string) *
       *  *
       *  result - structure that will contain result  *
       *  *
       * Return value: SYSINFO_RET_FAIL - function failed, item will be marked  *
       *  as not supported by zabbix  *
       *  SYSINFO_RET_OK - success  *
       *  *
       * Коментар: get_rparam(request, N-1) може се користити за добијање показивача на Nth  *
       *  параметар који почиње од 0 (први параметар). Уверите се да постоји  *
       *  провером вредности од request->nparam.  *
       *  На исти начин се може користити get_rparam_type(request, N-1)  *
       *   добити тип параметра.  *
       *  *
       ******************************************************************************/
       static int  dummy_random(AGENT_REQUEST *request, AGENT_RESULT *result)
       {
         char  *param1, *param2;
         int from, to;
       
         if (2 != request->nparam)
         {
         /* set optional error message */
         SET_MSG_RESULT(result, strdup("Invalid number of parameters."));
         return SYSINFO_RET_FAIL;
         }
       
         param1 = get_rparam(request, 0);
         param2 = get_rparam(request, 1);
       
         /* there is no strict validation of parameters and types for simplicity sake */
         from = atoi(param1);
         to = atoi(param2);
       
         if (from > to)
         {
         SET_MSG_RESULT(result, strdup("Invalid range specified."));
         return SYSINFO_RET_FAIL;
         }
       
         SET_UI64_RESULT(result, from + rand() % (to - from + 1));
       
         return SYSINFO_RET_OK;
       }
       
       /******************************************************************************
       *  *
       * Функција: zbx_module_init  *
       *  *
       * Сврха: функција се позива при покретању агента *
       *  Требало би да се користи за позивање било које рутине за иницијализацију  *
       *  *
       * Повратна вредност: ZBX_MODULE_OK - успех  *
       *  ZBX_MODULE_FAIL - иницијализација модула није успела  *
       *  *
       * Коментар: модул се неће учитати у случају ZBX_MODULE_FAIL  *
       *  *
       ******************************************************************************/
       int zbx_module_init(void)
       {
         /* initialization for dummy.random */
         srand(time(NULL));
       
         return ZBX_MODULE_OK;
       }
       
       /******************************************************************************
       *  *
       * Функција: zbx_module_uninit  *
       *  *
       * Сврха: функција се позива при гашењу агента  *
       *  Требало би да се користи за чишћење коришћених ресурса ако их има  *
       *  *
       * Повратна вредност: ZBX_MODULE_OK - успех  *
       *  ZBX_MODULE_FAIL - функција није успела  *
       *  *
       ******************************************************************************/
       int zbx_module_uninit(void)
       {
         return ZBX_MODULE_OK;
       }
       
       /******************************************************************************
       *  *
       * Функција: dummy_history_float_cb  *
       *  dummy_history_integer_cb  *
       *  dummy_history_string_cb  *
       *  dummy_history_text_cb  *
       *  dummy_history_log_cb  *
       *  *
       * Сврха: функције повратног позива за складиштење историјских података типа флоат,  *
       *  цео број, стринг, текст и дневник у спољној меморији  *
       *  *
       * Параметри: историја  - низ историјских података  *
       *  history_num - број елемената у низу историје  *
       *  *
       ******************************************************************************/
       static void dummy_history_float_cb(const ZBX_HISTORY_FLOAT *history, int history_num)
       {
         int i;
       
         for (i = 0; i < history_num; i++)
         {
         /* уради нешто са history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */
         }
       }
       
       static void dummy_history_integer_cb(const ZBX_HISTORY_INTEGER *history, int history_num)
       {
         int i;
       
         for (i = 0; i < history_num; i++)
         {
         /* уради нешто са history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */
         }
       }
       
       static void dummy_history_string_cb(const ZBX_HISTORY_STRING *history, int history_num)
       {
         int i;
       
         for (i = 0; i < history_num; i++)
         {
         /* уради нешто са history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */
         }
       }
       
       static void dummy_history_text_cb(const ZBX_HISTORY_TEXT *history, int history_num)
       {
         int i;
       
         for (i = 0; i < history_num; i++)
         {
         /* уради нешто са history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */
         }
       }
       
       static void dummy_history_log_cb(const ZBX_HISTORY_LOG *history, int history_num)
       {
         int i;
       
         for (i = 0; i < history_num; i++)
         {
         /* уради нешто са history[i].itemid, history[i].clock, history[i].ns, history[i].value, ... */
         }
       }
       
       /******************************************************************************
       *  *
       * Функција: zbx_module_history_write_cbs  *
       *  *
       * Сврха: враћа скуп функција модула које ће Zabbix позвати за извоз  *
       *  различите врсте историјских података  *
       *  *
       * Повратна вредност: структура са показивачима функције повратног позива (може бити NULL ако  *
       *  модул не занимају подаци одређених типова)  *
       *  *
       ******************************************************************************/
       ZBX_HISTORY_WRITE_CBS  zbx_module_history_write_cbs(void)
       {
         static ZBX_HISTORY_WRITE_CBS  dummy_callbacks =
         {
         dummy_history_float_cb,
         dummy_history_integer_cb,
         dummy_history_string_cb,
         dummy_history_text_cb,
         dummy_history_log_cb,
         };
       
         return dummy_callbacks;
       }