Skip to main content

Log Model

New Log Model Specification

Attribute TypeAttribute NameAttribute IDField TypeQuick Filter?DescriptionDifference from Historical Model (new attributes)
PredefinedIndexindexstringThe index to which the log belongs
Occurrence timemonitorTimeUsdatetimeThe occurrence time parsed from the log message, in milliseconds
Collection timerecordTimeMsdatetime
Ingest timereceiveTimeMsdatetimeNew
Log UIDlogUidstringUnique identifier for the log data
traceIdtraceIdstringYesUsed to associate logs with a traceNew
spanIdspanIdstringYesUsed to associate logs with a spanNew
sessionIdsessionIdstringYesUsed to associate logs with an applicationNew
Log statuslogStatusstringYesIndicates the status of each log; defaults to unknown if not provided. In the log model, log status is a dictionary, but in the metadata it is not a dictionary
Log messagelogMessagestringThe raw log text
Log sourcelogSourcestringYesIdentifies the origin of the log; used together with traceId and deviceId for context correlation
Log patternlogPatternstringAggregated content after pattern recognition
Log file pathlogFilePathstringYesOriginal path of the log fileNew
Normalized log path(empty)YesNormalised according to advanced settings in the log collection configuration, processed by the agent (ETL operators can support user mapping, after which normalisation is performed via rules)New
Related entitiesreleatedEntityjsonEntity type is not fixed and is data‑driven; the JSON includes entity type and entity ID. All entity‑related queries are either directly on related entities or via instance ID lookupsNew
Log agent versionlogAgentVersionstringYesThe agent tag content, collected using the same logic as in the legacy version; only the data model has been adjustedNew
Log agent typelogAgentTypestringYesNew
Device namedeviceNamestringYesThe platform does not have a "device" concept; defining it as a predefined attribute may confuse users about the relationship between device and other information. Agent‑collected logs use the hostname as deviceName, while application‑agent logs use the application nameNew
Device IDdeviceIdnumberYesFor agent‑collected logs: machine GUID; for application‑agent logs: the terminal application deviceId. These two fields are used for log context correlationNew
sourceHashsourceHashstringYesUnique identifier for the log fileNew
Tags (following data tags)tagYes1. The current model does not have a tag field; if needed, it must be added to the model. 2. Tags come from custom source path definitions, third‑party log ingestion, data‑flow processing, ETL processing (manual conditions), etc. When written, they are stored as data tags and displayed on the UI
Data centredataCentrtIdstringYesTreated as a fixed parsing attribute. In ETL data flows and processing, it is displayed as a fixed parsing attribute configuration and cannot be modified – to ensure backward compatibility. For data centre values: for agent‑collected or third‑party logs, the data centre is selected at deployment or ingestion time. Whether defined as a predefined or parsed attribute is acceptable because both are pre‑defined in the model
Entity attributesService nameentity,service.customizedNametext
Service instance nameentity,serviceinstance.customizedNametext
Process nameentity.process,customizedNametext
Container nameentity.container.customizedNametext
Pod nameentity.k8spod.customizedNametext
Application nameentity.app.customizedNametext
Host nameentity.host.customizedNametext
Kubernetes cluster nameentity.k8scluster.customizedNametext
Kubernetes node nameentity.k8snode.customizedNametext
Kubernetes namespace nameentity.k8snamespace.customizedNametext
Kubernetes workload nameentity.k8sworkload.customizedNametext
Kubernetes service nameentity.k8sservice.customizedNametext

Field Descriptions

  • Attribute Type:

    • Predefined attributes: Fixed log properties that represent basic log information and exist for all log data.
    • Tags: Differs from the legacy log tag concept – agent‑reported tags are no longer retained; useful information is extracted into predefined tags. In the new model, tags are data labels for display purposes. They originate from tags added during custom source path definition, selected in data flows, applied during ETL ingestion, or from OTel protocol ingestion.
    • Parsed attributes: Dynamic metadata attributes registered through data processing, annotation mapping, or ETL ingestion. Not all parsed attributes are displayed in the quick‑filter list.
    • Entity attributes: Attributes from the metadata entity model, covering a fixed set of entity types.
  • Attribute Name: The name of the attribute field.

  • Field Type:

    • Predefined attributes have fixed types; parsed attributes are automatically identified as text or numeric types at creation time.
  • Quick Filter:

    • The log model includes both predefined and parsed attributes, but not all are shown in the log query filter bar or referenced by other services.
    • This flag indicates whether the attribute should be exposed for user use.
    • Attributes marked as quick‑filter are available in the log query page configuration.