Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sensorup.com/llms.txt

Use this file to discover all available pages before exploring further.

Audit History Banner

​
What is Asset Audit History?

Asset Audit History provides a comprehensive, immutable record of every change made to your assets and their operational status. This complete audit trail ensures regulatory compliance, enables troubleshooting, and provides full transparency into who made what changes and when.

Complete Audit Trail

Every change tracked and logged

Regulatory Compliance

Audit-ready documentation

Full Transparency

Know who changed what and when

​
Why Use Asset Audit History?

The Problem

Without audit history tracking:No visibility into who changed asset data or statusCan’t investigate why assets are excluded from reportsNo compliance trail for regulatory auditsRisk of unauthorized changes going unnoticed

The Solution

With Asset Audit History:Complete record of all asset and status changesClear audit trail showing who, what, whenQuick investigation of data changesAudit-ready compliance documentation

​
Core Capabilities

Track All Asset Changes

Asset Audit History automatically captures every change to your assets, including:Asset Property Changes
  • Asset creation and initial configuration
  • Updates to asset properties (name, location, type, etc.)
  • Changes to extension properties and custom fields
  • Asset geometry modifications
  • Asset type changes
Status Changes
  • Status creation (initial operational status)
  • Status updates (active/inactive transitions)
  • Status deletion (removal of status periods)
  • Status overlap resolution
Automatic Tracking: All changes are automatically recorded by the system - no manual logging required. The audit trail is immutable and cannot be altered after creation.
Each audit entry provides comprehensive information for investigation and compliance:
FieldDescriptionPurpose
Event TypeType of change (Created, Updated, Deleted, etc.)Understand what action occurred
Event TimePrecise timestamp of the changeTrack when changes happened
UserWho made the change (user ID and name)Accountability and investigation
Property ChangesDetailed before/after values for each propertySee exactly what changed
Status ChangesComplete status change history by status IDTrack operational status transitions
VersionSequential version numberUnderstand change sequence
Correlation IDLink related changes togetherTrack bulk operations
See exactly what changed with detailed before-and-after comparison:

​
Old and New Values

  • Old Value: The property value before the change (null for newly created properties)
  • New Value: The property value after the change (null for deleted properties)
  • Property Type: Data type (string, number, boolean, datetime, geometry, JSON)

​
Property Source Identification

  • Asset Properties: Grouped by asset type (site, well, facility, etc.)
  • Status Properties: Grouped by status ID for status changes
  • Extension Properties: Custom fields and extensions tracked separately
Status Changes: When an asset is set to “Inactive,” the audit history provides the critical trail showing who made the change and when, explaining why detections from that asset are excluded from reports.

​
Common Use Cases

Investigating Excluded Assets When an asset’s detections aren’t appearing in reports, check the audit history to see who set it to “Inactive” status and when. This helps you understand whether the exclusion is correct or needs to be addressed. Regulatory Compliance Generate complete audit trails showing all asset and status changes for regulatory submissions. The immutable audit log provides defensible documentation for compliance audits. Troubleshooting Data Issues When asset data appears incorrect or inconsistent, review the audit history to see what changes were made, by whom, and when. This helps identify the source of data issues quickly. Tracking Integration Changes Monitor changes made by system integrations (marked as “System” user) to ensure your source-of-truth systems are correctly synchronizing asset data. Annual Data Audits Review the complete history of asset status changes and property updates to maintain comprehensive compliance records and verify data integrity.

​
Viewing Asset Audit History

Access Requirements: Audit history is available to all authenticated users who have permission to view the asset.
1

Navigate to Asset

From the Assets section, select the asset you want to investigate to open its details page.
2

Access History Tab

Select the History tab to view the complete audit trail for this asset.
The history shows all changes in reverse chronological order (most recent first).
3

Review Change Details

Each audit entry shows:
  • What Changed: Event type and property changes
  • When: Precise timestamp of the change
  • Who: User who made the change (or “System” for automated changes)
  • Details: Before and after values for each changed property
4

Filter Results (Optional)

Use filters to narrow down the audit trail:
  • Filter by event type (e.g., only status changes)
  • Filter by date range (e.g., changes in last quarter)
  • Filter by user (e.g., changes by specific person)

​
Understanding Change Events

ASSET_CREATED
  • Recorded when an asset is first created
  • Shows all initial property values
  • Old values are null (no previous state)
Asset created audit history eventASSET_UPDATED
  • Recorded when any asset property is modified
  • Shows before and after values for changed properties
  • Includes property name, type, and source partition
Asset updated audit history eventASSET_DELETED
  • Recorded when an asset is removed
  • Shows all final property values
  • New values are null (no new state)

​
Using Audit History via API

​
Query Asset Audit History

query GetAssetAuditHistory($assetId: ID!, $assetTypeId: ID!) {
  asset(id: $assetId, assetTypeId: $assetTypeId) {
    id
    name
    auditing {
      history(
        assetId: $assetId
        assetTypeId: $assetTypeId
        filter: {
          eventTypes: [ASSET_UPDATED, STATUS_UPDATED]
          fromTime: "2024-01-01T00:00:00Z"
          toTime: "2024-12-31T23:59:59Z"
        }
      ) {
        eventType
        version
        eventTime
        user {
          userId
          userName
        }
        correlationId
        assetPropertyChanges {
          propertySourcePartition
          propertyName
          propertyType
          oldValue {
            ... on StringValue { value }
            ... on NumberValue { value }
            ... on BooleanValue { value }
          }
          newValue {
            ... on StringValue { value }
            ... on NumberValue { value }
            ... on BooleanValue { value }
          }
        }
        statusChanges {
          id
          propertyChanges {
            propertyName
            propertyType
            oldValue { ... on StringValue { value } }
            newValue { ... on StringValue { value } }
          }
        }
      }
    }
  }
}

​
Query Only Status Changes

query GetAssetStatusHistory($assetId: ID!, $assetTypeId: ID!) {
  asset(id: $assetId, assetTypeId: $assetTypeId) {
    id
    auditing {
      history(
        assetId: $assetId
        assetTypeId: $assetTypeId
        filter: {
          eventTypes: [STATUS_CREATED, STATUS_UPDATED, STATUS_DELETED]
        }
      ) {
        eventType
        eventTime
        user {
          userName
        }
        statusChanges {
          id
          propertyChanges {
            propertyName
            oldValue { ... on StringValue { value } }
            newValue { ... on StringValue { value } }
          }
        }
      }
    }
  }
}
GraphQL Federation: Asset Audit History is available through the GraphQL API with full federation support. See GraphQL API documentation for authentication and query details.

​
FAQ / Troubleshooting

Assets created before the audit history feature was implemented may not have historical data. The system automatically initializes audit tracking when you first access the history for legacy assets, creating a baseline event. All changes going forward will be tracked.
  1. Go to the asset’s History tab
  2. Filter by event type: STATUS_CREATED or STATUS_UPDATED
  3. Look for entries where the status changed to “INACTIVE”
  4. The User field shows who made the change
  5. The Event Time shows exactly when it happened
  6. Review Property Changes to see the status reason
This information is critical for understanding why an asset’s detections are excluded from reports.
No. The audit trail is immutable by design. Once a change is recorded, it cannot be altered or deleted. This ensures the integrity of your audit records for regulatory compliance and forensic investigation.
  • System changes: Made by automated integrations syncing data from your source-of-truth systems (e.g., Maximo, SAP). Most asset property updates come from these integrations.
  • User changes: Made by authenticated users manually updating asset data or status. The most important user action is setting assets to Active/Inactive status.
For assets created after the audit history feature was deployed, the complete history is available from the asset’s creation. For legacy assets, history begins when the audit system was initialized for that asset (typically when first accessed) or when the audit history feature was activated.
  • Old value is null: The property was newly created (e.g., ASSET_CREATED event or new property added)
  • New value is null: The property was deleted (e.g., ASSET_DELETED event or property removed)
  • This is normal and helps distinguish between creation, updates, and deletions
A correlation ID links related changes together, especially during bulk operations or batch imports. When you see the same correlation ID on multiple audit entries, it means those changes were part of the same operation or transaction. This helps you understand the context of changes.
Yes. You can use the GraphQL API to query audit history and export the data to your preferred format for compliance reporting. The API provides complete access to all audit trail information including timestamps, users, and property changes.

​
Key Benefits

Regulatory Confidence
Meet regulatory requirements with complete, immutable audit trails documenting every asset and status change with full user attribution.
Quick Investigation
Rapidly troubleshoot data issues by reviewing exactly what changed, who made the change, and when it occurred, eliminating guesswork.
Data Integrity
Ensure accountability and prevent unauthorized changes with comprehensive tracking of all asset modifications and status updates.
Transparency
Provide full visibility into asset data lifecycle for auditors, compliance officers, and operational teams with detailed change history.

​
Next Steps

Asset Status

Learn about managing operational status and how status changes appear in audit history.

Assets Model

Understand the complete asset data model and what properties are tracked in audit history.

GraphQL API

Access audit history programmatically through the GraphQL API for custom integrations.