PHPackages                             mage-os/module-admin-activity-log - 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. [Logging & Monitoring](/categories/logging)
4. /
5. mage-os/module-admin-activity-log

ActiveMagento2-module[Logging & Monitoring](/categories/logging)

mage-os/module-admin-activity-log
=================================

The Admin Activity extension makes it easy to track all admin activity with comprehensive audit logging.

2.0.1(3mo ago)2911.6k↑116.9%9[1 PRs](https://github.com/mage-os/module-admin-activity-log/pulls)1OSL-3.0PHPPHP >=8.2CI passing

Since Dec 29Pushed 3mo ago3 watchersCompare

[ Source](https://github.com/mage-os/module-admin-activity-log)[ Packagist](https://packagist.org/packages/mage-os/module-admin-activity-log)[ RSS](/packages/mage-os-module-admin-activity-log/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (10)Dependencies (16)Versions (17)Used By (1)

Mage-OS Admin Activity Log
==========================

[](#mage-os-admin-activity-log)

[![Latest Stable Version](https://camo.githubusercontent.com/ea964209aec0be725f42070ef7d47a7ea3ba51632ea6b6ef61e6f6c7e30527ba/68747470733a2f2f706f7365722e707567782e6f72672f6d6167652d6f732f6d6f64756c652d61646d696e2d61637469766974792d6c6f672f762f737461626c65)](https://packagist.org/packages/mage-os/module-admin-activity-log)[![License](https://camo.githubusercontent.com/d3b5ed2c90fa9dc40a15ebe346135edafad42f1671672d878d7f0c1efc130b02/68747470733a2f2f706f7365722e707567782e6f72672f6d6167652d6f732f6d6f64756c652d61646d696e2d61637469766974792d6c6f672f6c6963656e7365)](https://packagist.org/packages/mage-os/module-admin-activity-log)[![Total Downloads](https://camo.githubusercontent.com/7294be01d671761639554ed9306512aa7da323cfb9770170876601743582e93f/68747470733a2f2f706f7365722e707567782e6f72672f6d6167652d6f732f6d6f64756c652d61646d696e2d61637469766974792d6c6f672f646f776e6c6f616473)](https://packagist.org/packages/mage-os/module-admin-activity-log)

A comprehensive admin activity logging extension for Mage-OS and Magento 2 that provides complete audit trails for administrative actions, login attempts, and page visits.

Huge thanks to KiwiCommerce for publishing this extension, and for their support and contributions. This extension is a fork of the original [Magento Admin Activity Log](https://github.com/kiwicommerce/magento2-admin-activity) by KiwiCommerce.

✨ Key Features
--------------

[](#-key-features)

- **Admin Action Logging**: Track all admin activities including add, edit, delete, print, view, and mass update operations
- **Login Monitoring**: Record successful and failed login attempts with detailed information
- **Field-Level Changes**: Track specific field modifications with before/after values
- **IP Address Logging**: Capture IP addresses and user agent information for security analysis
- **Extensible Configuration**: Customize tracked entities and skip fields via XML configuration

📋 Requirements
--------------

[](#-requirements)

ComponentVersion**Magento Open Source**2.4.x**Mage-OS**1.0+**PHP**8.1+🚀 Installation
--------------

[](#-installation)

```
composer require mage-os/module-admin-activity-log
php bin/magento setup:upgrade
```

⚙️ Configuration
----------------

[](#️-configuration)

### Basic Configuration

[](#basic-configuration)

Navigate to **Stores → Configuration → Advanced → Admin → Admin Activity**

#### General Settings

[](#general-settings)

- **Enable Admin Activity Logs**: Enable/disable the extension
- **Record Login Activity**: Track login and logout activities
- **Record Page Visits**: Monitor admin page navigation
- **Clear Admin Activity Logs After**: Set how many days to keep logs (default: 90 days)

📖 Usage Guide
-------------

[](#-usage-guide)

### Viewing Activity Logs

[](#viewing-activity-logs)

Navigate to **System → Admin Activity → Admin Activity Logs**

Click View on any log entry to see detailed info.

### Login Activity Monitoring

[](#login-activity-monitoring)

Go to **System → Admin Activity → Admin Login Logs**

Architecture
------------

[](#architecture)

The module is built around interface-driven services for clean extensibility:

InterfaceDescription`ActivityConfigInterface`Configuration settings (enabled state, log retention)`FieldTrackerInterface`Tracks field-level changes with before/after values`ModelResolverInterface`Resolves and loads models for activity logging`ActivityRepositoryInterface`CRUD operations for activity log entries`LoginRepositoryInterface`CRUD operations for login log entriesAll interfaces are marked `@api` and can be customized via DI preferences.

Extensibility
-------------

[](#extensibility)

### Customizing Tracked Entities

[](#customizing-tracked-entities)

The module uses `adminactivity.xml` to define which entities are tracked and which fields are skipped during logging. Third-party modules can extend this configuration by creating their own `etc/adminactivity.xml` file.

Example configuration to add a custom entity:

```

            Customer Group

                    customer_group_id
                    check_if_is_new

```

### Skip Fields

[](#skip-fields)

To exclude specific fields from being logged (e.g., timestamps, internal IDs), add them to the `skip_fields` node for the relevant module in your `adminactivity.xml`.

### Protected Fields

[](#protected-fields)

Sensitive fields (passwords, tokens, payment data) are automatically excluded from logging. To add custom protected fields:

```

            my_secret_field

```

Security
--------

[](#security)

- **Model Allowlist**: Only explicitly allowed model classes can be loaded during activity logging, preventing arbitrary class instantiation.
- **Protected Fields**: Sensitive data (passwords, API keys, tokens, payment info) is never logged, configured via DI.
- **ACL Permissions**: Control access to activity logs via permission rules.
- **CSRF Protection**: All admin actions are protected with form keys.

Performance Notes
-----------------

[](#performance-notes)

- **Page Visit Logging**: Disabled by default. Enable only if needed, as it creates a log entry for every admin page view.
- **Database Indexes**: The module includes indexes on frequently queried columns for optimal filtering performance.
- **Bulk Operations**: Log cleanup and activity logging use bulk database operations to minimize overhead.
- **Field Truncation**: Large values are truncated at ~64KB to prevent database bloat.

Contributing
------------

[](#contributing)

Issues and pull requests welcome on GitHub.

License
-------

[](#license)

This module is licensed under the [Open Software License 3.0](https://opensource.org/licenses/OSL-3.0).

Support
-------

[](#support)

For bugs or feature requests, please open an issue in the GitHub repository.

###  Health Score

53

—

FairBetter than 96% of packages

Maintenance82

Actively maintained with recent releases

Popularity40

Moderate usage in the ecosystem

Community23

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 70.1% 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 ~11 days

Total

13

Last Release

91d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f46100c19b4689a8076cb2a4e9e6e2ddc378211d64bad5290ccb21abd85b6a0a?d=identicon)[Mage-OS](/maintainers/Mage-OS)

---

Top Contributors

[![rhoerr](https://avatars.githubusercontent.com/u/13335952?v=4)](https://github.com/rhoerr "rhoerr (101 commits)")[![kiwi-commerce](https://avatars.githubusercontent.com/u/40483343?v=4)](https://github.com/kiwi-commerce "kiwi-commerce (26 commits)")[![lucafuser](https://avatars.githubusercontent.com/u/46565169?v=4)](https://github.com/lucafuser "lucafuser (4 commits)")[![peterjaap](https://avatars.githubusercontent.com/u/431360?v=4)](https://github.com/peterjaap "peterjaap (2 commits)")[![mage-os-ci](https://avatars.githubusercontent.com/u/100189073?v=4)](https://github.com/mage-os-ci "mage-os-ci (2 commits)")[![marcelmtz](https://avatars.githubusercontent.com/u/86251132?v=4)](https://github.com/marcelmtz "marcelmtz (2 commits)")[![avstudnitz](https://avatars.githubusercontent.com/u/662059?v=4)](https://github.com/avstudnitz "avstudnitz (1 commits)")[![XigenDominic](https://avatars.githubusercontent.com/u/6814203?v=4)](https://github.com/XigenDominic "XigenDominic (1 commits)")[![kiwihk](https://avatars.githubusercontent.com/u/47317662?v=4)](https://github.com/kiwihk "kiwihk (1 commits)")[![magefan](https://avatars.githubusercontent.com/u/9151916?v=4)](https://github.com/magefan "magefan (1 commits)")[![marvincaspar](https://avatars.githubusercontent.com/u/2600346?v=4)](https://github.com/marvincaspar "marvincaspar (1 commits)")[![pabman11](https://avatars.githubusercontent.com/u/15101708?v=4)](https://github.com/pabman11 "pabman11 (1 commits)")[![sprankhub](https://avatars.githubusercontent.com/u/930199?v=4)](https://github.com/sprankhub "sprankhub (1 commits)")

---

Tags

adminadobecommerceecommerceextensionloggingmage-osmage-os-labmagentomagento2logactivitybackendadminmagento2magento 2

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mage-os-module-admin-activity-log/health.svg)

```
[![Health](https://phpackages.com/badges/mage-os-module-admin-activity-log/health.svg)](https://phpackages.com/packages/mage-os-module-admin-activity-log)
```

###  Alternatives

[mollie/magento2

Mollie Payment Module for Magento 2

1142.0M17](/packages/mollie-magento2)[buckaroo/magento2

Buckaroo Magento 2 extension

32426.0k8](/packages/buckaroo-magento2)[dotdigital/dotdigital-magento2-extension

Dotdigital for Magento 2

50406.2k23](/packages/dotdigital-dotdigital-magento2-extension)[opengento/module-category-import-export

This module add the capability to import and export the categories from the back-office.

1312.0k3](/packages/opengento-module-category-import-export)[loki/magento2-components

Core module for defining Alpine.js components with advanced AJAX features

1015.1k29](/packages/loki-magento2-components)[itonomy/module-admin-activity

A continuation of The Admin Activity extension by KiwiCommerce. This extension makes it easy to track all admin activity and revert the modification.

1273.4k](/packages/itonomy-module-admin-activity)

PHPackages © 2026

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