Skip to main content

SparkLogs event fields

These fields identify the event kind, topic, reason, payload, and source-pack class.

FieldTypeUnitMeaning
sparklogs.kindstringThe event category that selects its row contract and downstream handling. Producers define additive values; consumers must not infer a closed vocabulary from this field.
sparklogs.topicstringWhich state topic the row belongs to, and the namespace its readings sit in under sparklogs.data.
sparklogs.reasonstringThe stable reason code naming why the event was emitted or how a curated event was classified. It is globally unique, so the reason code alone identifies the meaning without a topic or kind qualifier.
sparklogs.instancestringThe opaque id of the subject this row is about, led by its subject type. Omitted entirely for a condition about the whole host, never filled with a sentinel.
sparklogs.open_monitors_countintegercountHow many conditions this topic currently holds open, stamped on the full table so a reader who has only the inventory knows whether to expect monitor rows.
sparklogs.window_partialboolThe measurement window behind these readings was not fully populated, so a rate or a percentile over it rests on fewer samples than usual. Absent when the window was whole.
sparklogs.dataobjectThe readings, under sparklogs.data.<topic>. A table topic writes an array of row objects; a host-scoped topic writes one flat object. An inventory and a delta write the same path, so one predicate finds a value whichever way the evidence arrived.
sparklogs.classstringThe event's temporal role, such as a notable condition, recovery, ending, or context.