Smdn.Net.MuninNode is a .NET implementation of Munin-Node and Munin-Plugin.
This library provides Munin-Node implementation for .NET, which enables to you to create custom Munin-Node using the .NET languages and libraries.
This library also provides abstraction APIs for implementing Munin-Plugin. By using Munin-Plugin APIs in combination with the Munin-Node implementation, you can implement the function of collecting various kind of telemetry data using Munin, with .NET.
This library has two major namespaces. In the Smdn.Net.MuninNode namespace, there is a NodeBase class, which provides abstract Munin-Node implementation. For most purposes, the LocalNode class can be used, such as creating a Munin-Node that runs on the same host as the Munin server.
In the Smdn.Net.MuninPlugin namespace, there is a IPlugin interfaces, which represents the functionality that should be implemented as Munin-Plugin. By properly implementing IPlugin and its relevant interfaces, you can compose the Munin-Plugin which aggregates telemetry data using .NET.
To use the released packge, add <PackageReference> to the project file.
<ItemGroup>
<PackageReference Include="Smdn.Net.MuninNode" Version="1.*" />
</ItemGroup>Then write the your code. See examples to use APIs.
If you want munin-update to gather the telemetry data from the Munin-Node you have created and started, you have to add entry defines your node to configuration file /etc/munin/munin.conf. The following is an example:
[your-node.localdomain]
address 127.0.0.1 # address of your node
port 44693 # port number that your node uses
use_node_name yes # let Munin to use the node name advertised by your node (optional)
Multiple instances can also be started by defining multiple nodes with different port numbers if you want.
For more information about node definitions, please refer to the Munin documentation for munin.conf.
To test the node you have created, run the node first, and connect to the node.
The following is an example of testing a node using the telnet command. Here, the port number should be the one your node is using.
$ telnet 127.0.0.1 9876
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
# munin node at your-node.localhost
list <-- type 'list' to list field names
uptime sensor1 sensor2
fetch uptime <-- type 'fetch <field-name>' to fetch
the value of the specified field
uptime.value 123.4567
quit <-- type 'quit' to close connection
Connection closed by foreign host.
Contributions are appreciated!
If there's a feature you would like to add or a bug you would like to fix, please read Contribution guidelines and create an Issue or Pull Request.
IssueやPull Requestを送る際は、Contribution guidelinesをご覧頂ください。 可能なら英語が望ましいですが、日本語で構いません。
PseudoMuninNode, the C++ implementation for ESP32 (Arduino IDE) is also available.