Added option to specify GET params in custom_query()

The Prometheus API exposes at least two optional GET parameters: "time" for evaluating a query at specific moment, and "timeout" for limiting the query runtime. This commit adds the ability to set those parameters (as well as any other GET parameter) while using custom_query().

Author: abyrne55

prometheus_api_client/prometheus_connect.py

@@ -224,7 +224,7 @@ def _metric_filename(self, metric_name, end_timestamp):
         return object_path
 
     @retry(stop_max_attempt_number=MAX_REQUEST_RETRIES, wait_fixed=CONNECTION_RETRY_WAIT_TIME)
-    def custom_query(self, query: str):
+    def custom_query(self, query: str, params: dict = {}):
         """
         A method to send a custom query to a Prometheus Host.
 
@@ -233,6 +233,9 @@ def custom_query(self, query: str):
 
         :param query: (str) This is a PromQL query, a few examples can be found
                         at https://prometheus.io/docs/prometheus/latest/querying/examples/
+                        
+        :param params: (dict) Optional dictionary containing GET parameters to be 
+                        sent along with the API request, such as "time"
 
         :Returns: (list) A list of metric data received in response of the query sent
 
@@ -242,11 +245,12 @@ def custom_query(self, query: str):
         data = None
         query = str(query)
         # using the query API to get raw data
-        response = requests.get('{0}/api/v1/query'.format(self.url),
-                                params={'query': query
-                                        },
-                                verify=self.ssl_verification,
-                                headers=self.headers)
+        response = requests.get(
+            "{0}/api/v1/query".format(self.url),
+            params={**{"query": query}, **params},
+            verify=self.ssl_verification,
+            headers=self.headers,
+        )
         if response.status_code == 200:
             data = response.json()['data']['result']
         else: