PHPackages                             cloudcommerce/admin-activity-tracker - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. cloudcommerce/admin-activity-tracker

ActiveMagento2-module

cloudcommerce/admin-activity-tracker
====================================

Magento 2 module for comprehensive admin user activity tracking and auditing

1.0.1(8mo ago)013↓100%1MITPHPPHP >=8.0

Since Sep 8Pushed 8mo agoCompare

[ Source](https://github.com/ybrajendra/admin-activity-tracker)[ Packagist](https://packagist.org/packages/cloudcommerce/admin-activity-tracker)[ RSS](/packages/cloudcommerce-admin-activity-tracker/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (3)Used By (0)

CloudCommerce Admin Activity Tracker
====================================

[](#cloudcommerce-admin-activity-tracker)

A comprehensive Magento 2 module for tracking and auditing admin user activities in the backend panel.

Features
--------

[](#features)

- **Complete Activity Tracking**: Monitors admin login/logout, entity creation, updates, and deletions
- **Change Detection**: Compares current data with snapshots to identify specific changes
- **Configurable Exclusions**: Exclude specific sections from tracking (products, orders, customers, etc.)
- **Data Retention Management**: Automatic cleanup of old activity logs based on configurable retention period
- **Comprehensive Logging**: Custom logger with automatic log rotation and compression
- **Admin Grid Interface**: View and filter activity logs through dedicated admin grid
- **Security Focused**: Tracks IP addresses, user agents, and timestamps for security auditing

Installation
------------

[](#installation)

### Method 1: Composer Installation (Recommended)

[](#method-1-composer-installation-recommended)

1. Install via Composer:

    ```
    composer require cloudcommerce/admin-activity-tracker
    ```
2. Enable the module:

    ```
    php bin/magento module:enable CloudCommerce_AdminActivityTracker
    php bin/magento setup:upgrade
    php bin/magento setup:di:compile
    php bin/magento cache:flush
    ```

### Method 2: Manual Installation

[](#method-2-manual-installation)

1. Copy the module to your Magento installation:

    ```
    app/code/CloudCommerce/AdminActivityTracker/

    ```
2. Enable the module:

    ```
    php bin/magento module:enable CloudCommerce_AdminActivityTracker
    php bin/magento setup:upgrade
    php bin/magento setup:di:compile
    php bin/magento cache:flush
    ```

Configuration
-------------

[](#configuration)

Navigate to **Admin Panel > Admin Activity Tracker > Configuration**

### General Settings

[](#general-settings)

- **Enable Admin Activity Tracker**: Enable/disable the module
- **Exclude Sections from Tracking**: Select sections to exclude (products, categories, orders, CMS, customers, attributes)
- **Data Retention Period**: How long to keep activity data (1-36 months)
- **Cleanup Cron Schedule**: Cron expression for automatic cleanup (default: daily at 2 AM)

Usage
-----

[](#usage)

### Viewing Activity Logs

[](#viewing-activity-logs)

1. Go to **Admin Panel > Admin Activity Tracker > Activity Log**
2. Use filters to search by:
    - Admin user
    - Action type (login, logout, create, update, delete)
    - Entity type
    - Date range

### Tracked Activities

[](#tracked-activities)

- **Authentication**: Admin login/logout events
- **Entity Operations**: Create, update, delete operations on:
    - Products and categories
    - Orders and invoices
    - Customers and addresses
    - CMS pages and blocks
    - System configurations
    - And more...

Database Tables
---------------

[](#database-tables)

- `admin_activity_log`: Main activity log records
- `admin_activity_entity_snapshot`: Entity snapshots for change comparison

Permissions
-----------

[](#permissions)

Ensure admin users have the following ACL permissions:

- `CloudCommerce_AdminActivityTracker::admin`: Access to main module
- `CloudCommerce_AdminActivityTracker::activity_log`: View activity logs
- `CloudCommerce_AdminActivityTracker::config`: Modify module configuration

Technical Details
-----------------

[](#technical-details)

### Architecture

[](#architecture)

- **Repository Pattern**: `ActivityLogRepository` for data persistence
- **Observer Pattern**: Tracks model save/delete events
- **Plugin Pattern**: Intercepts specific operations (auth, config, etc.)
- **Snapshot System**: `SnapshotManager` for change detection
- **Custom Logger**: Dedicated logging with rotation

### Key Components

[](#key-components)

- **Observers**: `ModelSaveObserver`, `ModelDeleteObserver`, `InvoiceRegisterObserver`
- **Plugins**: `AdminAuthPlugin`, `ConfigPlugin`, `DesignConfigPlugin`, etc.
- **Models**: `ActivityLog`, `ActivityLogRepository`, `SnapshotManager`
- **Helpers**: `Config` for centralized configuration access

Troubleshooting
---------------

[](#troubleshooting)

### Common Issues

[](#common-issues)

1. **Permission Errors**: Ensure proper ACL permissions are assigned
2. **Database Errors**: Check database table creation and permissions
3. **Performance**: Use exclusions to reduce tracking overhead
4. **Log Size**: Configure appropriate retention periods

### Debugging

[](#debugging)

- Check logs in `var/log/admin_activity.log`
- Enable Magento developer mode for detailed error messages
- Use module's custom logger for debugging specific issues

Requirements
------------

[](#requirements)

- Magento 2.4.x
- PHP 8.0+

SEO Keywords
------------

[](#seo-keywords)

magento 2 admin activity tracker, magento admin audit log, magento user activity monitoring, magento backend tracking, magento admin security, magento activity logger, magento admin audit trail, magento user behavior tracking, magento admin session tracking, magento security module, magento admin monitoring extension, magento activity log extension, magento admin user tracking, magento backend audit, magento admin activity monitoring, magento security audit, magento admin login tracking, magento user activity log, magento admin change tracking, magento security logging

License
-------

[](#license)

Proprietary - CloudCommerce

###  Health Score

32

—

LowBetter than 71% of packages

Maintenance66

Regular maintenance activity

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

2

Last Release

240d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c7991ce6cf8f4a20010c0bb5c74e1ac35909f137187fe3b5e410aa723adc8a15?d=identicon)[ybrajendra](/maintainers/ybrajendra)

---

Top Contributors

[![ybrajendra](https://avatars.githubusercontent.com/u/23187081?v=4)](https://github.com/ybrajendra "ybrajendra (5 commits)")

### Embed Badge

![Health badge](/badges/cloudcommerce-admin-activity-tracker/health.svg)

```
[![Health](https://phpackages.com/badges/cloudcommerce-admin-activity-tracker/health.svg)](https://phpackages.com/packages/cloudcommerce-admin-activity-tracker)
```

###  Alternatives

[fastly/magento2

Fastly CDN Module for Magento 2.4.x

1564.2M1](/packages/fastly-magento2)[mage-os/module-automatic-translation

Automatic AI content translation for Mage-OS.

277.1k](/packages/mage-os-module-automatic-translation)[zepgram/module-rest

Technical module to industrialize API REST call with dependency injection pattern using Guzzle library

1326.2k](/packages/zepgram-module-rest)[graycore/magento2-graphql-introspection-cache

1015.2k](/packages/graycore-magento2-graphql-introspection-cache)[mage-os/mageos-common-async-events

Send REST requests to external endpoints asynchronously. This module implements the most common events like order creation and customer change.

147.7k2](/packages/mage-os-mageos-common-async-events)[mage-os/module-inventory-reservations-grid

Add a grid with the list of inventory reservations.

126.8k](/packages/mage-os-module-inventory-reservations-grid)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)