Add monitoring

osfv_cli/monitoring/zabbix/External_Check.md

@@ -0,0 +1,81 @@
+# External Check Zabbix
+
+This is a brief guide on setting up external checks in Zabbix.
+You can find example scripts in this folder.
+
+## Preparation
+
+1. Make sure your script is in
+
+```
+/usr/lib/zabbix/externalscripts
+```
+
+> The default location of externalscripts can be changed in `/etc/zabbix/zabbix_server.conf` by editing `ExternalScripts=/usr/lib/zabbix/externalscripts` (make sure to remove #)
+
+**Ensure that you have only one tab open when creating anything in Zabbix (items/triggers/hosts).**
+> It's likely that the last used tab is overwriting session data.
+
+## Create the item in Zabbix
+>
+> Item is a tool that gathers data from device, system or external script
+2. Navigate to **Configuration** > **Hosts**.
+2. Go to the **Items** next to the host you want to monitor.
+2. Click **Create item** in top right.
+ - Change Type to **External check**.
+ - As key use your script name together with desired **Macro**, for example `script.sh[{HOST.IP}]`.
+  + You can combine multiple Macros `script.sh[{HOST.DESCRIPTION},{HOST.ID},{HOST.CONN}]`.
+
+[list of macros](https://www.zabbix.com/documentation/current/en/manual/appendix/macros/supported_by_location#host-inventory)
+
+## Create the trigger
+>
+> Trigger is a rule that watches for specific events, like high CPU usage.
+3. Navigate to **Configuration** > **Hosts**.
+3. Go to the **Triggers** next to the host with the item you want to monitor.
+3. Click **Create trigger** in top right.
+ - Severity: Select as needed.
+ - Expression: press Add
+  + Item: Select the item for which you want to create a trigger.
+  + Function: Defines how your trigger will be activated.
+  + Result: Actual rule of activation.
+> If your script returns numeric values directly and/or you don't won't to calculate the average result, simply use `last()` function
+
+## Testing
+
+4. Test manually.
+- login as **zabbix** user and go to the script location.
+- run your script as zabbix.
+> You can directly incorporate information from Zabbix macros into your command, such as ./script.sh '192.168.10.0'.
+
+4. Test in zabbix web interface.
+- Go to your item location.
+- If you are using external checks, **Test** option should be available.
+   	- Check if you Macros give proper data to your script.
+   	- Press **Get value and test**.
+
+4. Common problems.
+- Timeout: you can change (not VM)Timeout(and TrapperTimeout if needed) settings in /etc/zabbix/zabbix_server.conf
+- Make sure all necesery files and commands are accessible for zabbix user.
+- If you find something else, please update the file.
+
+## Templates
+
+5. Navigate to **Configuration** > **Templates**.
+5. Click **Create template** in top right.
+ - Specify the name, group and other information if needed.
+5. Add **items**, **trigger** and **macros** if needed.
+5. Link the template to **Hosts**
+ 5. Mass update
+  - Go to **Hosts**.
+  - Check the boxes next to the desired hosts.
+  - Scroll to the bottom and click **Mass update**.
+   + Select **Link templates**.
+   + Choose **Link**.
+   + Enter your template name.
+   + Press **Update**.
+
+ 5. Single update
+  + Open desired **Host**.
+  + Add your Template under Templates.
+  + Press **Update**.

osfv_cli/monitoring/zabbix/external_flash_probe/flash_probe.sh

@@ -0,0 +1,59 @@
+#!/bin/bash
+
+cd /usr/lib/zabbix/externalscripts/
+
+source /usr/lib/zabbix/externalscripts/venv/bin/activate
+
+input_file="/usr/lib/zabbix/externalscripts/macros.txt"
+
+output_pass="/usr/lib/zabbix/externalscripts/output_pass.txt"
+output_fail="/usr/lib/zabbix/externalscripts/output_fail.txt"
+output_used="/usr/lib/zabbix/externalscripts/output_used.txt"
+stolen="/usr/lib/zabbix/externalscripts/stolen.txt"
+
+> "$output_used"
+> "$output_pass"
+> "$output_fail"
+> "$stolen"
+
+check_snipeit() {
+    ip=$1
+    if [[ "$ip" =~ [0-9] ]]; then
+        if osfv_cli snipeit list_used | grep -qw "$ip"; then
+            return 0 # IP is checked out
+        else
+            osfv_cli snipeit check_out --rte_ip "$ip"
+            echo "$ip" >> "$stolen"
+            return 1  # IP not checked out
+        fi
+    else
+        return 1  # IP contains no numbers
+    fi
+}
+
+probe_flash() {
+    ip=$1
+    output_flash=$(osfv_cli rte --rte_ip "$ip" flash probe)
+    if echo "$output_flash" | grep -qE 'Found .* flash chip ".*" \(.*\) on .*\.'; then
+        echo "$ip" >> "$output_pass"
+    else
+        echo "$ip" >> "$output_fail"
+    fi
+}
+
+while IFS= read -r ip || [ -n "$ip" ]; do
+    if check_snipeit "$ip"; then
+        echo "$ip found in snipeit list_used"
+#       echo "$ip" >> "$output_used"
+    else
+        echo "$ip not found in snipeit list_used, probing flash..."
+        probe_flash "$ip"
+    fi
+done < "$input_file"
+
+while IFS= read -r ip || [ -n "$ip" ]; do
+   osfv_cli snipeit check_in --rte_ip "$ip"
+done < "$stolen"
+
+deactivate
+

osfv_cli/monitoring/zabbix/external_flash_probe/flash_read.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+
+fail="/usr/lib/zabbix/externalscripts/output_fail.txt"
+used="/usr/lib/zabbix/externalscripts/output_used.txt"
+pass="/usr/lib/zabbix/externalscripts/output_pass.txt"
+
+ip=$1
+
+if grep -qw "$ip" "$fail"; then
+   echo 0
+elif grep -qw "$ip" "$used"; then
+     echo 1
+elif grep -qw "$ip" "$pass"; then
+     echo 2
+fi

osfv_cli/monitoring/zabbix/external_flash_probe/flash_write.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+
+output_file="/usr/lib/zabbix/externalscripts/macros.txt"
+
+touch "$output_file"
+
+if [ -z $1 ]; then
+#    echo "No macro provided."
+    exit 1
+fi
+
+macro_exists() {
+    grep -qF "$1" "$output_file"
+}
+
+for macro in "$@"; do
+    if ! macro_exists "$macro"; then
+         echo "$macro" >> "$output_file"
+         echo 1
+    else
+#        echo "Macro '$macro' already exists in the file."
+         echo 0
+    fi
+done

osfv_cli/osfv_cli/osfv_cli.py

@@ -72,6 +72,7 @@ def list_my_assets(snipeit_api, args):
         for asset in my_assets:
             print_asset_details(asset)
 
+
 # List unused assets
 def list_unused_assets(snipeit_api, args):
     all_assets = snipeit_api.get_all_assets()