** Copyright (C) 2001-2023 Zabbix SIA
** This program is free software; you can redistribute it and/or modify
** it under the terms of the GNU General Public License as published by
** the Free Software Foundation; either version 2 of the License, or
** (at your option) any later version.
** This program is distributed in the hope that it will be useful,
** but WITHOUT ANY WARRANTY; without even the implied warranty of
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
** GNU General Public License for more details.
** You should have received a copy of the GNU General Public License
** along with this program; if not, write to the Free Software
** Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
"git.zabbix.com/ap/plugin-support/conf"
"git.zabbix.com/ap/plugin-support/plugin"
"zabbix.com/internal/agent"
"zabbix.com/pkg/itemutil"
plugin.SystemOptions `conf:"optional"`
MaxLinesPerSecond int `conf:"range=1:1000,default=20"`
func (p *Plugin) Configure(global *plugin.GlobalOptions, options interface{}) {
if err := conf.Unmarshal(options, &p.options); err != nil {
p.Warningf("cannot unmarshal configuration options: %s", err)
zbxlib.SetMaxLinesPerSecond(p.options.MaxLinesPerSecond)
func (p *Plugin) Validate(options interface{}) error {
return conf.Unmarshal(options, &o)
func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error) {
if ctx == nil || ctx.ClientID() <= agent.MaxBuiltinClientID {
return nil, fmt.Errorf(`The "%s" key is not supported in test or single passive check mode`, key)
data = &metadata{key: key, params: params}
runtime.SetFinalizer(data, func(d *metadata) { zbxlib.FreeActiveMetric(d.blob) })
if data.blob, err = zbxlib.NewActiveMetric(key, params, meta.LastLogsize(), meta.Mtime()); err != nil {
data = meta.Data.(*metadata)
if !itemutil.CompareKeysParams(key, params, data.key, data.params) {
zbxlib.FreeActiveMetric(data.blob)
// recreate if item key has been changed
if data.blob, err = zbxlib.NewActiveMetric(key, params, meta.LastLogsize(), meta.Mtime()); err != nil {