zabbix_sender_api 1.1.2 → 1.1.4

data/public/ZabbixSenderApi.html

@@ -6,7 +6,7 @@
 <title>
   Module: ZabbixSenderApi
   
-    &mdash; Documentation by YARD 0.9.26
+    &mdash; Documentation by YARD 0.9.36
   
 </title>
 
@@ -107,7 +107,7 @@
         <dt id="VERSION-constant" class="">VERSION =
           
         </dt>
-        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>1.1.2</span><span class='tstring_end'>&quot;</span></span></pre></dd>
+        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>1.1.4</span><span class='tstring_end'>&quot;</span></span></pre></dd>
       
     </dl>
   
@@ -123,9 +123,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Sep 11 00:00:06 2021 by
-  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.26 (ruby-2.7.4).
+  Generated on Fri Jan  3 16:13:55 2025 by
+  <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.36 (ruby-3.2.2).
 </div>
 
     </div>

data/public/_index.html

@@ -4,7 +4,7 @@
     <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <title>
-  Documentation by YARD 0.9.26
+  Documentation by YARD 0.9.36
   
 </title>
 
@@ -52,7 +52,7 @@
         <div class="clear"></div>
       </div>
 
-      <div id="content"><h1 class="noborder title">Documentation by YARD 0.9.26</h1>
+      <div id="content"><h1 class="noborder title">Documentation by YARD 0.9.36</h1>
 <div id="listing">
   <h1 class="alphaindex">Alphabetic Index</h1>
   
@@ -63,6 +63,12 @@
     <li class="r1"><a href="index.html" title="README">README</a></li>
     
   
+    <li class="r2"><a href="file.CHANGELOG.html" title="CHANGELOG">CHANGELOG</a></li>
+    
+  
+    <li class="r1"><a href="file.LICENSE.html" title="LICENSE">LICENSE</a></li>
+    
+  
   </ul>
 
 <div class="clear"></div>
@@ -166,12 +172,12 @@
         </ul>
       
         
-        <ul id="alpha_P" class="alpha">
-          <li class="letter">P</li>
+        <ul id="alpha_N" class="alpha">
+          <li class="letter">N</li>
           <ul>
             
               <li>
-                <span class='object_link'><a href="Zabbix/Sender/Pipe.html" title="Zabbix::Sender::Pipe (class)">Pipe</a></span>
+                <span class='object_link'><a href="Zabbix/Sender/NanosecondItemData.html" title="Zabbix::Sender::NanosecondItemData (class)">NanosecondItemData</a></span>
                 
                   <small>(Zabbix::Sender)</small>
                 
@@ -184,6 +190,21 @@
           </td><td valign='top' width="33%">
           
         
+        <ul id="alpha_P" class="alpha">
+          <li class="letter">P</li>
+          <ul>
+            
+              <li>
+                <span class='object_link'><a href="Zabbix/Sender/Pipe.html" title="Zabbix::Sender::Pipe (class)">Pipe</a></span>
+                
+                  <small>(Zabbix::Sender)</small>
+                
+              </li>
+            
+          </ul>
+        </ul>
+      
+        
         <ul id="alpha_S" class="alpha">
           <li class="letter">S</li>
           <ul>
@@ -232,9 +253,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Sep 11 00:00:06 2021 by
-  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.26 (ruby-2.7.4).
+  Generated on Fri Jan  3 16:13:55 2025 by
+  <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.36 (ruby-3.2.2).
 </div>
 
     </div>

data/public/class_list.html

@@ -43,7 +43,7 @@
 
       <ul id="full_list" class="class">
         <li id="object_" class="odd"><div class="item" style="padding-left:30px"><span class='object_link'><a href="top-level-namespace.html" title="Top Level Namespace (root)">Top Level Namespace</a></span></div></li>
-<li id='object_Zabbix' class='even'><div class='item' style='padding-left:30px'><a class='toggle'></a> <span class='object_link'><a href="Zabbix.html" title="Zabbix (module)">Zabbix</a></span><small class='search_info'>Top Level Namespace</small></div><ul><li id='object_Zabbix::AgentConfiguration' class='collapsed odd'><div class='item' style='padding-left:45px'><span class='object_link'><a href="Zabbix/AgentConfiguration.html" title="Zabbix::AgentConfiguration (class)">AgentConfiguration</a></span> &lt; Object<small class='search_info'>Zabbix</small></div></li><li id='object_Zabbix::Sender' class='collapsed even'><div class='item' style='padding-left:45px'><a class='toggle'></a> <span class='object_link'><a href="Zabbix/Sender.html" title="Zabbix::Sender (module)">Sender</a></span><small class='search_info'>Zabbix</small></div><ul><li id='object_Zabbix::Sender::Batch' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Zabbix/Sender/Batch.html" title="Zabbix::Sender::Batch (class)">Batch</a></span> &lt; Object<small class='search_info'>Zabbix::Sender</small></div></li><li id='object_Zabbix::Sender::Connection' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Zabbix/Sender/Connection.html" title="Zabbix::Sender::Connection (class)">Connection</a></span> &lt; Object<small class='search_info'>Zabbix::Sender</small></div></li><li id='object_Zabbix::Sender::Discovery' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Zabbix/Sender/Discovery.html" title="Zabbix::Sender::Discovery (class)">Discovery</a></span> &lt; ItemData<small class='search_info'>Zabbix::Sender</small></div></li><li id='object_Zabbix::Sender::ItemData' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Zabbix/Sender/ItemData.html" title="Zabbix::Sender::ItemData (class)">ItemData</a></span> &lt; Object<small class='search_info'>Zabbix::Sender</small></div></li><li id='object_Zabbix::Sender::Pipe' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Zabbix/Sender/Pipe.html" title="Zabbix::Sender::Pipe (class)">Pipe</a></span> &lt; Connection<small class='search_info'>Zabbix::Sender</small></div></li><li id='object_Zabbix::Sender::Socket' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Zabbix/Sender/Socket.html" title="Zabbix::Sender::Socket (class)">Socket</a></span> &lt; Connection<small class='search_info'>Zabbix::Sender</small></div></li></ul></li></ul></li><li id='object_ZabbixSenderApi' class='odd'><div class='item' style='padding-left:30px'><a class='toggle'></a> <span class='object_link'><a href="ZabbixSenderApi.html" title="ZabbixSenderApi (module)">ZabbixSenderApi</a></span><small class='search_info'>Top Level Namespace</small></div><ul><li id='object_ZabbixSenderApi::Error' class='collapsed even'><div class='item' style='padding-left:45px'><span class='object_link'><a href="ZabbixSenderApi/Error.html" title="ZabbixSenderApi::Error (class)">Error</a></span> &lt; StandardError<small class='search_info'>ZabbixSenderApi</small></div></li></ul></li>
+<li id='object_Zabbix' class='even'><div class='item' style='padding-left:30px'><a class='toggle'></a> <span class='object_link'><a href="Zabbix.html" title="Zabbix (module)">Zabbix</a></span><small class='search_info'>Top Level Namespace</small></div><ul><li id='object_Zabbix::AgentConfiguration' class='collapsed odd'><div class='item' style='padding-left:45px'><span class='object_link'><a href="Zabbix/AgentConfiguration.html" title="Zabbix::AgentConfiguration (class)">AgentConfiguration</a></span> &lt; Object<small class='search_info'>Zabbix</small></div></li><li id='object_Zabbix::Sender' class='collapsed even'><div class='item' style='padding-left:45px'><a class='toggle'></a> <span class='object_link'><a href="Zabbix/Sender.html" title="Zabbix::Sender (module)">Sender</a></span><small class='search_info'>Zabbix</small></div><ul><li id='object_Zabbix::Sender::Batch' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Zabbix/Sender/Batch.html" title="Zabbix::Sender::Batch (class)">Batch</a></span> &lt; Object<small class='search_info'>Zabbix::Sender</small></div></li><li id='object_Zabbix::Sender::Connection' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Zabbix/Sender/Connection.html" title="Zabbix::Sender::Connection (class)">Connection</a></span> &lt; Object<small class='search_info'>Zabbix::Sender</small></div></li><li id='object_Zabbix::Sender::Discovery' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Zabbix/Sender/Discovery.html" title="Zabbix::Sender::Discovery (class)">Discovery</a></span> &lt; ItemData<small class='search_info'>Zabbix::Sender</small></div></li><li id='object_Zabbix::Sender::ItemData' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Zabbix/Sender/ItemData.html" title="Zabbix::Sender::ItemData (class)">ItemData</a></span> &lt; Object<small class='search_info'>Zabbix::Sender</small></div></li><li id='object_Zabbix::Sender::NanosecondItemData' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Zabbix/Sender/NanosecondItemData.html" title="Zabbix::Sender::NanosecondItemData (class)">NanosecondItemData</a></span> &lt; ItemData<small class='search_info'>Zabbix::Sender</small></div></li><li id='object_Zabbix::Sender::Pipe' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Zabbix/Sender/Pipe.html" title="Zabbix::Sender::Pipe (class)">Pipe</a></span> &lt; Connection<small class='search_info'>Zabbix::Sender</small></div></li><li id='object_Zabbix::Sender::Socket' class='collapsed'><div class='item' style='padding-left:60px'><span class='object_link'><a href="Zabbix/Sender/Socket.html" title="Zabbix::Sender::Socket (class)">Socket</a></span> &lt; Connection<small class='search_info'>Zabbix::Sender</small></div></li></ul></li></ul></li><li id='object_ZabbixSenderApi' class='odd'><div class='item' style='padding-left:30px'><a class='toggle'></a> <span class='object_link'><a href="ZabbixSenderApi.html" title="ZabbixSenderApi (module)">ZabbixSenderApi</a></span><small class='search_info'>Top Level Namespace</small></div><ul><li id='object_ZabbixSenderApi::Error' class='collapsed even'><div class='item' style='padding-left:45px'><span class='object_link'><a href="ZabbixSenderApi/Error.html" title="ZabbixSenderApi::Error (class)">Error</a></span> &lt; StandardError<small class='search_info'>ZabbixSenderApi</small></div></li></ul></li>
 
       </ul>
     </div>

data/public/file.CHANGELOG.html

@@ -0,0 +1,83 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>
+  File: CHANGELOG
+  
+    &mdash; Documentation by YARD 0.9.36
+  
+</title>
+
+  <link rel="stylesheet" href="css/style.css" type="text/css" />
+
+  <link rel="stylesheet" href="css/common.css" type="text/css" />
+
+<script type="text/javascript">
+  pathId = "CHANGELOG";
+  relpath = '';
+</script>
+
+
+  <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
+
+  <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
+
+
+  </head>
+  <body>
+    <div class="nav_wrap">
+      <iframe id="nav" src="file_list.html?1"></iframe>
+      <div id="resizer"></div>
+    </div>
+
+    <div id="main" tabindex="-1">
+      <div id="header">
+        <div id="menu">
+  
+    <a href="_index.html">Index</a> &raquo; 
+    <span class="title">File: CHANGELOG</span>
+  
+</div>
+
+        <div id="search">
+  
+    <a class="full_list_link" id="class_list_link"
+        href="class_list.html">
+
+        <svg width="24" height="24">
+          <rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
+        </svg>
+    </a>
+  
+</div>
+        <div class="clear"></div>
+      </div>
+
+      <div id="content"><div id='filecontents'><h1 id="section">1.1.0</h1>
+<ul>
+  <li>added native (socket based) sender logic (Zabbix::Sender::Socket).</li>
+  <li>changed Zabbix::Sender::Pipe’s open method from popen to Open3::popen3 to allow capture of stdout stderf and exitA</li>
+  <li>the Socket and Pipe .flush method returns status, sendBatchAtomic relays it from its internal call to flush
+# 1.1.1</li>
+  <li>added ability to override Zabbix::AgentConfiguration search path</li>
+  <li>cleaned up a few issues + the docs
+# 1.1.2</li>
+  <li>This is just a documentation fix.  rubydoc.info wasn’t generating docs from the gem properly so docs are now in a gitlab “pages” site.
+# 1.1.3</li>
+  <li>BUG fix for Discovery when using Socket mode.</li>
+</ul>
+</div></div>
+
+      <div id="footer">
+  Generated on Fri Jan  3 16:13:55 2025 by
+  <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.36 (ruby-3.2.2).
+</div>
+
+    </div>
+  </body>
+</html>

data/public/file.LICENSE.html

@@ -0,0 +1,70 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>
+  File: LICENSE
+  
+    &mdash; Documentation by YARD 0.9.36
+  
+</title>
+
+  <link rel="stylesheet" href="css/style.css" type="text/css" />
+
+  <link rel="stylesheet" href="css/common.css" type="text/css" />
+
+<script type="text/javascript">
+  pathId = "LICENSE";
+  relpath = '';
+</script>
+
+
+  <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
+
+  <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
+
+
+  </head>
+  <body>
+    <div class="nav_wrap">
+      <iframe id="nav" src="file_list.html?1"></iframe>
+      <div id="resizer"></div>
+    </div>
+
+    <div id="main" tabindex="-1">
+      <div id="header">
+        <div id="menu">
+  
+    <a href="_index.html">Index</a> &raquo; 
+    <span class="title">File: LICENSE</span>
+  
+</div>
+
+        <div id="search">
+  
+    <a class="full_list_link" id="class_list_link"
+        href="class_list.html">
+
+        <svg width="24" height="24">
+          <rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
+        </svg>
+    </a>
+  
+</div>
+        <div class="clear"></div>
+      </div>
+
+      <div id="content"><div id='filecontents'>The MIT License (MIT)<br/><br/>Copyright (c) 2020 Dave Parker<br/><br/>Permission is hereby granted, free of charge, to any person obtaining a copy<br/>of this software and associated documentation files (the &quot;Software&quot;), to deal<br/>in the Software without restriction, including without limitation the rights<br/>to use, copy, modify, merge, publish, distribute, sublicense, and/or sell<br/>copies of the Software, and to permit persons to whom the Software is<br/>furnished to do so, subject to the following conditions:<br/><br/>The above copyright notice and this permission notice shall be included in<br/>all copies or substantial portions of the Software.<br/><br/>THE SOFTWARE IS PROVIDED &quot;AS IS&quot;, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR<br/>IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,<br/>FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE<br/>AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER<br/>LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,<br/>OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN<br/>THE SOFTWARE.</div></div>
+
+      <div id="footer">
+  Generated on Fri Jan  3 16:13:55 2025 by
+  <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.36 (ruby-3.2.2).
+</div>
+
+    </div>
+  </body>
+</html>

data/public/file.README.html

@@ -6,7 +6,7 @@
 <title>
   File: README
   
-    &mdash; Documentation by YARD 0.9.26
+    &mdash; Documentation by YARD 0.9.36
   
 </title>
 
@@ -57,116 +57,135 @@
         <div class="clear"></div>
       </div>
 
-      <div id="content"><div id='filecontents'>
-<h1 id="label-zabbix_sender_api">zabbix_sender_api</h1>
+      <div id="content"><div id='filecontents'><h1 id="zabbixsenderapi-gem-versionhttpsbadgefuryiorbzabbixsenderapisvghttpsbadgefuryiorbzabbixsenderapi">zabbix_sender_api <a href="https://badge.fury.io/rb/zabbix_sender_api"><img src="https://badge.fury.io/rb/zabbix_sender_api.svg" alt="Gem Version" /></a></h1>
 
-<p>This gem provides a model for assembling and sending data to Zabbix via its sender/trapper mechanism. It works both with the zabbix_sender command line utility, or by itself using a socket connection to a trapper port direct from Ruby.</p>
+<p>This gem provides a model for assembling and sending data to Zabbix via its sender/trapper mechanism.  It works both with the zabbix_sender command line utility, or by itself using a socket connection to a trapper port direct from Ruby.</p>
 
-<p><strong>Detailed documentation for this library is at <a href="https://rubydoc.info/gems/zabbix_sender_api">rubydoc.info</a></strong></p>
+<p><strong>Detailed documentation for this library is <a href="https://svdasein.gitlab.io/zabbix_sender_api">»HERE«</a></strong></p>
+
+<p><strong>Source repository is <a href="https://gitlab.com/svdasein/zabbix_sender_api">»HERE«</a></strong></p>
 
 <p>Look at <a href="https://gitlab.com/svdasein/zfstozab/-/blob/master/exe/zabbix-zfs.rb">the source for the zfstozab gem</a> for a practical example how to use this api.</p>
 
-<p>zabbix_sender_api can send data to zabbix via one of two included connection types:  * zabbix_sender (this was the original and for quite some time only mode supported)  * TCP socket connection directly to a Zabbix “trapper” port (as of vers 1.1.0)</p>
+<p>zabbix_sender_api can send data to zabbix via one of two included connection types:</p>
+
+<ul>
+  <li>zabbix_sender (this was the original and for quite some time only mode supported)</li>
+  <li>TCP socket connection directly to a Zabbix “trapper” port (as of vers 1.1.0)</li>
+</ul>
 
-<h2 id="label-Installation">Installation</h2>
+<p>If you need to interact with the Zabbix REST API, you might also be interested in <a href="https://svdasein.gitlab.io/zabbix-api/">zabbix-api-simple</a></p>
+
+<h2 id="installation">Installation</h2>
 
 <pre class="code ruby"><code class="ruby">$ gem install zabbix_sender_api
 </code></pre>
 
-<h2 id="label-Usage">Usage</h2>
+<h2 id="usage">Usage</h2>
 
-<h3 id="label-Synopsis">Synopsis</h3>
+<h3 id="synopsis">Synopsis</h3>
+<p>```ruby
+#!/usr/bin/env ruby
+require ‘zabbix_sender_api’</p>
 
-<pre class="code ruby"><code class="ruby"><span class='comment'>#!/usr/bin/env ruby
-</span><span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>zabbix_sender_api</span><span class='tstring_end'>&#39;</span></span>
+<p>sender = Zabbix::Sender::Pipe.new</p>
 
-<span class='id identifier rubyid_sender'>sender</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="Zabbix.html" title="Zabbix (module)">Zabbix</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Zabbix/Sender.html" title="Zabbix::Sender (module)">Sender</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Zabbix/Sender/Pipe.html" title="Zabbix::Sender::Pipe (class)">Pipe</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="Zabbix/Sender/Pipe.html#initialize-instance_method" title="Zabbix::Sender::Pipe#initialize (method)">new</a></span></span>
+<p>rawdata = { :myFirstKey =&gt; 0, :mySecondKey =&gt; 100 }</p>
 
-<span class='id identifier rubyid_rawdata'>rawdata</span> <span class='op'>=</span> <span class='lbrace'>{</span> <span class='symbol'>:myFirstKey</span> <span class='op'>=&gt;</span> <span class='int'>0</span><span class='comma'>,</span> <span class='symbol'>:mySecondKey</span> <span class='op'>=&gt;</span> <span class='int'>100</span> <span class='rbrace'>}</span>
+<p>data = Zabbix::Sender::Batch.new</p>
 
-<span class='id identifier rubyid_data'>data</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="Zabbix.html" title="Zabbix (module)">Zabbix</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Zabbix/Sender.html" title="Zabbix::Sender (module)">Sender</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Zabbix/Sender/Batch.html" title="Zabbix::Sender::Batch (class)">Batch</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="Zabbix/Sender/Batch.html#initialize-instance_method" title="Zabbix::Sender::Batch#initialize (method)">new</a></span></span>
+<p>rawdata.each_pair {|key,value|
+  data.addItemData(key: key,value: value)
+}</p>
 
-<span class='id identifier rubyid_rawdata'>rawdata</span><span class='period'>.</span><span class='id identifier rubyid_each_pair'>each_pair</span> <span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span><span class='id identifier rubyid_value'>value</span><span class='op'>|</span>
-  <span class='id identifier rubyid_data'>data</span><span class='period'>.</span><span class='id identifier rubyid_addItemData'>addItemData</span><span class='lparen'>(</span><span class='label'>key:</span> <span class='id identifier rubyid_key'>key</span><span class='comma'>,</span><span class='label'>value:</span> <span class='id identifier rubyid_value'>value</span><span class='rparen'>)</span>
-<span class='rbrace'>}</span>
-
-<span class='id identifier rubyid_sender'>sender</span><span class='period'>.</span><span class='id identifier rubyid_sendBatchAtomic'>sendBatchAtomic</span><span class='lparen'>(</span><span class='id identifier rubyid_data'>data</span><span class='rparen'>)</span>
-</code></pre>
+<p>sender.sendBatchAtomic(data)
+```</p>
 
 <p>The above will execute zabbix_sender for you and send data into it as described above.</p>
 
 <p>Alternatively you can just</p>
 
-<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_puts'>puts</span> <span class='id identifier rubyid_data'>data</span><span class='period'>.</span><span class='id identifier rubyid_to_senderinput'>to_senderinput</span>
-</code></pre>
-
-<p>… and do whatever you want w/ the stdout</p>
+<p><code>ruby
+puts data.to_senderline
+</code>
+… and do whatever you want w/ the stdout</p>
 
 <p>To do low level discovery:</p>
 
-<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_disco'>disco</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="Zabbix.html" title="Zabbix (module)">Zabbix</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Zabbix/Sender.html" title="Zabbix::Sender (module)">Sender</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Zabbix/Sender/Discovery.html" title="Zabbix::Sender::Discovery (class)">Discovery</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="Zabbix/Sender/Discovery.html#initialize-instance_method" title="Zabbix::Sender::Discovery#initialize (method)">new</a></span></span><span class='lparen'>(</span><span class='label'>key:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>discoveryRuleKey</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
+<p>```ruby
+disco = Zabbix::Sender::Discovery.new(key: ‘discoveryRuleKey’)</p>
 
-<span class='id identifier rubyid_disco'>disco</span><span class='period'>.</span><span class='id identifier rubyid_add_entity'>add_entity</span><span class='lparen'>(</span><span class='symbol'>:SOMEUSEFULVALUE</span> <span class='op'>=&gt;</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>aValue</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='symbol'>:ANOTHERONE</span> <span class='op'>=&gt;</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>somethingElse</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
+<p>disco.add_entity(:SOMEUSEFULVALUE =&gt; ‘aValue’, :ANOTHERONE =&gt; ‘somethingElse’)</p>
 
-<span class='id identifier rubyid_data'>data</span><span class='period'>.</span><span class='id identifier rubyid_addDiscovery'>addDiscovery</span><span class='lparen'>(</span><span class='id identifier rubyid_disco'>disco</span><span class='rparen'>)</span>
-</code></pre>
+<p>data.addDiscovery(disco)</p>
 
-<h3 id="label-Under+the+hood">Under the hood</h3>
+<p>```</p>
 
-<h4 id="label-Zabbix-3A-3ASender-3A-3APipe+method-3A">Zabbix::Sender::Pipe method:</h4>
+<h3 id="under-the-hood">Under the hood</h3>
 
+<h4 id="zabbixsenderpipe-method">Zabbix::Sender::Pipe method:</h4>
 <p>The zabbix-sender cli utility provides a number of methods by which to insert data into zabbix.</p>
-<ul><li>
-<p>zabbix-sender … -s zabbixHostName -k keyName -o value (one k-v pair at a time)</p>
-</li><li>
-<p>zabbix-sender … -i - (series of kv pairs from stdin using zabbix-sender start time as timestamp)</p>
-</li><li>
-<p>zabbix-sender … -T -i - (series of kv pairs with their own embedded timestamps from stdin)</p>
-</li></ul>
 
-<p>In the latter two cases, the zabbix host name (the name of the host that zabbix is monitoring) is embedded in the stdin data.</p>
+<ul>
+  <li>zabbix-sender … -s zabbixHostName -k keyName -o value (one k-v pair at a time)</li>
+  <li>zabbix-sender … -i - (series of kv pairs from stdin using zabbix-sender start time as timestamp)</li>
+  <li>zabbix-sender … -T -i - (series of kv pairs with their own embedded timestamps from stdin)</li>
+</ul>
+
+<p>In the latter two cases, the zabbix host name (the name of the host that zabbix is monitoring) is embedded
+in the stdin data.</p>
 
-<p>In all cases it is presumed that the zabbix server or proxy to which data should be sent is specified. This can be done either by specifying it explicitly with the -z switch, or indirectly by pointing it to a zabbix sender configuration file with the -c switch. If you let zabbix_sender_api handle executing zabbix_sender, the target will be specified on the command line via the -z switch.</p>
+<p>In all cases it is presumed that the zabbix server or proxy to which data should be sent is specified.  This can
+be done either by specifying it explicitly with the -z switch, or indirectly by pointing it to a zabbix sender configuration
+file with the -c switch.  If you let zabbix_sender_api handle executing zabbix_sender, the target will be specified on the
+command line via the -z switch.</p>
 
 <p>zabbix_sender_api utilizes the -T -i - form, so the generated data lines look like this:</p>
 
-<pre class="code ruby"><code class="ruby">&quot;theHostBeingMonitored&quot; myFirstKey 1551719379 0
-&quot;theHostBeingMonitored&quot; mySecondKey 1551719379 100
-</code></pre>
+<p><code>
+"theHostBeingMonitored" myFirstKey 1551719379 0
+"theHostBeingMonitored" mySecondKey 1551719379 100
+</code></p>
 
-<p>The above lines will send data to two items associated with the host theHostBeingMonitored: myFirstKey gets the value 0, and mySecondKey gets the value 100. In both cases the time stamp is identical but it need not be (see the exe/example.rb for specifics).</p>
+<p>The above lines will send data to two items associated with the host theHostBeingMonitored: myFirstKey gets the value 0, and mySecondKey gets the value 100.  In both cases the
+time stamp is identical but it need not be (see the exe/example.rb for specifics).</p>
 
 <p>Low level discovery (LLD) is also possible with zabbix-sender; the format of the stdin data is not so pretty but zabbix_sender_api handles all that:</p>
 
-<pre class="code ruby"><code class="ruby">&quot;theHostBeingMonitored&quot; discoveryRuleKey 1551719797 {&quot;data&quot;:[{&quot;{#SOMEUSEFULVALUE}&quot;:&quot;aValue&quot;,&quot;{#ANOTHERONE}&quot;:&quot;somethingElse&quot;}]}
-</code></pre>
+<p><code>
+"theHostBeingMonitored" discoveryRuleKey 1551719797 {"data":[{"{#SOMEUSEFULVALUE}":"aValue","{#ANOTHERONE}":"somethingElse"}]}
+</code>
+The above line sends an LLD discovery structure (formatted as json) to the <a href="https://www.zabbix.com/documentation/4.0/manual/discovery/low_level_discovery#discovery_rule">discovery rule</a> whose key is discoveryRuleKey.  It describes one entity by passing the macro values
+#SOMEUSEFULVALUE and #ANOTHERONE to the discovery rule.  These ‘<a href="https://www.zabbix.com/documentation/4.0/manual/config/macros/lld_macros">lld macros</a>’ are available for use in item,trigger, and graph prototypes.</p>
 
-<p>The above line sends an LLD discovery structure (formatted as json) to the <a href="https://www.zabbix.com/documentation/4.0/manual/discovery/low_level_discovery#discovery_rule">discovery rule</a> whose key is discoveryRuleKey. It describes one entity by passing the macro values <a href="https://www.zabbix.com/documentation/4.0/manual/config/macros/lld_macros">#SOMEUSEFULVALUE} and #ANOTHERONE to the discovery rule. These ‘{lld macros</a>&#39; are available for use in item,trigger, and graph prototypes.</p>
+<p>If you wished to use the above lld to actually do some discovery, you’d set things up in zabbix roughly like this:</p>
 
-<p>If you wished to use the above lld to actually do some discovery, you&#39;d set things up in zabbix roughly like this:</p>
+<p><img src="images/Spectacle.Z29721.png" alt="Discovery rule configuration" />
+<img src="images/Spectacle.l29721.png" alt="Item prototype configuration" /></p>
 
-<p><img src="images/Spectacle.Z29721.png"> <img src="images/Spectacle.l29721.png"></p>
+<h4 id="zabbixsendersocket-method">Zabbix::Sender::Socket method:</h4>
 
-<h4 id="label-Zabbix-3A-3ASender-3A-3ASocket+method-3A">Zabbix::Sender::Socket method:</h4>
-
-<p>You can switch between using the Pipe(zabbix_sender) method and the Socket(direct to zabbix via tcp socket) method very simply. Just change:</p>
-
-<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_sender'>sender</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="Zabbix.html" title="Zabbix (module)">Zabbix</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Zabbix/Sender.html" title="Zabbix::Sender (module)">Sender</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Zabbix/Sender/Pipe.html" title="Zabbix::Sender::Pipe (class)">Pipe</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="Zabbix/Sender/Pipe.html#initialize-instance_method" title="Zabbix::Sender::Pipe#initialize (method)">new</a></span></span>
-</code></pre>
+<p>You can switch between using the Pipe(zabbix_sender) method and the Socket(direct to zabbix via tcp socket) method very simply.  Just change:</p>
 
-<p>to <code> sender = Zabbix::Sender::Socket.new </code></p>
+<p><code>
+sender = Zabbix::Sender::Pipe.new
+</code>
+to
+<code>
+sender = Zabbix::Sender::Socket.new
+</code></p>
 
-<p>If you were specifiying a path to zabbix_sender using the Pipe method, remove that. If you&#39;re using a socket other than 10051 on your server/proxy, you&#39;ll want to add the port: option</p>
+<p>If you were specifiying a path to zabbix_sender using the Pipe method, remove that.  If you’re using a socket other than 10051 on your server/proxy,  you’ll want to add the port: option</p>
 
-<p>The socket method doesn&#39;t support sending multiple batches between flushes, so you should just use sendBatchAtomic(aBatch) with the Socket method.</p>
+<p>The socket method doesn’t support sending multiple batches between flushes, so you should just use sendBatchAtomic(aBatch) with the Socket method.</p>
 
-<p>You don&#39;t have to change anything else - the rest of zabbix_sender_api works exactly the same with the Socket method, save for that it&#39;s arguably more efficient with system resources. The only drawback might be if zabbix changes the sender protocol. At that point until this library is update to support the change you can revert to the Pipe/zabbix_sender method if needed (if they change the command line switches radically there, changes will be required in this library as well).</p>
+<p>You don’t have to change anything else - the rest of zabbix_sender_api works exactly the same with the Socket method, save for that it’s arguably more efficient with system resources.  The only drawback might be if zabbix changes the sender protocol.  At that point until this library is update to support the change you can revert to the Pipe/zabbix_sender method if needed (if they change the command line switches radically there, changes will be required in this library as well).</p>
 </div></div>
 
       <div id="footer">
-  Generated on Sat Sep 11 00:00:06 2021 by
-  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.26 (ruby-2.7.4).
+  Generated on Fri Jan  3 16:13:55 2025 by
+  <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.36 (ruby-3.2.2).
 </div>
 
     </div>

data/public/file_list.html

@@ -49,6 +49,16 @@
   </li>
   
 
+  <li id="object_CHANGELOG" class="even">
+    <div class="item"><span class="object_link"><a href="file.CHANGELOG.html" title="CHANGELOG">CHANGELOG</a></span></div>
+  </li>
+  
+
+  <li id="object_LICENSE" class="odd">
+    <div class="item"><span class="object_link"><a href="file.LICENSE.html" title="LICENSE">LICENSE</a></span></div>
+  </li>
+  
+
 
       </ul>
     </div>

data/public/frames.html

@@ -2,13 +2,18 @@
 <html>
 <head>
   <meta charset="utf-8">
-	<title>Documentation by YARD 0.9.26</title>
+	<title>Documentation by YARD 0.9.36</title>
 </head>
 <script type="text/javascript">
-  var match = unescape(window.location.hash).match(/^#!(.+)/);
-  var name = match ? match[1] : 'index.html';
-  name = name.replace(/^(\w+):\/\//, '').replace(/^\/\//, '');
-  window.top.location = name;
+var mainUrl = 'index.html';
+try {
+    var match = decodeURIComponent(window.location.hash).match(/^#!(.+)/);
+    var name = match ? match[1] : mainUrl;
+    var url = new URL(name, location.href);
+    window.top.location.replace(url.origin === location.origin ? name : mainUrl);
+} catch (e) {
+    window.top.location.replace(mainUrl);
+}
 </script>
 <noscript>
   <h1>Oops!</h1>