Observability: PUBSUB_EXCLUDED_EVENT_TYPES

libs/agent_framework/docs/IC_NOC_GRL_LANGFUSE_NATIVE.md

@@ -50,6 +50,10 @@ Cada evento vira uma observation/span com `name` igual ao código:
 - `NOC.001`
 - `GRL.004`
 
+No modo `LANGFUSE_TRACE_MODE=compact`, eventos `IC.*`, `AGA.*` e `NOC.*`
+continuam visíveis como spans filhos do span raiz. Eles não são substituídos por
+tags da trace. Eventos técnicos de baixo nível continuam sujeitos à compactação.
+
 A metadata recebe automaticamente:
 
 - `tag`

libs/agent_framework/docs/README_TIM_OBSERVER_PAYLOAD_FIX.md

@@ -17,6 +17,7 @@ Esta versão corrige dois gaps da migração do `agent_framework_oci`:
   - Publica flat por padrão.
   - Mantém modo legado por configuração.
   - Exclui `NOC.*` do Pub/Sub por padrão, seguindo a lib antiga.
+  - Permite excluir tipos de evento específicos do Pub/Sub por configuração.
   - Injeta `sequence` automaticamente no payload flat antes do publish.
 
 - `src/agent_framework/analytics/tim_sequence.py`
@@ -45,6 +46,10 @@ Esta versão corrige dois gaps da migração do `agent_framework_oci`:
 PUBSUB_PAYLOAD_MODE=flat
 PUBSUB_EXCLUDE_NOC=true
 
+# Lista opcional, separada por vírgulas, de tipos de evento não publicados no Pub/Sub.
+# Os eventos continuam disponíveis para os demais destinos de observabilidade.
+PUBSUB_EXCLUDED_EVENT_TYPES=GRL.NATIVE_OUTPUT_GUARDRAILS
+
 # Sequence automático por sessão no payload Pub/Sub flat
 PUBSUB_SEQUENCE_ENABLED=true