{"id":13577306,"url":"https://github.com/Excello-cz/netdata-plugins","last_synced_at":"2025-04-05T11:32:10.756Z","repository":{"id":41832998,"uuid":"167045174","full_name":"Excello-cz/netdata-plugins","owner":"Excello-cz","description":"NetData Plugins","archived":false,"fork":false,"pushed_at":"2024-05-18T14:03:00.000Z","size":149,"stargazers_count":3,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-11-05T14:44:18.588Z","etag":null,"topics":["netdata","netdata-plugin","qmail"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Excello-cz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-01-22T18:26:03.000Z","updated_at":"2024-05-18T14:02:53.000Z","dependencies_parsed_at":"2024-03-17T02:03:55.689Z","dependency_job_id":"9e42f5d7-3a6f-411e-96d0-b38e90c0b8fa","html_url":"https://github.com/Excello-cz/netdata-plugins","commit_stats":null,"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Excello-cz%2Fnetdata-plugins","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Excello-cz%2Fnetdata-plugins/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Excello-cz%2Fnetdata-plugins/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Excello-cz%2Fnetdata-plugins/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Excello-cz","download_url":"https://codeload.github.com/Excello-cz/netdata-plugins/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247331368,"owners_count":20921775,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["netdata","netdata-plugin","qmail"],"created_at":"2024-08-01T15:01:20.344Z","updated_at":"2025-04-05T11:32:10.476Z","avatar_url":"https://github.com/Excello-cz.png","language":"C","readme":"# Netdata plugins\n\nYou just have reached a small collection of [netdata](https://github.com/netdata/netdata) external plugins for [daemontools](http://cr.yp.to/daemontools.html) data monitoring gathering, [qmail](http://cr.yp.to/qmail.html), [qmail-scanner](http://toribio.apollinare.org/qmail-scanner/) and [parser](https://www.virusfree.cz/en/) (proprietary tool for processing of logs of [qmail](http://cr.yp.to/qmail.html) and [qmail-scanner](http://toribio.apollinare.org/qmail-scanner/)) together with several defined allarms for specific metrics collected.\n\n## parser.plugin\n\n`parser.plugin` is a netdata external plugin for monitoring output of **parser** cronjob. **parser** is used for processing of **scannerd** and **qmail-send** logs and loading processed logs into database. It detects **parser** presence by locating all directories with `scannerd` substring in its name inside `/var/log` directory and prepares a data collector for each one of them. The plugin is deactivated if there is no such directory.\n\n**It collects**:\n\n1. Failed connection to DB marked as `conn_failed`\n2. Successfull and failed updates of scanner and delivery tables marked as `scanner_success`, `scanner_failed`, `delivery_success` and `delivery_failed`.\n3. Successfull and failed updates of unknown tables marked as `unknown_success` and `unknown_failed`\n4. Unknown log lines marked as `other`\n\nThis plugin is currently Linux specific.\n\n## svstat.plugin\n\n`svstat.plugin` is a netdata external plugin. It detects presence of a [daemontools](http://cr.yp.to/daemontools.html) by changing working directory to `/service`. The plugin collects uptime and downtime in seconds since last change of the service and up/down state. The information is gathered from `supervise/status` file in similar manner as [svstat](http://cr.yp.to/daemontools/svstat.html) does, however, the file is accessible only for root by default (This is feature of [supervise](http://cr.yp.to/daemontools/supervise.html) program), therefore `svstat.plugin` has to have `suid` flag set or `CAP_DAC_READ_SEARCH` capability on linux.\n\nThe plugin skips all subdirectories starting with `.` character.\n\n## qmail.plugin\n\n`qmail.plugin` is a netdata external plugin. It detects **qmail** presence by checking `/var/log/qmail` directory existence and there it locates all subdirectories containing `smtp` or `send` in theirs name and prepares data collector for each one of them.\n\nIt skips all directories starting with `.` character.\n\n**For smtp it collects**:\n\n1. connection with status `ok` or `deny`,\n2. average number of connections,\n3. end statuses for `0`, `256`, `25600` or *other* value,\n4. connection via SMTP protocol type `SMTP` or `ESMTPS`,\n5. usage of TLS protocol version `TLS1`, `TLS_1`, `TLS_1.1`, `TLS_1.2`, `TLS_1.3` or *unknown*.\n\n**For send it collects**:\n\n1. number of `start delivery` and `end msg`,\n2. number of delivery `success`, `failure` or `deferral`.\n\n**For queue it collects**:\n\n1. number of files in `mess` directory and its subdirectories\n1. number of files in `todo` directory and its subdirectories\n\nThe plugin expects `mess` and `todo` to be located in `/var/qmail/queue`.\n\nThis plugin is currently Linux specific.\n\n## scanner.plugin\n\n`scanner.plugin` is a netdata external plugin for monitoring of **scannerd**, which is proprietary software with a log output similar to [qmail-scanner](http://toribio.apollinare.org/qmail-scanner/). It detects **scannerd** presence by locating all directories with `scannerd` substring in its name inside `/var/log` directory and prepares a data collector for each one of them. The plugin is deactivated if there is no such directory.\n\nIt skips all directories starting with `.` character.\n\n**It collects**:\n\n1. Emails with status `Clear`, `CLAMDSCAN`, `SPAM-TAGGED`, `SPAM-REJECTED` and `SPAM-DELETED`\n2. Spam Cache hits\n3. Antivirus Cache hits\n4. Duration of scan\n\nThe [qmail-scanner](http://toribio.apollinare.org/qmail-scanner/) does not measure _Spam Cache hits_ and _Antivirus Cache hist_, but the collector should work for it either. However, it was not tested.\n\nThis plugin is currently Linux specific.\n\n## Configuration\n\nAll plugins are configured via [netdata.conf](https://github.com/netdata/netdata/tree/master/collectors/plugins.d#configuration). For example, user may wish to change granularity of data gathering by `svstat.plugin` to 10 seconds:\n\n```cfg\n[plugin:svstat]\n\tupdate every = 10\n\t# command options =\n```\n\nAll plugins accept value from `update every` parameter as a first argument (1 second by default). The second optional argument, from `command options` parameter, is a path to a directory, which plugin tries to set as a working directory at the beginning of its execution. For example, user may wish to set default path of a daemontools service directory to `/run/service` (rather than default `/service`) for `svstat.plugin`:\n\n```cfg\n[plugin:svstat]\n\tupdate every = 10\n\tcommand options = /run/service\n```\n\n### Plugin restart\n\nIt is possible to restart service by sending signal `QUIT`, `TERM` or `INT` (with command `pkill qmail.plugin` for example) and `qmail.plugin` quits successfully\nIt will be started by `netdata` again.\nThis may be wanted if the plugin have been updated or new log directory have been introduced.\n","funding_links":[],"categories":["C"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FExcello-cz%2Fnetdata-plugins","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FExcello-cz%2Fnetdata-plugins","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FExcello-cz%2Fnetdata-plugins/lists"}