Stardog Unit Usage Reporting

This page discusses the Stardog Unit Usage Reporting feature, which allows users to monitor and export Stardog Unit (SDU) consumption data for their endpoints.

Page Contents

1. Overview
2. Accessing Usage Reports
   1. Syncing Usage Data
   2. Downloading the CSV Report
3. Data Aggregation
4. Additional Notes

Stardog Unit reporting is currently in Beta. This feature focuses on providing raw consumption data via CSV exports. Enhanced UI dashboards and granular breakdowns are planned for future releases.

Overview

A Stardog Unit (SDU) is a measure of compute time consumed while using the Stardog platform. 1 second of compute time = 1 Stardog Unit.

SDUs are tracked across the following activities:

• Query execution: All queries run from Studio, Explorer, or via the API
• Voicebox interactions: All queries run across both the UI and API
• Model generation: AI-assisted model and mapping generation in Designer
• Document processing: Spark-based document processing and external compute tasks

The following activities are excluded from SDU tracking:

• System database queries generated by Studio or Explorer (e.g., schema lookups, metadata retrieval)

Stardog Unit usage reporting provides visibility into how many units an endpoint consumes over time. By aggregating daily usage data, this feature allows you to monitor consumption patterns and export raw data for internal billing, chargeback, or capacity planning purposes.

Key capabilities:

• Daily Aggregation: Sums SDU usage for each endpoint every 24 hours.
• CSV Export: Provides downloadable consumption reports available.
• Multi-User Support: Aggregates usage, across all users and Stardog processes, for a comprehensive view of endpoint consumption.

Accessing Usage Reports

Usage reporting is located within the Manage Knowledge Graph Endpoints section of Stardog Cloud. To ensure your reports reflect the most recent data, you can perform two main actions: Syncing and Downloading.

Visibility & Permissions: The reporting options (Sync and Download) are visible and accessible only to Stardog Cloud Endpoint Owners.

Syncing Usage Data

Syncing pulls the latest consumption data from your Stardog endpoint and prepares it for export. The sync process may take a few moments to complete.

1. Navigate to your list of endpoints in Stardog Cloud.
2. Locate the endpoint you wish to report on.
3. Click the Actions (…) menu and select Sync Stardog Unit Usage. a. Up-to-Date Data: If the Sync option is greyed out, your data is already up to date and you can proceed directly to downloading.

Downloading the CSV Report

Once the data is synced, you can export it as a CSV file for your records.

1. Click the Actions (…) menu and select Download Stardog Unit Usage.
2. The browser will automatically download a CSV file containing the aggregated daily SDU consumption for that endpoint.

Data Aggregation

Reporting Logic:

• Endpoint-Level Aggregation: Usage is summed across all users of an endpoint into a single daily total.
• Daily Granularity: Each row in your exported CSV represents one 24-hour period of consumption.
• Remarks Field: This column captures any errors that may have occurred during that specific day’s aggregation process.
• Historical Data: If a sync has not been run recently, the download will reflect the data from the last successful sync.

Data is aggregated daily at 1:30 AM UTC. A previous day’s usage will not be included if the full 24-hour window has not yet completed by the time of sync/download.

An example report downloaded on 2026-02-20 would look as follows:

Additional Notes

As this feature is in Beta, please be aware of the following constraints:

• No User-Level Breakdown: Reports do not currently identify which specific user or action (e.g., query type) drove consumption.
• No Usage Found: Endpoints with no usage return a “no usage data found” notification instead of downloading an empty file.

• Platform Requirements: Usage reporting requires Stardog Platform version 12 or higher
  • SDU tracking data is available to download after upgrading to Stardog 12. Downloaded reports do not cover retroactive usage (any consumption prior to the Stardog 12 upgrade will not appear in reports).

---