argus-obs-semconv

Convenciones semánticas de Argus para librerías.

pip install argus-obs-semconv

import argus_semconv

El nombre de instalación y el de importación no coinciden, y conviene decirlo antes que nada. Se instala argus-obs-semconv y se importa argus_semconv.

El prefijo -obs- es deliberado: elegimos nombres que no existían en PyPI para que un fallo del índice no acabara instalando el paquete de un desconocido con el nombre que esperábamos. El módulo conservó el nombre corto porque es lo que se escribe cien veces.

Va arriba porque es lo primero con lo que tropieza quien lo adopta.

Cuándo usar este paquete y cuándo no

La garantía

Si la aplicación que importa tu librería no ha inicializado un SDK de OpenTelemetry, toda la instrumentación de este paquete es no-op con coste cero. Si sí lo ha inicializado, se enciende sola usando su configuración, su endpoint y su muestreo.

Eso significa que puedes instrumentar tus librerías sin imponer nada a nadie.

from argus_semconv import genai

# En Axonium, dentro del cliente de inferencia:
with genai("chat", provider="ollama", request_model=model) as g:
    resp = await self._call_backend(...)
    g.usage(input_tokens=resp.prompt_tokens, output_tokens=resp.completion_tokens)
    g.backend(backend_id=backend.id, ttft_ms=resp.ttft_ms)

Las constantes están generadas

attributes.py se genera desde libs/semconv-model/argus.yaml. No lo edites a mano: ejecuta python tools/gen_semconv.py. Un test de CI verifica que no hay deriva entre el modelo y lo commiteado.