Data model


This topic provides details on the data model of TrueSight Intelligence.



What data can you collect for analyzing?

Almost everything! TrueSight Intelligence provides a solution to assist with your need to visualize, explore, and analyze data that impacts your systems and business.

metrics_system.png

metrics_business.png



TrueSight Intelligence data model

tsierdiag.png



Metrics data model

Metric definitions provide performance information for a source, which is an instance of a source type. Source types and metric definitions are used to define the metrics, and providing information that enables you to send measures (values) for these metrics.

tsimetadata.png

Source_mapping.png



Define metrics and send measures data

You must follow the recommended sequence for defining metrics and sending measures data to TrueSight Intelligence.


metric_measure0.png

metric_measure.png


Apps and app associations

Apps provide you the capability to associate data from multiple sources, and view this data collectively for the purpose of analytics.

  • Metric data is tagged when a measurement is sent with the app_id at the source.
  • For events, the tag ID field is used for specifying the name of the app.

apps.png

In the following example, metric data from Source_1 and Source_3 is associated to App X, whereas data from Source_2, Source_4, and Source_5 is associated to App Y.

source_app.png


Events data model

Events provide you the flexibility to send and visualize any set of values at a given point in time.

Event_classes.png

datamodel_events.png

Click here to view a description for the event fields.

Fields

Description

eventId

Unique ID for the event

createdAt

Epoch time when the event was created.
Automatically set by the server, if not specified.

receivedAt

Epoch time when the event was received by the server

Title

Text field to specify the title

EventClass

Categorize similar events

Fingerprint fields

List of fields used to uniquely identify an event

Properties

(optional) Custom properties for an event

Tags

Any tag. For example, app_id="my app"

Source

Source of the event

Sender

Sender of the event

Message

Text field to specify a detailed message

Severity

Event severity. For example, info, minor, major

Status

Event status. For example, open, close

API_mapping.png


Send event data

Events are uniquely identified by the fingerprint fields and grouped by event class.

Fingerprint fields are defined to have unique values that do not change with time. For example, an event ID is used to identify an event, and the status of the event can be either 'open' or 'close'. The event ID field is never updated in this case. If the value for any fingerprint field is changed, a new event is created.

Tip

Ensure that the value of the fingerprint fields are not changed when sending multiple values for other event parameters.

Specify any key:values pairs as part of the event definition. A maximum of 128 fields can be defined for each event, provided the total size of each event is less than 32K.

Where to go from here

Quick-start

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*