Tracer events

Reference all public JSON event facts emitted by the Tracer component in Midaz, including CloudEvents headers, application topics, delivery behavior, and complete data contracts.

The current Midaz components/tracer emits its public JSON business facts as CloudEvents 1.0 in binary content mode over Kafka through lib-streaming. This is the producer for the studio.lerian.tracer.* contract on this page. Tracer is the separately deployed Midaz component and the sole producer documented here. Do not attribute these events to a separate repository.

Public JSON Tracer catalog

The Midaz components/tracer manifest contains the following verified definitions. All 12 definitions have non-test production callers. None is catalog-only. Midaz does not bootstrap a lib-streaming consumer for these facts.

Cataloged	Emitted	Catalog-only
12	12	0

CloudEvents envelope

Every public JSON fact uses the shared envelope below. The headers carry routing and schema information. The Kafka value carries the JSON data object.

Header	Presence and value
ce-specversion	Always 1.0.
ce-id	Always; opaque producer-defined event identifier.
ce-source	Always tracer.
ce-type	Always studio.lerian.tracer.<resource>.<event>.
ce-time	Always; RFC 3339 emission timestamp.
ce-resourcetype	Always; the resource token from the definition key.
ce-eventtype	Always; the event token from the definition key.
ce-subject	Always p.ID for these 12 contracts.
ce-tenantid	Always present. The resolved tenant ID in multi-tenant scope; literal default in single-tenant or tenantless scope.
ce-schemaversion	Always 1.0.0 for the 12 public JSON facts.
ce-datacontenttype	application/json.

Topics, manifest, and routing

The application topic identifies Midaz Tracer, not an individual event. Route a record by ce-resourcetype and ce-eventtype, and validate ce-schemaversion before decoding its data value.

• Facts: lerian.streaming.tracer
• Route DLQ: lerian.streaming.tracer.dlq
• Manifest: GET /v1/streaming/manifest exposes the public JSON catalog and topic mapping, including while publication is off.

Delivery and failure semantics

Publication starts only when STREAMING_ENABLED=true and broker configuration succeeds. When enabled, Midaz emits after the business-state change. It does not wire a lib-streaming outbox writer, outbox repository, transactional outbox, or outbox relay.

• Policy: every public JSON definition is a fact with direct delivery, on_routable_failure DLQ handling, and fallback_on_circuit_open configured by lib-streaming v3.
• Actual Midaz boundary: because no outbox writer is wired, the circuit-open fallback cannot persist an event. Emit paths log and swallow publication errors instead of returning them to the business command. This is not an atomic outbox contract.
• Consumer boundary: Midaz wires no consumer for these facts, and the direct producer policy does not establish a transactional delivery guarantee. Consumers should make handlers idempotent and deduplicate with (ce-source, ce-id).

Complete data contracts

These TypeScript-style declarations mirror the CloudEvent data JSON tags in Midaz. Every field name is its JSON name. ? means the field has omitempty. | null means the field is nullable and never absent. A source-type comment preserves the inventory type exactly. All fields in these 12 Tracer payloads are present (omitempty: false). Nullable fields still carry null when absent.

limit.activated

Definition key: limit.activated (LimitActivatedDefinition)

Event: studio.lerian.tracer.limit.activated

Topic: lerian.streaming.tracer

Route DLQ: lerian.streaming.tracer.dlq

Schema: 1.0.0 (application/json)

Fires when: ActivateLimitCommand successfully activates a limit.

Subject: 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

Definition key: limit.created (LimitCreatedDefinition)

Event: studio.lerian.tracer.limit.created

Topic: lerian.streaming.tracer

Route DLQ: lerian.streaming.tracer.dlq

Schema: 1.0.0 (application/json)

Fires when: CreateLimitCommand successfully creates a limit.

Subject: 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

Definition key: limit.deactivated (LimitDeactivatedDefinition)

Event: studio.lerian.tracer.limit.deactivated

Topic: lerian.streaming.tracer

Route DLQ: lerian.streaming.tracer.dlq

Schema: 1.0.0 (application/json)

Fires when: DeactivateLimitCommand successfully deactivates a limit.

Subject: 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

Definition key: limit.deleted (LimitDeletedDefinition)

Event: studio.lerian.tracer.limit.deleted

Topic: lerian.streaming.tracer

Route DLQ: lerian.streaming.tracer.dlq

Schema: 1.0.0 (application/json)

Fires when: DeleteLimitCommand successfully deletes a limit.

Subject: p.ID

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

limit.drafted

Definition key: limit.drafted (LimitDraftedDefinition)

Event: studio.lerian.tracer.limit.drafted

Topic: lerian.streaming.tracer

Route DLQ: lerian.streaming.tracer.dlq

Schema: 1.0.0 (application/json)

Fires when: DraftLimitCommand successfully moves a limit to DRAFT.

Subject: 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

Definition key: limit.updated (LimitUpdatedDefinition)

Event: studio.lerian.tracer.limit.updated

Topic: lerian.streaming.tracer

Route DLQ: lerian.streaming.tracer.dlq

Schema: 1.0.0 (application/json)

Fires when: UpdateLimitCommand successfully updates a limit.

Subject: 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

Definition key: rule.activated (RuleActivatedDefinition)

Event: studio.lerian.tracer.rule.activated

Topic: lerian.streaming.tracer

Route DLQ: lerian.streaming.tracer.dlq

Schema: 1.0.0 (application/json)

Fires when: ActivateRuleService successfully activates a rule.

Subject: 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

Definition key: rule.created (RuleCreatedDefinition)

Event: studio.lerian.tracer.rule.created

Topic: lerian.streaming.tracer

Route DLQ: lerian.streaming.tracer.dlq

Schema: 1.0.0 (application/json)

Fires when: CreateRuleCommand successfully creates a rule.

Subject: 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

Definition key: rule.deactivated (RuleDeactivatedDefinition)

Event: studio.lerian.tracer.rule.deactivated

Topic: lerian.streaming.tracer

Route DLQ: lerian.streaming.tracer.dlq

Schema: 1.0.0 (application/json)

Fires when: DeactivateRuleService successfully deactivates a rule.

Subject: 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

Definition key: rule.deleted (RuleDeletedDefinition)

Event: studio.lerian.tracer.rule.deleted

Topic: lerian.streaming.tracer

Route DLQ: lerian.streaming.tracer.dlq

Schema: 1.0.0 (application/json)

Fires when: DeleteRuleService successfully deletes a rule.

Subject: p.ID

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

rule.drafted

Definition key: rule.drafted (RuleDraftedDefinition)

Event: studio.lerian.tracer.rule.drafted

Topic: lerian.streaming.tracer

Route DLQ: lerian.streaming.tracer.dlq

Schema: 1.0.0 (application/json)

Fires when: DraftRuleService successfully moves a rule to DRAFT.

Subject: 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

Definition key: rule.updated (RuleUpdatedDefinition)

Event: studio.lerian.tracer.rule.updated

Topic: lerian.streaming.tracer

Route DLQ: lerian.streaming.tracer.dlq

Schema: 1.0.0 (application/json)

Fires when: UpdateRuleCommand successfully updates a rule.

Subject: 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
}

Emitted event index

Definition key	ce-type	Schema	Subject	Fires when
limit.activated	studio.lerian.tracer.limit.activated	1.0.0	p.ID	ActivateLimitCommand successfully activates a limit.
limit.created	studio.lerian.tracer.limit.created	1.0.0	p.ID	CreateLimitCommand successfully creates a limit.
limit.deactivated	studio.lerian.tracer.limit.deactivated	1.0.0	p.ID	DeactivateLimitCommand successfully deactivates a limit.
limit.deleted	studio.lerian.tracer.limit.deleted	1.0.0	p.ID	DeleteLimitCommand successfully deletes a limit.
limit.drafted	studio.lerian.tracer.limit.drafted	1.0.0	p.ID	DraftLimitCommand successfully moves a limit to DRAFT.
limit.updated	studio.lerian.tracer.limit.updated	1.0.0	p.ID	UpdateLimitCommand successfully updates a limit.
rule.activated	studio.lerian.tracer.rule.activated	1.0.0	p.ID	ActivateRuleService successfully activates a rule.
rule.created	studio.lerian.tracer.rule.created	1.0.0	p.ID	CreateRuleCommand successfully creates a rule.
rule.deactivated	studio.lerian.tracer.rule.deactivated	1.0.0	p.ID	DeactivateRuleService successfully deactivates a rule.
rule.deleted	studio.lerian.tracer.rule.deleted	1.0.0	p.ID	DeleteRuleService successfully deletes a rule.
rule.drafted	studio.lerian.tracer.rule.drafted	1.0.0	p.ID	DraftRuleService successfully moves a rule to DRAFT.
rule.updated	studio.lerian.tracer.rule.updated	1.0.0	p.ID	UpdateRuleCommand successfully updates a rule.