README

Zabbix sender 是 Zabbix sender 协议的 PHP 实现。使用这个库，您可以发送任何指标到 Zabbix 服务器。有关 Zabbix sender 协议和请求/响应的更多信息，可以在官方文档中找到

• https://www.zabbix.com/documentation/3.4/manual/appendix/items/trapper
• https://www.zabbix.com/documentation/3.4/manual/appendix/protocols/header_datalen

安装

composer require zarplata/zabbix-sender

使用方法

<?php

use \Zarplata\Zabbix\ZabbixSender;
use \Zarplata\Zabbix\Request\Packet as ZabbixPacket;
use \Zarplata\Zabbix\Request\Metric as ZabbixMetric;

// At first you must initialize ZabbixSender object
// with address of Zabbix Server. If your Zabbix Server
// don't listen default port (10051) you can define it in constructor
// $sender = new ZabbixSender(
//     $serverAddress='ZABBIX_SERVER_HOSTNAME',
//     $serverPort=12345
// );
$sender = new ZabbixSender('ZABBIX_SERVER_HOSTNAME');

// After you define the $sender you must create ZabbixPacket
// it's just accumulator of your metrics which you will add.
$packet = new ZabbixPacket();

// Define your metrinc
$packet->addMetric(new ZabbixMetric('my.super.text.item.key', 'OK'));
$packet->addMetric(new ZabbixMetric('my.super.int.item.key', 1));

// And finally send to Zabbix Server
$sender->send($packet);

高级使用选项

有时可能需要提供主机名和/或指标的时间戳。默认构造函数

<?php

new ZabbixMetric('my.super.text.item.key', 'OK');

使用您当前的主机名并将对象创建时间设置为指标的时间戳。如果您想定义另一个主机名或/和时间戳，您必须编写以下代码

<?php

(new ZabbixMetric('my.super.text.item.key', 'OK'))
    ->withHostname('my_non_local_hostname')
    ->withTimestamp(662637600); //Timestamp in past 

许可证

MIT.