python-sdk-remote 0.0.165__tar.gz → 0.0.166b3060__tar.gz

{python_sdk_remote-0.0.165 → python_sdk_remote-0.0.166b3060}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-sdk-remote
-Version: 0.0.165
+Version: 0.0.166b3060
 Summary: PyPI Package for Circles Python SDK Local Python
 Home-page: https://github.com/circles-zone/python-sdk-remote-python-package
 Author: Circles

python_sdk_remote-0.0.166b3060/python_sdk_remote/src/datadog.py

@@ -0,0 +1,88 @@
+"""Datadog log sender for MiniLogger.
+
+Mirrors logger-local-python-package logger_local/src/datadog.py, but is
+self-contained on purpose: logger-local depends on python-sdk-remote, so this
+package cannot import from it without creating a circular dependency.
+
+IMPORTANT - this module must never log through MiniLogger. logger-local's
+datadog.py reports its own send failures via MiniLogger, so if MiniLogger's
+Datadog path also went through MiniLogger, one failed send would trigger
+another. Failures here go to the stdlib logger below and stop there.
+"""
+
+import logging
+import os
+import sys
+
+import requests
+
+# Deliberately the stdlib logger, NOT MiniLogger - see the module docstring.
+_logger = logging.getLogger(__name__)
+
+# US1 (app.datadoghq.com) - the Datadog site the Circlez organization is on.
+# Datadog regions are separate instances: an API key issued in one site is
+# rejected by the others, so this must match the org the key belongs to.
+DATADOG_SITE: str = os.getenv("DATADOG_SITE") or "datadoghq.com"
+DATADOG_URL = f"https://http-intake.logs.{DATADOG_SITE}/api/v2/logs"
+
+DATADOG_API_KEY: str = os.getenv("DATADOG_API_KEY")
+
+DATADOG_REQUEST_TIMEOUT_SECONDS = 5
+
+# Our severity names mapped to Datadog's log status values.
+# Without an explicit "status" Datadog files everything as "info", which makes
+# error monitors useless - see https://docs.datadoghq.com/logs/log_configuration/pipelines/#log-status-remapper
+SEVERITY_NAME_TO_DATADOG_STATUS = {
+    "DEBUG": "debug",
+    "VERBOSE": "debug",
+    "INIT": "debug",
+    "START": "debug",
+    "END": "debug",
+    "INFORMATION": "info",
+    "WARNING": "warn",
+    "ERROR": "error",
+    "CRITICAL": "critical",
+    "EXCEPTION": "error",
+}
+
+
+class Datadog:
+    @staticmethod
+    def send_to_datadog(log_message: str = None, severity_name: str = None, object: dict = None) -> None:
+        """Sends one MiniLogger line to Datadog.
+
+        No-op when DATADOG_API_KEY is unset. Never raises - a logging failure
+        must not break the caller.
+
+        Parameters:
+            log_message (str): the message text
+            severity_name (str): a LogMessageSeverity/StartEndEnum name, mapped to a Datadog status
+            object (dict): optional extra attributes to attach to the log
+        """
+        if not DATADOG_API_KEY:
+            return
+        try:
+            # If sys.meta_path is None, Python is likely shutting down
+            if not sys.meta_path:
+                return
+            payload = {
+                "ddsource": "python",
+                "service": "circlez",
+                # Lets you separate MiniLogger traffic from logger-local traffic
+                # in the Log Explorer with logger:mini_logger
+                "logger": "mini_logger",
+                "status": SEVERITY_NAME_TO_DATADOG_STATUS.get(severity_name, "info"),
+                "severity_name": severity_name,
+                "message": log_message or "",
+            }
+            if object:
+                payload["object"] = str(object)
+            requests.post(
+                DATADOG_URL,
+                headers={"DD-API-KEY": DATADOG_API_KEY, "Content-Type": "application/json"},
+                json=payload,
+                timeout=DATADOG_REQUEST_TIMEOUT_SECONDS,
+            )
+        except Exception as exception:
+            # Must not go through MiniLogger - see the module docstring
+            _logger.debug("Failed to send log to Datadog, continue anyway. exception=%s", exception)

{python_sdk_remote-0.0.165 → python_sdk_remote-0.0.166b3060}/python_sdk_remote/src/mini_logger.py

@@ -4,6 +4,11 @@ import sys
 # from enum import Enum
 import inspect
 from .constants_src_mini_logger_and_logger import LogMessageSeverity, StartEndEnum
+from .datadog import Datadog, DATADOG_API_KEY
+
+# Datadog is optional - we write to it only when DATADOG_API_KEY is set, the same
+# behaviour as logger-local-python-package and logger-local-typescript-package
+IS_WRITE_TO_DATADOG = bool(DATADOG_API_KEY)
 
 # Logger configuration constants
 LOGGER_MINIMUM_SEVERITY_DEFAULT = "INFORMATION"
@@ -24,14 +29,6 @@ if LOGGER_MINIMUM_SEVERITY.isdigit():
     else:
         LOGGER_MINIMUM_SEVERITY = LogMessageSeverity.CRITICAL.name
 
-# Option #1 ( I think we should delete it)
-# Map the internal "INFORMATION" string to Python's native standard "INFO"
-# python_logging_level = "INFO" if LOGGER_MINIMUM_SEVERITY == "INFORMATION" else LOGGER_MINIMUM_SEVERITY
-# logging.basicConfig(level=python_logging_level, stream=sys.stdout,
-#                     format="%(asctime)s - %(message)s")
-
-
-# Option #2
 # Some of our severity names (LogMessageSeverity) aren't recognized by Python's stdlib
 # logging module, which only knows DEBUG/INFO/WARNING/ERROR/CRITICAL - translate before basicConfig
 _CUSTOM_TO_STDLIB_LEVEL_NAME = {
@@ -41,9 +38,9 @@ _CUSTOM_TO_STDLIB_LEVEL_NAME = {
     "EXCEPTION": "ERROR",
 }
 LOGGER_MINIMUM_SEVERITY = _CUSTOM_TO_STDLIB_LEVEL_NAME.get(LOGGER_MINIMUM_SEVERITY, LOGGER_MINIMUM_SEVERITY)
+
 logging.basicConfig(level=LOGGER_MINIMUM_SEVERITY, stream=sys.stdout,
                     format="%(asctime)s - %(message)s")
-
 logger = logging.getLogger(__name__)
 
 
@@ -88,6 +85,14 @@ class MiniLogger:
         else:
             method(f"Function: {function}, Line: {line}; {action_name} - {log_message} - {object}")
 
+        if IS_WRITE_TO_DATADOG:
+            # send_to_datadog() never raises, so this cannot break the caller
+            Datadog.send_to_datadog(
+                log_message=log_message,
+                severity_name=action_name,
+                object=object,
+            )
+
     @staticmethod
     def start(log_message: str = None, **kwargs):
         """

{python_sdk_remote-0.0.165 → python_sdk_remote-0.0.166b3060}/python_sdk_remote/src/version.py

@@ -1,5 +1,5 @@
 # PACKAGE_VERSION from setup.py generated by MakePy.ps1
-PACKAGE_VERSION = '0.0.165'
+PACKAGE_VERSION = '0.0.153'
 
 
 def get_package_version() -> str:

{python_sdk_remote-0.0.165 → python_sdk_remote-0.0.166b3060}/python_sdk_remote.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-sdk-remote
-Version: 0.0.165
+Version: 0.0.166b3060
 Summary: PyPI Package for Circles Python SDK Local Python
 Home-page: https://github.com/circles-zone/python-sdk-remote-python-package
 Author: Circles

{python_sdk_remote-0.0.165 → python_sdk_remote-0.0.166b3060}/python_sdk_remote.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ python_sdk_remote.egg-info/top_level.txt
 python_sdk_remote/src/__init__.py
 python_sdk_remote/src/constants.py
 python_sdk_remote/src/constants_src_mini_logger_and_logger.py
+python_sdk_remote/src/datadog.py
 python_sdk_remote/src/datetime_range.py
 python_sdk_remote/src/exceptions.py
 python_sdk_remote/src/generic_crud.py

{python_sdk_remote-0.0.165 → python_sdk_remote-0.0.166b3060}/setup.py

@@ -7,7 +7,7 @@ package_dir = PACKAGE_NAME.replace("-", "_")
 # python -m build needs pyproject.toml or setup.py
 setuptools.setup(
     name=PACKAGE_NAME,
-    version='0.0.165',  # https://pypi.org/project/python-sdk-remote/
+    version='0.0.166b3060',  # https://pypi.org/project/python-sdk-remote/
     author="Circles",
     author_email="info@circlez.ai",
     description="PyPI Package for Circles Python SDK Local Python",