Netify Sink ubus Plugin

• Introduction
• License
• Installation
• OpenWRT
• Configuration
• Examples

Introduction

ubus is used for enabling efficient, scalable, and reliable communications on OpenWRT systems.

License

Netify Ubus Plugin is a proprietary plugin requiring a license. Please contact us for details.

Installation

Netify plugins are packaged in the same workflow as the agent and can usually be installed using a similar syntax that was implemented during the installation of the Netify agent. Exceptions to this rule occur when the plugin requires a Software License Agreement or if an upgrade or downgrade to a different version of the plugin is required.

OpenWRT

OpenWRT 23.05

The Netify Sink ubus plugin is a licensed (proprietary) plugin. Instructions to access this plugin will have been provided to you by a Netify representative. Typically, the package will be available via a web link with Basic authentication protection. Example:

pkg add https://client:secret@download.netify.ai/5/openwrt/23.05/amd64/netify-sink-ubus_1.0.8-1_x86_64.ipk

OpenWRT 22.03

The Netify Sink ubus plugin is a licensed (proprietary) plugin. Instructions to access this plugin will have been provided to you by a Netify representative. Typically, the package will be available via a web link with Basic authentication protection. Example:

pkg add https://client:secret@download.netify.ai/5/openwrt/22.03/amd64/netify-sink-ubus_1.0.8-1_x86_64.ipk

OpenWRT 21.02

The Netify Sink ubus plugin is a licensed (proprietary) plugin. Instructions to access this plugin will have been provided to you by a Netify representative. Typically, the package will be available via a web link with Basic authentication protection. Example:

pkg add https://client:secret@download.netify.ai/5/openwrt/21.02/amd64/netify-sink-ubus_1.0.8-1_x86_64.ipk

OpenWRT 19.07

The Netify Sink ubus plugin is a licensed (proprietary) plugin. Instructions to access this plugin will have been provided to you by a Netify representative. Typically, the package will be available via a web link with Basic authentication protection. Example:

pkg add https://client:secret@download.netify.ai/5/openwrt/19.07/amd64/netify-sink-ubus_1.0.8-1_x86_64.ipk

Configuration

Plugin Loader Configuration

All plugins are disabled by default, and the Netify Sink ubus plugin is no different. To enable:

netifyd --enable-plugin sink-ubus

Alternatively, you can edit /etc/netifyd/plugins.d/10-netify-sink-ubus.conf and set enable to yes.

# Netify Agent ubus Sink Plugin Loader
# Copyright (C) 2025 eGloo Incorporated
#
##############################################################################
 
[sink-ubus]
enable = yes
plugin_library = /usr/lib64/libnetify-sink-ubus.so.0.0.0
conf_filename = ${path_state_persistent}/netify-sink-ubus.json
 
# vim: set ft=dosini :

Plugin Configuration

Once the plugin has been enabled, it can be configured using the defined JSON configuration file specified in the plugin loader configuration. Let's look at a configuration sample to review the syntax and parts of the file.

{
    "channels": {
        "default": {
            "path": "path",
            "function": "function"
        }
    }
}

Channel Objects

The ubus Sink's channel object list determines which instances to log to. In the example above, we are defining only one, the defaultchannel. Let's take a closer look at the configuration.