Core concepts and vocabulary

TrackMe has a small, consistent vocabulary. These terms appear on every page of this guide and in the interface itself. Learn them once here.

The mental model in one sentence

TrackMe tracks entities (grouped into components, isolated inside virtual tenants); on every cycle a decision maker gives each entity a state and a score, policies classify it, and alerting turns critical states into notifications.

Dedicated tenant types add a second, shorter sentence:

A dedicated tenant watches the platform around the data; its policies raise a finding for each condition they detect on one object, and an object’s findings are decided together as one Finding group.

Everything below expands one word of those sentences.

Entity

An entity is the fundamental unit TrackMe monitors — one data source, one host, one metric feed, one scheduled search, or one custom object you defined. Each entity has an object_id (its identity, e.g. an index|sourcetype pair), a current state, a score, and the metadata attached to it (priority, tags, labels, SLA, and so on).

There is no global list of entities — every entity lives inside exactly one virtual tenant.

Component

Every entity belongs to one of seven components, which decide what is measured: DSM, DHM, MHM, VOL, FLX, FQM, WLK. The component determines the metric axes (delay, latency, volume, licensed volume, quality, execution health…) and the tracking logic applied. See What is TrackMe? for the one-line description of each, and Part 3 for the deep dives.

The products that watch the platform around the data are not more components: they are dedicated tenant types, described next.

Dedicated tenant type

A dedicated tenant type is a tenant that has no entities and no state colour. It watches one part of the platform around your data and raises findings instead. There are seven:

  • User Activity Monitoring (UAM) — the audit trail and the introspection of a deployment turned into accounts, scheduled searches, activity, resource usage and privileges. See User Activity Monitoring.

  • Splunk HEC — the HTTP Event Collector endpoints, pools and tokens of one Splunk deployment, from the telemetry Splunk already writes. See Splunk HEC.

  • Splunk S2S — the receiving side of forwarding: the receivers, the intermediate forwarders and the pools they form. See Splunk S2S.

  • Splunk UF Fleet — every forwarding agent and the Deployment Servers that manage them, at any fleet size. See Splunk UF Fleet.

  • Splunk Forwarder Collectors — the forwarders used as collection points and every input they run: add-ons, scripted and modular inputs, syslog files. See Splunk Forwarder Collectors.

  • Cribl Stream — the Cribl metrics already in Splunk and the Cribl Leader API turned into the inventory, the traffic, the Workers and the findings of one Cribl Stream deployment. See Cribl Stream and Cribl Edge.

  • Cribl Edge — the Fleets of a Cribl Edge Leader and their Edge Nodes, read in bulk from the Leader’s node directory. See Cribl Edge.

A tenant is either an entity tenant or one dedicated tenant type, never both. The seven share one findings model: policies, findings, Finding groups, assignment, notifications, findings actions and an AI Agent. See Findings, Finding groups and findings actions.

Finding

A finding is raised by a policy of a dedicated tenant about one object — an account, a HEC endpoint, a receiver pool, a forwarding agent, a collector’s input, a Cribl Destination — with its evidence and a severity from Informational to Critical. The same condition on the same object is always the same finding: it keeps its notes and its history across runs, and recovers by itself when the condition clears. A healthy object has no finding at all. See A finding and its lifecycle.

Finding group

A Finding group gathers every finding about one object: one status, one assignee, one severity and one notification thread. It is the unit you triage — investigate, resolve, dismiss, assign or snooze — so an object with three problems is still one decision. See Finding groups.

Virtual Tenant

A virtual tenant is an isolated monitoring domain — typically one customer, one environment, or one team. Each tenant has its own entities, its own configuration and policies, its own set of Splunk roles, and optionally its own remote Splunk deployment to monitor.

Tenants are the unit of isolation and the unit of scale: you create, scope, experiment with, and destroy them independently. Everything else in TrackMe is scoped to a tenant.

Virtual Group

A virtual group is a read-only card that aggregates entities from several tenants into a single cross-tenant view — useful for a NOC screen that spans many customers. A virtual group is not a tenant: it does not run monitoring of its own, it only summarises what the underlying tenants already computed.

Entity state

At every cycle each entity is assigned an object state — one of four colours:

State

Meaning

🟢 green

Healthy — no active anomaly.

🟠 orange

Warning — a non-critical anomaly is active (score above zero, below critical).

🔴 red

Critical — the entity has crossed the critical threshold.

🔵 blue

Suppressed — the entity is protected from alerting (logical-group protection, a disruption grace period, or maintenance), even though an anomaly may be present.

The state machine and the blue “protected” state are covered in Part 4.

Impact score

The state is derived from a numeric impact score. TrackMe adds up the contributions of everything that is currently wrong with an entity — delay breach, latency breach, ML outliers, breached dynamic thresholds — into a single total_score:

  • total_score == 0 → green

  • 0 < total_score < 100 → orange

  • total_score ≥ 100 → red

The weight of each contribution is configurable per tenant and can be overridden per entity, so you decide whether (say) a latency breach matters more than a volume drop. Impact scoring is covered in Part 4.

Tracker

A tracker is a scheduled search that runs on a cycle and feeds the decision maker. Trackers are what make TrackMe active rather than a static dashboard — they periodically re-evaluate every entity. Most are managed for you; advanced users can add hybrid trackers (Part 7) to inject extra signals.

Decision maker

The decision maker is the shared engine that, each cycle, reads an entity’s metrics and metadata and computes its state and score. It is the single place where “is this entity healthy?” is answered, so the answer is consistent across the UI, alerts, and the API.

Policy

Manually setting priority or SLA on thousands of entities does not scale. A policy assigns metadata automatically using a rule — a regex, a Splunk lookup, or an SPL search. Three policy families exist: priority, tags, and SLA. Policies suggest; a manual override always wins, and removing a policy auto-cleans the assignments it made. Policies are covered in Part 5.

On a dedicated tenant, a policy is something else: the rule that evaluates one condition and raises a finding. Each one is built in or written in SPL, enabled or not, with a default severity and its own settings.

Priority, tags, labels, SLA

These are the four kinds of classification metadata you attach to entities:

  • Priority — critical / high / medium / low / pending. How much an entity matters.

  • Tags — free-form string metadata for filtering and grouping.

  • Labels — a curated, colour-coded catalogue of chips (distinct from tags: different storage, different UI, and assignable by rules).

  • SLA class — platinum / gold / silver with associated thresholds.

Note

Tags and labels are not the same feature. Both are chip-style metadata, but tags are free-form strings while labels come from a managed, coloured catalogue and can be assigned automatically by rules. Part 5 shows them side by side.

Logical group

A logical group clusters N entities and judges them collectively. If the percentage of green members stays above a threshold, struggling members are demoted from red to blue (“group protection”) — so one flaky member of a healthy cluster does not page you.

Disruption queue

The disruption queue is a grace period. When an anomaly first appears, the entity is held in blue until the anomaly has persisted for a configured minimum time — absorbing transient blips so only sustained problems escalate to red.

Acknowledgment (ACK)

An acknowledgment suppresses further notifications for an entity you already know about. Sticky ack stays until you clear it; unsticky ack expires automatically after a set period. Ack can be revoked automatically if the underlying anomaly reason changes.

Notable event

A notable event is the traditional Splunk alerting output — an event written for Enterprise Security or a custom correlation workflow. It is one of several delivery channels TrackMe’s stateful alerting can drive; see Part 6.

See also