Dashboard Actions
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:
| Column | Description |
|---|---|
| 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:
| Field | Description |
|---|---|
| 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 | Description |
|---|---|
| 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.
| Data Type | Description |
|---|---|
| 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 | Description |
|---|---|
| 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:
| Column | Description |
|---|---|
| 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