Eventos de Tracer

Tracer emite sus hechos de negocio JSON públicos como CloudEvents 1.0 en modo de contenido binario sobre Kafka. Tracer es el componente de Midaz que se despliega por separado y el único productor del contrato studio.lerian.tracer.* de esta página.

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. Tu ID de tenant, o el literal `default` cuando el evento no tiene tenant.
`ce-schemaversion`	`1.1.0` para `limit.created` y `limit.updated`. `1.0.0` para los otros 10 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 está deshabilitada hasta que STREAMING_ENABLED=true y la configuración del broker se completa con éxito. Cuando está habilitada, Tracer emite después del cambio de estado de negocio. No usa un outbox transaccional.

Política: cada definición JSON pública es un fact con entrega directa, manejo de DLQ on_routable_failure y fallback_on_circuit_open.
Límite real de Tracer: como Tracer no tiene outbox, 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.
Requisito del consumidor: la entrega del broker es al menos una vez para los registros publicados. Haz que los handlers sean idempotentes y deduplica 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.activatedTema: lerian.streaming.tracerRuta DLQ: lerian.streaming.tracer.dlqEsquema: 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.createdTema: lerian.streaming.tracerRuta DLQ: lerian.streaming.tracer.dlqEsquema: 1.1.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
  resetTime: 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.deactivatedTema: lerian.streaming.tracerRuta DLQ: lerian.streaming.tracer.dlqEsquema: 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.deletedTema: lerian.streaming.tracerRuta DLQ: lerian.streaming.tracer.dlqEsquema: 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.draftedTema: lerian.streaming.tracerRuta DLQ: lerian.streaming.tracer.dlqEsquema: 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.updatedTema: lerian.streaming.tracerRuta DLQ: lerian.streaming.tracer.dlqEsquema: 1.1.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
  resetTime: 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.activatedTema: lerian.streaming.tracerRuta DLQ: lerian.streaming.tracer.dlqEsquema: 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.createdTema: lerian.streaming.tracerRuta DLQ: lerian.streaming.tracer.dlqEsquema: 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.deactivatedTema: lerian.streaming.tracerRuta DLQ: lerian.streaming.tracer.dlqEsquema: 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.deletedTema: lerian.streaming.tracerRuta DLQ: lerian.streaming.tracer.dlqEsquema: 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.draftedTema: lerian.streaming.tracerRuta DLQ: lerian.streaming.tracer.dlqEsquema: 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.updatedTema: lerian.streaming.tracerRuta DLQ: lerian.streaming.tracer.dlqEsquema: 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.1.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.1.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.

Primeros pasos

API de Validaciones

API de Reglas

API de Límites

API de Eventos de Auditoría

API de Dashboards

Manejo de errores

Eventos

Eventos de Tracer

Envelope de CloudEvents

Temas, manifiesto y enrutamiento

Semántica de entrega y fallos

Contratos completos de `data`

Índice de eventos emitidos

​Envelope de CloudEvents

​Temas, manifiesto y enrutamiento

​Semántica de entrega y fallos

​Contratos completos de data

​Índice de eventos emitidos

Envelope de CloudEvents

Temas, manifiesto y enrutamiento

Semántica de entrega y fallos

Contratos completos de `data`

Índice de eventos emitidos