egutierrez
47fac22230
- .claude/CLAUDE.md - .claude/commands/subagentes.md - .claude/rules/INDEX.md - .mcp.json - bash/functions/cybersecurity/analyze_dns.md - bash/functions/cybersecurity/audit_http_headers.md - bash/functions/cybersecurity/audit_ssh_config.md - bash/functions/cybersecurity/check_firewall.md - bash/functions/cybersecurity/detect_suspicious_users.md - bash/functions/cybersecurity/encrypt_file.md - ... Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
57 lines
2.4 KiB
Markdown
57 lines
2.4 KiB
Markdown
---
|
|
name: registry_telemetry
|
|
lang: py
|
|
domain: infra
|
|
version: 0.1.0
|
|
purity: impure
|
|
kind: function
|
|
description: "Telemetria de invocaciones del registry desde Python. Patchea via sys.meta_path los paquetes del registry (core, finance, metabase, etc.) y registra cada llamada en call_monitor.operations.db. Activable con FN_TELEMETRY=1. Issue 0085c."
|
|
tags: [telemetry, monitoring, registry, import-hook, pendiente-usar]
|
|
signature: "install() -> bool"
|
|
error_type: "error_go_core"
|
|
returns_optional: false
|
|
params:
|
|
- name: FN_TELEMETRY (env)
|
|
desc: "Si vale '1', install() registra el meta_path finder y envuelve cada modulo del registry al importarse. Si no, no-op."
|
|
- name: FN_REGISTRY_ROOT (env)
|
|
desc: "Override de la raiz del registry. Si no se setea, se descubre walking up desde el archivo del modulo."
|
|
- name: CLAUDE_SESSION_ID (env)
|
|
desc: "ID de sesion Claude Code, persistido en cada fila de calls. Vacio si no se setea."
|
|
output: "True si el finder se instalo, False si FN_TELEMETRY != '1' o si ya estaba instalado."
|
|
uses_functions: []
|
|
uses_types: []
|
|
imports:
|
|
- functools
|
|
- importlib.abc
|
|
- importlib.util
|
|
- sqlite3
|
|
- sys
|
|
- time
|
|
example: |
|
|
# Activacion en heredoc o app
|
|
import os
|
|
os.environ["FN_TELEMETRY"] = "1"
|
|
import sys, os.path as p
|
|
sys.path.insert(0, p.join(os.environ["FN_REGISTRY_ROOT"], "python", "functions"))
|
|
import infra.registry_telemetry # auto-install al importarse
|
|
from core import filter_list, map_list # automaticamente envueltos
|
|
filter_list(lambda x: x > 0, [1, -2, 3]) # registrado en calls
|
|
file_path: "python/functions/infra/registry_telemetry.py"
|
|
tested: false
|
|
notes: |
|
|
Patron: meta_path importer (PEP 451). Cuando el agente importa `core`, `finance`, etc.,
|
|
el finder intercepta la carga del modulo, deja que el loader real ejecute, y luego
|
|
envuelve cada callable definido en el modulo con un decorator que mide duration
|
|
y registra en calls (con tool_used='python_wrapper').
|
|
|
|
Fail-safe: si la BD no existe, INSERT falla, o cualquier excepcion ocurre durante
|
|
el wrap, se ignora silenciosamente. NUNCA rompe el codigo cliente.
|
|
|
|
function_id heuristic: `{name}_py_{domain}` donde domain = nombre del paquete
|
|
top-level (`core`, `finance`, etc.). Coincide con convencion del registry
|
|
siempre que el paquete top-level se llame igual que el dominio.
|
|
|
|
Privacidad: solo function_id, duration_ms, success, error_class, type_name del error.
|
|
NUNCA args, kwargs, return values. error_snippet truncado a 240 chars.
|
|
---
|