From abff64b3b5bedadddfc4fdfe98bd09af749c0013 Mon Sep 17 00:00:00 2001
From: cmk-bonobo <cmk.bonobo@arschkrebs.org>
Date: Sun, 14 Jan 2024 15:50:03 +0100
Subject: [PATCH] MKP 1.0.5, added debug log decorator function

---
 .../check_mk/agents/special/agent_hal9001     |  67 ++++++++++++++++++
 mkp/hal9001-1.0.5.mkp                         | Bin 0 -> 9040 bytes
 2 files changed, 67 insertions(+)
 create mode 100644 mkp/hal9001-1.0.5.mkp

diff --git a/local/share/check_mk/agents/special/agent_hal9001 b/local/share/check_mk/agents/special/agent_hal9001
index 506ce39..8bdc8ac 100644
--- a/local/share/check_mk/agents/special/agent_hal9001
+++ b/local/share/check_mk/agents/special/agent_hal9001
@@ -4,6 +4,9 @@ import getopt
 import sys
 import random
 import os
+from time import (
+    time, localtime, strftime,
+)
 
 """
 Sample output
@@ -46,6 +49,55 @@ OPTIONS:
   -p, --password    Password
   -h, --help        Show this help message and exit
 """)
+    
+
+debugLogFilename = ""
+SEP = "|"
+#SEP = "\t"
+TIMEFMT = "%Y-%m-%d %H:%M:%S"
+FLOATFMT = "{:.4f}"
+
+'''
+Decorator function for debugging purposes
+    creates a file with many information regarding the function call, like:
+        timestamp
+        name of function
+        runtime
+        number of arguments
+        number of keyword arguments
+        return value of function call
+        type of return value
+        all parameters given to function
+'''
+def debugLog(function):
+    def wrapper(*args, **kwargs):
+        # execute function and measure runtime
+        start = time()
+        value = function(*args, **kwargs)
+        end = time()
+        # get number of args and kwargs
+        len_args = len(args)
+        len_kwargs = len(kwargs)
+        # format the output
+        seconds = FLOATFMT.format(end - start)
+        local_time = strftime(TIMEFMT,localtime(start))
+        # get function name
+        fname = function.__name__
+        # out1: Timestamp|Name of Function|Runtime|Num Args|Num Kwargs|Return Value|Return Value Type
+        out1 = f"{local_time}{SEP}{fname}{SEP}{seconds}{SEP}{len_args}{SEP}{len_kwargs}{SEP}{value}{SEP}{type(value)}"
+        # out2: all arguments
+        out2 = ""
+        for arg in args:
+            out2 = out2 + SEP + str(arg)
+        # out 3: all keyowrd arguments
+        out3 = ""
+        if len_kwargs > 0:
+            for key, val in kwargs.items():
+                out3 = out3 + SEP + key + ":" + str(val)
+        with open(debugLogFilename, "a") as f:
+            f.write(f"{out1}{out2}{out3}\n")
+        return value
+    return wrapper
 
 # Parameters coming from CheckMK
 opt_hostname = ""
@@ -97,6 +149,12 @@ long_options = [
     'hostname=', 'username=', 'password=', 'help'
 ]
 
+def createDebugFilename(hostname):
+    home_path = os.getenv("HOME")
+    tmp_path = f"{home_path}/tmp"
+    file_name = f"{tmp_path}/hal9001_{hostname}_debug.log"
+    return file_name
+
 def getOptions():
     global opt_hostname
     global opt_username
@@ -119,6 +177,7 @@ def showOptions():
     print(f"Username: {opt_username}")
     print(f"Password: {opt_password}")
 
+#@debugLog
 def calculateNewUserStorage(current_storage):
     # let the chance that no change occured be at 90%
     no_change = random.randint(1, 100)
@@ -140,6 +199,7 @@ def calculateNewUserStorage(current_storage):
                 new_storage = 1024000
         return float(new_storage)
 
+#@debugLog
 def calculateNewStorageCounters(ul_bytes, dl_bytes):
     # let the chance that no change occured be at 2%
     no_change = random.randint(1, 100)
@@ -158,10 +218,12 @@ def calculateNewStorageCounters(ul_bytes, dl_bytes):
         new_dl_bytes = dl_bytes + amount_dl
         return float(new_ul_bytes), float(new_dl_bytes)
 
+#@debugLog
 def doCmkHalStatusOutput(status, version, username, ipaddress):
     print("<<<hal9001_status:sep(59)>>>")
     print(f"{status};{version};{username};{ipaddress}")
 
+#@debugLog
 def doCmkHalUsersOutput(users, hostname):
     print("<<<hal9001_users:sep(59)>>>")
     home_path = os.getenv("HOME")
@@ -188,6 +250,7 @@ def doCmkHalUsersOutput(users, hostname):
         # create output
         print(f"{user};{realname};{new_storage};{quota_max}")
 
+#@debugLog
 def doCmkHalStoragesOutput(storages, hostname):
     print("<<<hal9001_storages:sep(59)>>>")
     home_path = os.getenv("HOME")
@@ -226,6 +289,7 @@ def doCmkHalStoragesOutput(storages, hostname):
         # create output
         print(f"{storage};{realname};{new_ul_bytes};{new_dl_bytes}")
 
+#@debugLog
 def getStatus():
     # randomly set one of the three available states
     status_index = random.randint(1,100)
@@ -240,6 +304,7 @@ def getStatus():
         hal_status = hal_status_list[0]
     return hal_status, hal_version
 
+#@debugLog
 def doLogin(hostname, username, password):
     # simulate the login to our HAL system
     # give it a chance of 2% to fail to demonstrate an error from time to time
@@ -250,6 +315,7 @@ def doLogin(hostname, username, password):
         return False, 404
     
 def main():
+    global debugLogFilename
     getOptions()
     #showOptions()
     # some checks
@@ -266,6 +332,7 @@ def main():
         sys.stderr.write(f"No password given.\n")
         showUsage()
         sys.exit(1)
+    debugLogFilename = createDebugFilename(opt_hostname)
     success, code = doLogin(opt_hostname, opt_username, opt_password)
     if success:
         status, version = getStatus()
diff --git a/mkp/hal9001-1.0.5.mkp b/mkp/hal9001-1.0.5.mkp
new file mode 100644
index 0000000000000000000000000000000000000000..abffe9c992d9a19d4f1cdb6fd8526a7f45b528c2
GIT binary patch
literal 9040
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

literal 0
HcmV?d00001