Release Notes
v2.4.0
February 2026
New Features
-
AuditLoggingService.apiNameproperty - New property for REST API configuration. Defaults to'default'. -
eAuditLoggingComponentsenum - New enum for component identifiers, useful for component registration and customization:import { eAuditLoggingComponents } from '@abpjs/audit-logging';
// Available components:
// eAuditLoggingComponents.AuditLogs = 'AuditLogging.AuditLogsComponent'
v2.2.0
February 2026
- Version alignment with @abpjs/core
v2.1.1
February 2026
- Version alignment with @abpjs/core
v2.0.0
January 2026
New Features
AuditLoggingStateService- New state service for programmatic audit logging operations:dispatchGetAuditLogs(params?)- Fetch audit logs and update internal statedispatchGetAverageExecutionDurationPerDay(params?)- Fetch average execution duration statisticsdispatchGetErrorRate(params?)- Fetch error rate statisticsgetResult()- Get current audit logs resultgetTotalCount()- Get total count of audit logsgetAverageExecutionStatistics()- Get cached average execution statisticsgetErrorRateStatistics()- Get cached error rate statistics
Example
import { AuditLoggingStateService } from '@abpjs/audit-logging';
import { RestService } from '@abpjs/core';
const restService = new RestService();
const stateService = new AuditLoggingStateService(restService);
// Fetch audit logs
await stateService.dispatchGetAuditLogs({
startTime: '2026-01-01',
endTime: '2026-01-31',
maxResultCount: 10,
});
const logs = stateService.getResult();
console.log(`Found ${stateService.getTotalCount()} logs`);
// Fetch statistics
await stateService.dispatchGetAverageExecutionDurationPerDay({
startDate: '2026-01-01',
endDate: '2026-01-31',
});
const avgStats = stateService.getAverageExecutionStatistics();
await stateService.dispatchGetErrorRate({
startDate: '2026-01-01',
endDate: '2026-01-31',
});
const errorStats = stateService.getErrorRateStatistics();
v1.0.0
January 2026
- Version alignment with @abpjs/core v1.0.0
v0.7.2 (Initial Release)
January 2026
Features
- AuditLogsComponent - Complete audit logs management UI with:
- Paginated table with sorting
- Advanced filtering (user, URL, HTTP method, status code, execution duration, exceptions)
- Detail modal with tabbed view (Overall, Actions, Changes)
- Entity change tracking with property-level diffs
- Action tracking with service/method names and parameters
Hooks
- useAuditLogs - Hook for managing audit log state:
auditLogs- List of audit logstotalCount- Total count for paginationselectedLog- Currently selected logisLoading/error- Loading and error statesaverageExecutionStats/errorRateStats- Statistics datasortKey/sortOrder- Sorting statefetchAuditLogs()- Fetch with query parametersgetAuditLogById()- Get single logfetchAverageExecutionStats()/fetchErrorRateStats()- Statistics
Services
- AuditLoggingService with methods:
getAuditLogs()- Get paginated audit logsgetAuditLogById()- Get single audit log by IDgetAverageExecutionDurationPerDayStatistics()- Execution duration statsgetErrorRateStatistics()- Error rate statistics
Constants
- AUDIT_LOGGING_ROUTES - Pre-configured routes
- HTTP_METHODS - List of HTTP methods for filtering
- HTTP_STATUS_CODES - HTTP status codes with descriptions
Models
AuditLogging.Log- Audit log entryAuditLogging.EntityChange- Entity change recordAuditLogging.PropertyChange- Property change recordAuditLogging.AuditLogAction- Action recordAuditLogging.AuditLogsQueryParams- Query parametersStatistics.Filter/Statistics.Data/Statistics.Response- Statistics types
TypeScript
- Full TypeScript support with exported interfaces and namespaces