Create and Manage Entity Types
Learn how to create, configure, edit, and manage ingestion entity types in Sprinto, including custom fields, reference fields, entity records, and monitoring visibility.
Entity types define how ingestion data is structured inside Sprinto.
Each entity type acts as a schema that determines:
Which fields exist
What type of data is stored
How records are organised
How ingestion plans map incoming payloads
Entity types provide a reusable data model for ingestion workflows.
Once configured, ingestion plans can store records against these entity types.
Before You Begin
Ensure that:
You have access to the Ingestion module
You understand the type of data being ingested
You know which fields are required
Related entity relationships are identified, if applicable
Access the Entities Page
To manage entity types:
Log in to the Sprinto dashboard.
Go to Ingestion.
Select the Entities tab.
The Entities dashboard displays all configured entity types.
Understand the Entities Dashboard
The Entities page provides a central view of all entity types.
Each entity type represents a logical data structure.
The dashboard typically includes:
Name
Entity type name
Description
Optional explanation
Entities
Number of records linked to the entity type
Actions
Opens entity records
You can review entity counts and open related records directly from this page.
Open Entity Management
The Manage Entity option provides access to entity configuration.
Open Manage Entity
Go to the Entities tab.
Click Manage Entity.
Sprinto opens the entity management drawer.
The drawer displays:
Existing entity types
Field counts
Entity configuration options
Create an Entity Type
Create an entity type when ingestion requires a new data structure.
Add an Entity Type
Open Manage Entity.
Click Add Entity Type.
Configure entity details.
Save the entity type.
The new entity type becomes available immediately.
Configure Entity Details
Each entity type includes several configuration sections.
Basic Information
Define:
Entity type name
Description
Entity names should clearly represent the ingested object.
Examples include:
Device
Incident
Asset
Repository
CloudAccount
Standard Fields
Entity types automatically include standard system fields.
These fields are always present.
Standard fields commonly include:
Name
Human-readable record name
Identifier
Unique record identifier
URL
Source reference link
Last Seen on Source
Latest observed timestamp
Standard fields cannot be removed.
Add Custom Fields
Custom fields allow additional metadata to be stored.
Use custom fields to capture ingestion-specific values.
Add a Custom Field
In the Custom Fields section, click Add Custom Field.
Enter the field configuration.
Save the field.
You can add multiple custom fields.
Custom Field Configuration
When adding a field, configure:
Field Name
Name of the field
Data Type
Stored value type
Description
Optional explanation
Allow User Editing
Allows manual updates
Supported Data Types
Entity fields support multiple value types.
String
Text-based value
Boolean
True/false value
Long
Integer value
Double
Decimal number
Timestamp
Date and time value
JSON
Structured JSON object
Choose a data type that matches the incoming payload.
Allow User Editing
Enable Allow User Editing to permit manual updates to field values.
When enabled, additional options become available.
Add Editable Options
Enable Allow User Editing.
Add a selectable option.
Click Add.
Repeat as needed.
These options become available during entity editing.
Add Reference Fields
Reference fields create relationships between entity types.
Use reference fields when one entity depends on another.
Examples include:
Device → User
Incident → Asset
Resource → Account
Add a Reference Field
Open the Reference Fields section.
Click Add Reference Field.
Configure the relationship.
Click Add Entity.
Multiple reference fields can be added.
Reference Field Configuration
Configure:
Field Name
Relationship name
Reference Type
Relationship type
Target Entity
Linked entity type
Target Field
Field used for mapping
Description
Optional explanation
Reference fields help connect ingestion datasets.
Edit an Entity Type
Existing entity types can be modified.
Edit an Entity Type
Open Manage Entity.
Select the required entity type.
Click Edit.
Update the configuration.
Click Update Entity to save changes.
Changes become available immediately.
View Entity Records
Each entity type contains ingestion records.
You can view these records directly from the Entities dashboard.
Open Entity Records
Locate an entity type.
Click View Entities.
Sprinto opens the entity details page.
Entity Details Page
The entity details page contains multiple tabs.
Tabs include:
Details
Entities
Monitoring
Each tab provides visibility into a different aspect of the entity type.
Details Tab
The Details tab displays schema information.
This includes:
Entity metadata
Field definitions
Configuration information
Field tables display:
Field Name
Entity field
Type
Stored value type
Required
Whether the field is mandatory
Description
Field explanation
Entities Tab
The Entities tab lists all records stored for the entity type.
Each row represents an ingested record.
You can:
Search records
View identifiers
Review timestamps
Open record details
View an Entity Record
Open an individual record to inspect ingestion output.
Open Entity Record Details
Go to the Entities tab.
Locate a record.
Click View.
Sprinto opens the entity record page.
Entity Record Details
The entity record view displays:
Metadata
Includes:
Entity identifier
Created timestamp
Updated timestamp
Source reference
Field Values
Displays all mapped custom values.
Raw Data
Displays ingestion metadata or payload structure.
Monitoring Visibility
Shows checks associated with the entity.
Monitoring Tab
The Monitoring tab shows checks associated with the selected entity type.
This allows you to review:
Linked monitoring checks
Status visibility
Related evaluation coverage
Monitoring helps validate how ingestion entities participate in workflows.
Entity Workflow
A typical entity lifecycle follows this sequence:
Create an entity type.
Define fields.
Configure references.
Save the entity schema.
Attach the entity to ingestion plans.
Ingest records.
Review entity records.
Monitor related checks.
Best Practices
Use the following recommendations when creating entity types:
Use clear entity names
Add descriptions for custom fields
Use reference fields only when relationships exist
Match field types to source payloads
Keep field structures reusable
Limit JSON fields when structured fields are available
Use editable fields sparingly
Review entity records after ingestion
Related Information
Last updated