Billable hours reporting gadget
LogSense for Jira includes a dashboard gadget that displays aggregated billable hours from worklog metadata stored in Forge KVS.
Add the gadget to a dashboard
- Open the Jira dashboard where you want the report.
- Click Add gadget.
- Search for the LogSense billable hours gadget.
- Click Add and configure the gadget.
Configuration
After adding, the gadget requests context parameters (per version 1.0.0):
| Parameter | Description |
|---|---|
| Space | Space whose worklogs are included in the report. |
| Date range | Aggregation period (if available in gadget UI). |
| Additional filters | Billable, work type, or other criteria per exposed configuration. |
Gadget view
The gadget queries issues via POST /rest/api/3/search/jql with parallel processing and reads each worklog's metadata from Forge KVS (worklog-meta:{issueId}:{worklogId}) to distinguish billable from non-billable entries.
Typical columns and metrics
Depending on gadget configuration in 1.0.0, it may show:
- Total billable hours in the selected period.
- Breakdown by user, space, or work type (if applicable).
- Comparison with non-billable hours when the report includes them.
Only worklogs logged with LogSense (active provider) include billable/non-billable classification in KVS. Native worklogs from before adoption may lack complete metadata.
Performance
Gadget queries use paginated JQL search (nextPageToken) and parallel worklog processing to reduce load time on high-volume dashboards.
Best practices
- Place the gadget on space management or billing dashboards, not operational sprint views.
- Align the date range with the client's billing cycle.
- Ensure teams log time with correct billable classification from day one.