Eventos de Tracer

Referencia de todos los hechos de eventos JSON públicos emitidos por el componente Tracer en Midaz, incluidos los headers de CloudEvents, los temas de aplicación, el comportamiento de entrega y los contratos completos de datos.

El components/tracer actual de Midaz emite sus hechos de negocio JSON públicos como CloudEvents 1.0 en modo de contenido binario sobre Kafka mediante lib-streaming. Este es el productor del contrato studio.lerian.tracer.* de esta página. Tracer es el componente de Midaz que se despliega por separado y el único productor documentado aquí. No atribuyas estos eventos a un repositorio separado.

​

Catálogo JSON público de Tracer

El manifiesto de components/tracer de Midaz contiene las siguientes definiciones verificadas. Todas las 12 definiciones tienen llamadores de producción que no son de prueba. Ninguna es solo de catálogo. Midaz no inicializa un consumidor de lib-streaming para estos hechos.

Catalogadas	Emitidas	Solo catálogo
12	12	0

​

Envelope de CloudEvents

Todo hecho JSON público usa el envelope compartido que aparece a continuación. Los headers transportan la información de enrutamiento y de esquema. El valor de Kafka transporta el objeto data en JSON.

Header	Presencia y valor
ce-specversion	Siempre 1.0.
ce-id	Siempre; identificador de evento opaco definido por el productor.
ce-source	Siempre tracer.
ce-type	Siempre studio.lerian.tracer.<resource>.<event>.
ce-time	Siempre; timestamp de emisión en formato RFC 3339.
ce-resourcetype	Siempre; el token de recurso de la clave de definición.
ce-eventtype	Siempre; el token de evento de la clave de definición.
ce-subject	Siempre p.ID para estos 12 contratos.
ce-tenantid	Siempre presente. El ID de tenant resuelto en ámbito multi-tenant; literal default en ámbito de un solo tenant o sin tenant.
ce-schemaversion	Siempre 1.0.0 para los 12 hechos JSON públicos.
ce-datacontenttype	application/json.

​

Temas, manifiesto y enrutamiento

El tema de la aplicación identifica a Midaz Tracer, no a un evento individual. Enruta un registro por ce-resourcetype y ce-eventtype, y valida ce-schemaversion antes de decodificar su valor data.

• Hechos: lerian.streaming.tracer
• Ruta DLQ: lerian.streaming.tracer.dlq
• Manifiesto: GET /v1/streaming/manifest expone el catálogo JSON público y el mapeo de temas, incluso mientras la publicación está desactivada.

​

Semántica de entrega y fallos

La publicación se inicia solo cuando STREAMING_ENABLED=true y la configuración del broker tiene éxito. Cuando está habilitada, Midaz emite después del cambio de estado de negocio. No conecta un outbox writer, un outbox repository, un transactional outbox ni un outbox relay de lib-streaming.

• Política: toda definición JSON pública es un fact con entrega directa, manejo de DLQ on_routable_failure y fallback_on_circuit_open configurados por lib-streaming v3.
• Límite real de Midaz: como no hay un outbox writer conectado, el fallback de circuito abierto no puede persistir un evento. Las rutas de emisión registran y absorben los errores de publicación en lugar de devolverlos al comando de negocio. Esto no es un contrato de outbox atómico.
• Límite del consumidor: Midaz no conecta ningún consumidor para estos hechos, y la política de productor directo no establece una garantía de entrega transaccional. Se recomienda que los consumidores hagan que los handlers sean idempotentes y deduplicar con (ce-source, ce-id).

​

Contratos completos de data

Estas declaraciones al estilo TypeScript reflejan las etiquetas JSON de data del CloudEvent en Midaz. Cada nombre de campo es su nombre JSON. ? significa que el campo tiene omitempty. | null significa que el campo es nullable y nunca está ausente. Un comentario de tipo de origen conserva exactamente el tipo del inventario. Todos los campos de estos 12 payloads de Tracer están presentes (omitempty: false). Los campos nullable siguen llevando null cuando están ausentes.

limit.activated

Clave de definición: limit.activated (LimitActivatedDefinition)

Evento: studio.lerian.tracer.limit.activated

Tema: lerian.streaming.tracer

Ruta DLQ: lerian.streaming.tracer.dlq

Esquema: 1.0.0 (application/json)

Se dispara cuando: ActivateLimitCommand activa un límite con éxito.

Asunto: p.ID

// limit.activated
type LimitActivatedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

limit.created

Clave de definición: limit.created (LimitCreatedDefinition)

Evento: studio.lerian.tracer.limit.created

Tema: lerian.streaming.tracer

Ruta DLQ: lerian.streaming.tracer.dlq

Esquema: 1.0.0 (application/json)

Se dispara cuando: CreateLimitCommand crea un límite con éxito.

Asunto: p.ID

type RuleScopePayload = { // Go: RuleScopePayload
  segmentId: string | null // *string; wire null: true; omitempty: false
  portfolioId: string | null // *string; wire null: true; omitempty: false
  accountId: string | null // *string; wire null: true; omitempty: false
  merchantId: string | null // *string; wire null: true; omitempty: false
  transactionType: string | null // *string; wire null: true; omitempty: false
  subType: string | null // *string; wire null: true; omitempty: false
}

// limit.created
type LimitCreatedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  limitType: string // string; wire null: false; omitempty: false
  asset: string // string; wire null: false; omitempty: false
  scopes: RuleScopePayload[] // []RuleScopePayload; wire null: false; omitempty: false
  activeTimeStart: string | null // *string; wire null: true; omitempty: false
  activeTimeEnd: string | null // *string; wire null: true; omitempty: false
  customStartDate: string | null // *string; wire null: true; omitempty: false
  customEndDate: string | null // *string; wire null: true; omitempty: false
  resetAt: string | null // *string; wire null: true; omitempty: false
  createdAt: string // string; wire null: false; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

limit.deactivated

Clave de definición: limit.deactivated (LimitDeactivatedDefinition)

Evento: studio.lerian.tracer.limit.deactivated

Tema: lerian.streaming.tracer

Ruta DLQ: lerian.streaming.tracer.dlq

Esquema: 1.0.0 (application/json)

Se dispara cuando: DeactivateLimitCommand desactiva un límite con éxito.

Asunto: p.ID

// limit.deactivated
type LimitDeactivatedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

limit.deleted

Clave de definición: limit.deleted (LimitDeletedDefinition)

Evento: studio.lerian.tracer.limit.deleted

Tema: lerian.streaming.tracer

Ruta DLQ: lerian.streaming.tracer.dlq

Esquema: 1.0.0 (application/json)

Se dispara cuando: DeleteLimitCommand elimina un límite con éxito.

Asunto: p.ID

// limit.deleted
type LimitDeletedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  deletedAt: string // string; wire null: false; omitempty: false
}

limit.drafted

Clave de definición: limit.drafted (LimitDraftedDefinition)

Evento: studio.lerian.tracer.limit.drafted

Tema: lerian.streaming.tracer

Ruta DLQ: lerian.streaming.tracer.dlq

Esquema: 1.0.0 (application/json)

Se dispara cuando: DraftLimitCommand mueve un límite a DRAFT con éxito.

Asunto: p.ID

// limit.drafted
type LimitDraftedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

limit.updated

Clave de definición: limit.updated (LimitUpdatedDefinition)

Evento: studio.lerian.tracer.limit.updated

Tema: lerian.streaming.tracer

Ruta DLQ: lerian.streaming.tracer.dlq

Esquema: 1.0.0 (application/json)

Se dispara cuando: UpdateLimitCommand actualiza un límite con éxito.

Asunto: p.ID

type RuleScopePayload = { // Go: RuleScopePayload
  segmentId: string | null // *string; wire null: true; omitempty: false
  portfolioId: string | null // *string; wire null: true; omitempty: false
  accountId: string | null // *string; wire null: true; omitempty: false
  merchantId: string | null // *string; wire null: true; omitempty: false
  transactionType: string | null // *string; wire null: true; omitempty: false
  subType: string | null // *string; wire null: true; omitempty: false
}

// limit.updated
type LimitUpdatedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  limitType: string // string; wire null: false; omitempty: false
  asset: string // string; wire null: false; omitempty: false
  scopes: RuleScopePayload[] // []RuleScopePayload; wire null: false; omitempty: false
  activeTimeStart: string | null // *string; wire null: true; omitempty: false
  activeTimeEnd: string | null // *string; wire null: true; omitempty: false
  customStartDate: string | null // *string; wire null: true; omitempty: false
  customEndDate: string | null // *string; wire null: true; omitempty: false
  resetAt: string | null // *string; wire null: true; omitempty: false
  createdAt: string // string; wire null: false; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

rule.activated

Clave de definición: rule.activated (RuleActivatedDefinition)

Evento: studio.lerian.tracer.rule.activated

Tema: lerian.streaming.tracer

Ruta DLQ: lerian.streaming.tracer.dlq

Esquema: 1.0.0 (application/json)

Se dispara cuando: ActivateRuleService activa una regla con éxito.

Asunto: p.ID

// rule.activated
type RuleActivatedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  activatedAt: string | null // *string; wire null: true; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

rule.created

Clave de definición: rule.created (RuleCreatedDefinition)

Evento: studio.lerian.tracer.rule.created

Tema: lerian.streaming.tracer

Ruta DLQ: lerian.streaming.tracer.dlq

Esquema: 1.0.0 (application/json)

Se dispara cuando: CreateRuleCommand crea una regla con éxito.

Asunto: p.ID

type RuleScopePayload = { // Go: RuleScopePayload
  segmentId: string | null // *string; wire null: true; omitempty: false
  portfolioId: string | null // *string; wire null: true; omitempty: false
  accountId: string | null // *string; wire null: true; omitempty: false
  merchantId: string | null // *string; wire null: true; omitempty: false
  transactionType: string | null // *string; wire null: true; omitempty: false
  subType: string | null // *string; wire null: true; omitempty: false
}

// rule.created
type RuleCreatedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  action: string // string; wire null: false; omitempty: false
  scopes: RuleScopePayload[] // []RuleScopePayload; wire null: false; omitempty: false
  createdAt: string // string; wire null: false; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

rule.deactivated

Clave de definición: rule.deactivated (RuleDeactivatedDefinition)

Evento: studio.lerian.tracer.rule.deactivated

Tema: lerian.streaming.tracer

Ruta DLQ: lerian.streaming.tracer.dlq

Esquema: 1.0.0 (application/json)

Se dispara cuando: DeactivateRuleService desactiva una regla con éxito.

Asunto: p.ID

// rule.deactivated
type RuleDeactivatedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  deactivatedAt: string | null // *string; wire null: true; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

rule.deleted

Clave de definición: rule.deleted (RuleDeletedDefinition)

Evento: studio.lerian.tracer.rule.deleted

Tema: lerian.streaming.tracer

Ruta DLQ: lerian.streaming.tracer.dlq

Esquema: 1.0.0 (application/json)

Se dispara cuando: DeleteRuleService elimina una regla con éxito.

Asunto: p.ID

// rule.deleted
type RuleDeletedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  deletedAt: string // string; wire null: false; omitempty: false
}

rule.drafted

Clave de definición: rule.drafted (RuleDraftedDefinition)

Evento: studio.lerian.tracer.rule.drafted

Tema: lerian.streaming.tracer

Ruta DLQ: lerian.streaming.tracer.dlq

Esquema: 1.0.0 (application/json)

Se dispara cuando: DraftRuleService mueve una regla a DRAFT con éxito.

Asunto: p.ID

// rule.drafted
type RuleDraftedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

rule.updated

Clave de definición: rule.updated (RuleUpdatedDefinition)

Evento: studio.lerian.tracer.rule.updated

Tema: lerian.streaming.tracer

Ruta DLQ: lerian.streaming.tracer.dlq

Esquema: 1.0.0 (application/json)

Se dispara cuando: UpdateRuleCommand actualiza una regla con éxito.

Asunto: p.ID

type RuleScopePayload = { // Go: RuleScopePayload
  segmentId: string | null // *string; wire null: true; omitempty: false
  portfolioId: string | null // *string; wire null: true; omitempty: false
  accountId: string | null // *string; wire null: true; omitempty: false
  merchantId: string | null // *string; wire null: true; omitempty: false
  transactionType: string | null // *string; wire null: true; omitempty: false
  subType: string | null // *string; wire null: true; omitempty: false
}

// rule.updated
type RuleUpdatedDataV1 = {
  id: string // string; wire null: false; omitempty: false
  status: string // string; wire null: false; omitempty: false
  action: string // string; wire null: false; omitempty: false
  scopes: RuleScopePayload[] // []RuleScopePayload; wire null: false; omitempty: false
  createdAt: string // string; wire null: false; omitempty: false
  updatedAt: string // string; wire null: false; omitempty: false
}

​

Índice de eventos emitidos

Clave de definición	ce-type	Esquema	Asunto	Se dispara cuando
limit.activated	studio.lerian.tracer.limit.activated	1.0.0	p.ID	ActivateLimitCommand activa un límite con éxito.
limit.created	studio.lerian.tracer.limit.created	1.0.0	p.ID	CreateLimitCommand crea un límite con éxito.
limit.deactivated	studio.lerian.tracer.limit.deactivated	1.0.0	p.ID	DeactivateLimitCommand desactiva un límite con éxito.
limit.deleted	studio.lerian.tracer.limit.deleted	1.0.0	p.ID	DeleteLimitCommand elimina un límite con éxito.
limit.drafted	studio.lerian.tracer.limit.drafted	1.0.0	p.ID	DraftLimitCommand mueve un límite a DRAFT con éxito.
limit.updated	studio.lerian.tracer.limit.updated	1.0.0	p.ID	UpdateLimitCommand actualiza un límite con éxito.
rule.activated	studio.lerian.tracer.rule.activated	1.0.0	p.ID	ActivateRuleService activa una regla con éxito.
rule.created	studio.lerian.tracer.rule.created	1.0.0	p.ID	CreateRuleCommand crea una regla con éxito.
rule.deactivated	studio.lerian.tracer.rule.deactivated	1.0.0	p.ID	DeactivateRuleService desactiva una regla con éxito.
rule.deleted	studio.lerian.tracer.rule.deleted	1.0.0	p.ID	DeleteRuleService elimina una regla con éxito.
rule.drafted	studio.lerian.tracer.rule.drafted	1.0.0	p.ID	DraftRuleService mueve una regla a DRAFT con éxito.
rule.updated	studio.lerian.tracer.rule.updated	1.0.0	p.ID	UpdateRuleCommand actualiza una regla con éxito.