devinspector 2.0.6__tar.gz → 2.1.0__tar.gz

devinspector-2.1.0/PKG-INFO

@@ -0,0 +1,27 @@
+Metadata-Version: 2.4
+Name: devinspector
+Version: 2.1.0
+Summary: SDK Python de monitoramento e auditoria em tempo real | DevInspector
+Author-email: DevInspector <suporte@devinspector.com.br>
+License: MIT
+Project-URL: Homepage, https://devinspector.com.br
+Keywords: monitoring,error-tracking,apm,audit,devinspector,fastapi,flask
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Provides-Extra: fastapi
+Requires-Dist: fastapi; extra == "fastapi"
+Requires-Dist: starlette; extra == "fastapi"
+Provides-Extra: flask
+Requires-Dist: flask; extra == "flask"

devinspector-2.1.0/devinspector/__init__.py

@@ -0,0 +1,3 @@
+from .core import AuditCore, audit, audit_operation
+
+__all__ = ["audit", "AuditCore", "audit_operation"]

{devinspector-2.0.6 → devinspector-2.1.0}/devinspector/core.py

@@ -5,9 +5,15 @@ import queue
 import threading
 import traceback
 import urllib.request
+import asyncio
+import functools
+import contextvars
 from datetime import datetime, timezone
 from typing import Any, Dict, Optional
 
+# Variável de contexto para armazenar dados da requisição atual (APM)
+# Substitui o papel do AsyncLocalStorage do Node.js
+request_context = contextvars.ContextVar("request_context", default=None)
 
 class AuditCore:
     def __init__(self):
@@ -49,6 +55,9 @@ class AuditCore:
         status_code: int,
         duration_ms: float,
         user_agent: str = "",
+        route: str = "",
+        db_queries_count: int = 0,
+        slow_query_ms: float = 0,
     ) -> None:
         payload = {
             "type": "request_metric",
@@ -61,6 +70,9 @@ class AuditCore:
             "metadata": {
                 "environment": self.environment,
                 "timestamp": datetime.now(timezone.utc).isoformat(),
+                "route": route or url,
+                "dbQueriesCount": db_queries_count,
+                "slowQueryMs": round(slow_query_ms, 2),
             },
         }
         self._enqueue(payload)
@@ -211,4 +223,62 @@ class AuditCore:
 
 
 # Singleton Global
-audit = AuditCore()
+audit = AuditCore()
+
+
+def audit_operation(name: str, threshold_ms: int = 300):
+    """
+    Decorador para monitorar funções de banco de dados ou chamadas externas.
+    Alimenta o request_context atual com a contagem de queries e lentidão.
+    Suporta tanto funções síncronas (def) quanto assíncronas (async def).
+    """
+    def decorator(func):
+        @functools.wraps(func)
+        async def async_wrapper(*args, **kwargs):
+            ctx = request_context.get()
+            if ctx is not None:
+                ctx["queriesCount"] = ctx.get("queriesCount", 0) + 1
+            
+            start = time.perf_counter()
+            try:
+                result = await func(*args, **kwargs)
+                duration_ms = (time.perf_counter() - start) * 1000
+                
+                if duration_ms > threshold_ms and ctx is not None:
+                    ctx["slowQueries"] = max(ctx.get("slowQueries", 0), duration_ms)
+                    audit.capture_message(
+                        f"Slow Query detectada em [{name}]", 
+                        {"durationMs": round(duration_ms), "operationName": name}
+                    )
+                return result
+            except Exception as e:
+                duration_ms = (time.perf_counter() - start) * 1000
+                audit.capture_exception(e, {"operationName": name, "durationMs": round(duration_ms)})
+                raise
+
+        @functools.wraps(func)
+        def sync_wrapper(*args, **kwargs):
+            ctx = request_context.get()
+            if ctx is not None:
+                ctx["queriesCount"] = ctx.get("queriesCount", 0) + 1
+            
+            start = time.perf_counter()
+            try:
+                result = func(*args, **kwargs)
+                duration_ms = (time.perf_counter() - start) * 1000
+                
+                if duration_ms > threshold_ms and ctx is not None:
+                    ctx["slowQueries"] = max(ctx.get("slowQueries", 0), duration_ms)
+                    audit.capture_message(
+                        f"Slow Query detectada em [{name}]", 
+                        {"durationMs": round(duration_ms), "operationName": name}
+                    )
+                return result
+            except Exception as e:
+                duration_ms = (time.perf_counter() - start) * 1000
+                audit.capture_exception(e, {"operationName": name, "durationMs": round(duration_ms)})
+                raise
+        
+        # Retorna o wrapper correto dependendo se a função original é async ou não
+        return async_wrapper if asyncio.iscoroutinefunction(func) else sync_wrapper
+    return decorator

devinspector-2.1.0/devinspector/fastapi.py

@@ -0,0 +1,73 @@
+import time
+from starlette.middleware.base import BaseHTTPMiddleware
+from starlette.requests import Request
+from .core import audit, request_context
+
+class DevInspectorMiddleware(BaseHTTPMiddleware):
+    def __init__(self, app, slow_threshold_ms: int = 300):
+        super().__init__(app)
+        self.slow_threshold_ms = slow_threshold_ms
+
+    async def dispatch(self, request: Request, call_next):
+        # Ignora rotas estáticas (adicione outras se necessário)
+        if request.url.path.startswith("/uploads"):
+            return await call_next(request)
+
+        start_time = time.perf_counter()
+        status_code = 500
+
+        # 1. Inicia o contexto da requisição para o APM isolar as contagens
+        token = request_context.set({
+            "queriesCount": 0,
+            "slowQueries": 0
+        })
+
+        try:
+            response = await call_next(request)
+            status_code = response.status_code
+            return response
+        except Exception as exc:
+            if hasattr(exc, "status_code"):
+                status_code = exc.status_code
+
+            audit.capture_error(
+                exc,
+                metadata={
+                    "path": request.url.path,
+                    "method": request.method,
+                    "statusCode": status_code,
+                },
+            )
+            raise exc
+        finally:
+            duration_ms = (time.perf_counter() - start_time) * 1000
+            user_agent = request.headers.get("user-agent", "")
+
+            # 2. Resgata os dados do APM que foram injetados pelas operações do banco
+            ctx = request_context.get()
+            db_queries_count = ctx.get("queriesCount", 0) if ctx else 0
+            slow_query_ms = ctx.get("slowQueries", 0) if ctx else 0
+
+            is_error = status_code >= 400
+            is_slow = duration_ms >= self.slow_threshold_ms
+            has_slow_query = slow_query_ms > 0
+
+            # 3. 🎯 FILTRO INTELIGENTE: Só envia se for Erro, Lenta ou tiver Query Lenta
+            if is_error or is_slow or has_slow_query:
+                # Tenta extrair a rota mapeada (ex: /users/{id}) em vez da URL crua (/users/123)
+                route_path = request.scope.get("route")
+                route_name = route_path.path if hasattr(route_path, "path") else request.url.path
+
+                audit.capture_request(
+                    method=request.method,
+                    url=str(request.url),
+                    status_code=status_code,
+                    duration_ms=duration_ms,
+                    user_agent=user_agent,
+                    route=route_name,
+                    db_queries_count=db_queries_count,
+                    slow_query_ms=slow_query_ms,
+                )
+            
+            # 4. Limpa o contexto para evitar vazamento de memória em outras requisições
+            request_context.reset(token)

devinspector-2.1.0/devinspector/flask.py

@@ -0,0 +1,88 @@
+import time
+from flask import Flask, g, request
+from .core import audit, request_context
+
+
+class DevInspectorFlask:
+    def __init__(self, app: Flask = None, slow_threshold_ms: int = 300):
+        self.slow_threshold_ms = slow_threshold_ms
+        if app is not None:
+            self.init_app(app)
+
+    def init_app(self, app: Flask):
+        app.before_request(self._before_request)
+        app.after_request(self._after_request)
+        app.teardown_request(self._teardown_request)
+
+    def _before_request(self):
+        # Ignora rotas estáticas (adicione outras se necessário)
+        if request.path.startswith("/uploads"):
+            return
+
+        g._devinspector_start_time = time.perf_counter()
+
+        # 1. Inicia o contexto da requisição para isolar as contagens do APM
+        g._devinspector_ctx_token = request_context.set({
+            "queriesCount": 0,
+            "slowQueries": 0
+        })
+
+    def _after_request(self, response):
+        self._record_metric(response.status_code)
+        return response
+
+    def _teardown_request(self, exception=None):
+        if exception:
+            status_code = 500
+            if hasattr(exception, "code"):
+                status_code = exception.code
+
+            audit.capture_error(
+                exception,
+                metadata={
+                    "path": request.path,
+                    "method": request.method,
+                    "statusCode": status_code,
+                },
+            )
+            if not getattr(g, "_devinspector_metric_recorded", False):
+                self._record_metric(status_code)
+
+        # 4. Limpa o contexto ao final da requisição para evitar vazamento
+        if hasattr(g, "_devinspector_ctx_token"):
+            request_context.reset(g._devinspector_ctx_token)
+
+    def _record_metric(self, status_code: int):
+        start_time = getattr(g, "_devinspector_start_time", None)
+        if start_time is None:
+            return
+
+        duration_ms = (time.perf_counter() - start_time) * 1000
+        user_agent = request.headers.get("User-Agent", "")
+
+        # 2. Resgata os dados do APM que foram injetados pelas operações do banco
+        ctx = request_context.get()
+        db_queries_count = ctx.get("queriesCount", 0) if ctx else 0
+        slow_query_ms = ctx.get("slowQueries", 0) if ctx else 0
+
+        is_error = status_code >= 400
+        is_slow = duration_ms >= self.slow_threshold_ms
+        has_slow_query = slow_query_ms > 0
+
+        # 3. 🎯 FILTRO INTELIGENTE: Só envia se for Erro, Lenta ou tiver Query Lenta
+        if is_error or is_slow or has_slow_query:
+            # Extrai a rota com parâmetros (ex: /users/<id>) em vez da URL crua
+            route_name = request.url_rule.rule if request.url_rule else request.path
+
+            audit.capture_request(
+                method=request.method,
+                url=request.url,
+                status_code=status_code,
+                duration_ms=duration_ms,
+                user_agent=user_agent,
+                route=route_name,
+                db_queries_count=db_queries_count,
+                slow_query_ms=slow_query_ms,
+            )
+        
+        g._devinspector_metric_recorded = True

devinspector-2.1.0/devinspector.egg-info/PKG-INFO

@@ -0,0 +1,27 @@
+Metadata-Version: 2.4
+Name: devinspector
+Version: 2.1.0
+Summary: SDK Python de monitoramento e auditoria em tempo real | DevInspector
+Author-email: DevInspector <suporte@devinspector.com.br>
+License: MIT
+Project-URL: Homepage, https://devinspector.com.br
+Keywords: monitoring,error-tracking,apm,audit,devinspector,fastapi,flask
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Provides-Extra: fastapi
+Requires-Dist: fastapi; extra == "fastapi"
+Requires-Dist: starlette; extra == "fastapi"
+Provides-Extra: flask
+Requires-Dist: flask; extra == "flask"

devinspector-2.1.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "devinspector"
+version = "2.1.0"
+description = "SDK Python de monitoramento e auditoria em tempo real | DevInspector"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "DevInspector", email = "suporte@devinspector.com.br"}
+]
+keywords = ["monitoring", "error-tracking", "apm", "audit", "devinspector", "fastapi", "flask"]
+dependencies = []
+
+# Classificadores ajudam os desenvolvedores a encontrarem seu pacote no PyPI
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: System :: Monitoring",
+]
+
+[project.optional-dependencies]
+fastapi = ["fastapi", "starlette"]
+flask = ["flask"]
+
+[project.urls]
+Homepage = "https://devinspector.com.br"
+# Documentation = "https://docs.devinspector.com.br" # Descomente se tiver

devinspector-2.0.6/PKG-INFO

@@ -1,15 +0,0 @@
-Metadata-Version: 2.4
-Name: devinspector
-Version: 2.0.6
-Summary: SDK Python de monitoramento e auditoria em tempo real | DevInspector
-Author-email: DevInspector <suporte@devinspector.com.br>
-License: MIT
-Project-URL: Homepage, https://devinspector.com.br
-Keywords: monitoring,error-tracking,audit,devinspector,fastapi,flask
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Provides-Extra: fastapi
-Requires-Dist: fastapi; extra == "fastapi"
-Requires-Dist: starlette; extra == "fastapi"
-Provides-Extra: flask
-Requires-Dist: flask; extra == "flask"

devinspector-2.0.6/devinspector/__init__.py

@@ -1,3 +0,0 @@
-from .core import AuditCore, audit
-
-__all__ = ["audit", "AuditCore"]

devinspector-2.0.6/devinspector/fastapi.py

@@ -1,39 +0,0 @@
-import time
-from starlette.middleware.base import BaseHTTPMiddleware
-from starlette.requests import Request
-from .core import audit
-
-
-class DevInspectorMiddleware(BaseHTTPMiddleware):
-    async def dispatch(self, request: Request, call_next):
-        start_time = time.perf_counter()
-        status_code = 500
-
-        try:
-            response = await call_next(request)
-            status_code = response.status_code
-            return response
-        except Exception as exc:
-            if hasattr(exc, "status_code"):
-                status_code = exc.status_code
-
-            audit.capture_error(
-                exc,
-                metadata={
-                    "path": request.url.path,
-                    "method": request.method,
-                    "statusCode": status_code,
-                },
-            )
-            raise exc
-        finally:
-            duration_ms = (time.perf_counter() - start_time) * 1000
-            user_agent = request.headers.get("user-agent", "")
-
-            audit.capture_request(
-                method=request.method,
-                url=str(request.url),
-                status_code=status_code,
-                duration_ms=duration_ms,
-                user_agent=user_agent,
-            )

devinspector-2.0.6/devinspector/flask.py

@@ -1,55 +0,0 @@
-import time
-from flask import Flask, g, request
-from .core import audit
-
-
-class DevInspectorFlask:
-    def __init__(self, app: Flask = None):
-        if app is not None:
-            self.init_app(app)
-
-    def init_app(self, app: Flask):
-        app.before_request(self._before_request)
-        app.after_request(self._after_request)
-        app.teardown_request(self._teardown_request)
-
-    def _before_request(self):
-        g._devinspector_start_time = time.perf_counter()
-
-    def _after_request(self, response):
-        self._record_metric(response.status_code)
-        return response
-
-    def _teardown_request(self, exception=None):
-        if exception:
-            status_code = 500
-            if hasattr(exception, "code"):
-                status_code = exception.code
-
-            audit.capture_error(
-                exception,
-                metadata={
-                    "path": request.path,
-                    "method": request.method,
-                    "statusCode": status_code,
-                },
-            )
-            if not getattr(g, "_devinspector_metric_recorded", False):
-                self._record_metric(status_code)
-
-    def _record_metric(self, status_code: int):
-        start_time = getattr(g, "_devinspector_start_time", None)
-        if start_time is None:
-            return
-
-        duration_ms = (time.perf_counter() - start_time) * 1000
-        user_agent = request.headers.get("User-Agent", "")
-
-        audit.capture_request(
-            method=request.method,
-            url=request.url,
-            status_code=status_code,
-            duration_ms=duration_ms,
-            user_agent=user_agent,
-        )
-        g._devinspector_metric_recorded = True

devinspector-2.0.6/devinspector.egg-info/PKG-INFO

@@ -1,15 +0,0 @@
-Metadata-Version: 2.4
-Name: devinspector
-Version: 2.0.6
-Summary: SDK Python de monitoramento e auditoria em tempo real | DevInspector
-Author-email: DevInspector <suporte@devinspector.com.br>
-License: MIT
-Project-URL: Homepage, https://devinspector.com.br
-Keywords: monitoring,error-tracking,audit,devinspector,fastapi,flask
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Provides-Extra: fastapi
-Requires-Dist: fastapi; extra == "fastapi"
-Requires-Dist: starlette; extra == "fastapi"
-Provides-Extra: flask
-Requires-Dist: flask; extra == "flask"

devinspector-2.0.6/pyproject.toml

@@ -1,23 +0,0 @@
-[build-system]
-requires = ["setuptools>=61.0"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "devinspector"
-version = "2.0.6"
-description = "SDK Python de monitoramento e auditoria em tempo real | DevInspector"
-readme = "README.md"
-requires-python = ">=3.8"
-license = {text = "MIT"}
-authors = [
-    {name = "DevInspector", email = "suporte@devinspector.com.br"}
-]
-keywords = ["monitoring", "error-tracking", "audit", "devinspector", "fastapi", "flask"]
-dependencies = []
-
-[project.optional-dependencies]
-fastapi = ["fastapi", "starlette"]
-flask = ["flask"]
-
-[project.urls]
-Homepage = "https://devinspector.com.br"