Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/anilantari/uwuscan
uwuscan - a set of scripts for monitoring the status of network MFPs in the terminal.
https://github.com/anilantari/uwuscan
monitoring perl perl5 printer-monitor
Last synced: 2 months ago
JSON representation
uwuscan - a set of scripts for monitoring the status of network MFPs in the terminal.
- Host: GitHub
- URL: https://github.com/anilantari/uwuscan
- Owner: AnilAntari
- License: gpl-3.0
- Created: 2023-12-01T07:46:31.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-09-12T18:38:24.000Z (3 months ago)
- Last Synced: 2024-10-12T11:24:00.828Z (2 months ago)
- Topics: monitoring, perl, perl5, printer-monitor
- Language: Perl
- Homepage:
- Size: 63.5 KB
- Stars: 3
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# uwuscan
uwuscan - a set of scripts for monitoring the status of network MFPs in the terminal.
## Tools and libraries
* Perl
* Curl
* Log-Any
* Net-SNMP
## Install
1. Get the script:
```bash
git clone https://github.com/AnilAntari/uwuscan.git
```
2. Create directories for log files:
```bash
sudo mkdir /var/uwuscan_log
```
3. Installing the module:
```bash
sudo pacman -S perl-net-snmp perl-log-any
```
Or else
```bash
sudo apt-get install libnet-snmp-perl liblog-any-perl
```
4. Copy the script directory to /etc and make them executable:
```bash
sudo cp -r uwuscan/ /etc/ && sudo chmod +x /etc/uwuscan/mfd/*
```
5. Uncomment in main.sh the scripts you need.
## Script Configurations
Scripts are configured using modules (.pm), which are located in `/etc/uwuscan/parameters/MFD-Model/`. The module contains the oid and ip addresses of the MFD. Example:
```perl
package set;
our @oid_list = (
'1.3.6.1.2.1.43.11.1.1.8.1.1', # Cartridge max status
'1.3.6.1.2.1.43.11.1.1.9.1.1', # Cartridge current status
'1.3.6.1.2.1.43.11.1.1.8.1.6', # Drum max status
'1.3.6.1.2.1.43.11.1.1.9.1.6' # Drum current status
);
our @ip_address = (
'192.168.1.1',
'192.168.1.2',
'192.168.1.3'
);
1;
```
The main values listed in the `oid_list` array are: cartridge max status, cartridge current status. If you want to add or remove the OID from the `oid_list` array, then you will have to rewrite the script for which you changed the module.
The `ip_address` array contains MFD IP addresses.
## Telegram Notifications
To enable notifications in Telegram, enable attention.pl in main.sh
### Configuring the script
In attention.pl in `my $url = 'https://api.telegram.org/bot/sendMessage';`, specify the bot token, and in `my $chat_id = '';`, specify your chat ID.
You can configure the trigger parameters for the bot:
```perl
$cawtwidge < 20 || $dwum < 20
```
# oid
snmpwalk installation:
```bash
sudo apt-get install snmp
```
or
```bash
sudo pacman -S net-snmp
```
Search oid:
```bash
sudo snmpwalk -Cc -c public -v2c -On ip-address
```