PHPackages os2web/os2web\_audit - 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. os2web/os2web\_audit ActiveDrupal-module[Logging & Monitoring](/categories/logging) os2web/os2web\_audit ==================== Drupal OS2 module that provides audit logging for Danish Municipalities 1.2.0(10mo ago)010.8k↓48.5%24EUPL-1.2PHPPHP ^8.1 Since Aug 20Pushed 6mo ago2 watchersCompare [ Source](https://github.com/OS2web/os2web_audit)[ Packagist](https://packagist.org/packages/os2web/os2web_audit)[ RSS](/packages/os2web-os2web-audit/feed)WikiDiscussions develop Synced 1mo ago READMEChangelog (10)Dependencies (8)Versions (19)Used By (4) OS2Web Audit ============ [](#os2web-audit) This audit module can be used to track changes and perform audit logging on drupal sites. Features -------- [](#features) This module includes three plugins that facilitate logging information to Loki, files, or to the database through Drupal's watchdog logger. These logging providers are designed using Drupal's plugin APIs. Consequently, it opens up possibilities for creating new AuditLogger plugins within other modules, thus enhancing the functionality of this audit logging. For performance purposes we use a queue system. This avoids hindering performance more than necessary as the actual logging is done async. Furthermore, this allows for retries in case any audit log plugins should fail. Installation ------------ [](#installation) Enable the module and go to the modules setting page at `/admin/config/os2web_audit/settings/`. ``` composer require os2web/os2web_audit drush pm:enable os2web_audit ``` Drush ----- [](#drush) ### Test audit log [](#test-audit-log) The module provides a Drush command named audit:log. This command enables you to log a test message to the configured logger. The audit:log command accepts a string that represents the message to be logged. The message provided, will be logged twice, once as an informational message and once as an error message. ``` drush audit:log 'This is a test message' ``` ### Retry jobs [](#retry-jobs) The module also comes with methods for retrying failed jobs in the `os2web_audit` queue. ``` drush audit:retry-failed-jobs ``` Per default, it simply retries all failed jobs however it comes with the following options: ``` --id[=ID] Retry a specific job by ID (e.g. 1245.) --ignore-state Retry job regardless of state. This only effects the --id option. --limit[=LIMIT] Retry (up to) a limited number of jobs. Minimum: 1, Maximum: 5000, Default 1000. ``` Usage ----- [](#usage) The module exposes a simple `Logger` service which can log an `info` and `error`messages. Inject the logger service named `os2web_audit.logger` and send messages into the logger as shown below: ``` $msg = sprintf('Fetch personal data from service with parameter: %s', $param); $this->auditLogger->info('Lookup', $msg); ``` ### Implementations [](#implementations) See [implementations](/docs/IMPLEMENTATIONS.md) for a list of modules that have audit logging integrated. Queue ----- [](#queue) The actual logging is handled by jobs in an [Advanced Queue](https://www.drupal.org/project/advancedqueue) queue. The queue, OS2Web audit (`os2web_audit`), must be processed by a server `cron` job, e.g. ``` drush advancedqueue:queue:process os2web_audit ``` List the queue (and all other queues) with ``` drush advancedqueue:queue:list ``` or go to `/admin/config/system/queues/jobs/os2web_audit` for a graphical overview of jobs in the queue. ### Purge successful jobs [](#purge-successful-jobs) It is possible to configure the queue to purge jobs based on the number of jobs or the number of days since processing. Go to `admin/config/system/queues/manage/os2web_audit` to configure this. Below is an example of purging successful jobs after 7 days. [![queue purge config](/docs/queue_purge_config.png)](/docs/queue_purge_config.png) Remember to export this to ensure it is not overridden upon config import. Coding standards ---------------- [](#coding-standards) ### PHP files (PHP\_CodeSniffer) [](#php-files-php_codesniffer) Check PHP coding standards ``` docker run --interactive --rm --volume ${PWD}:/app itkdev/php8.3-fpm:latest composer install docker run --interactive --rm --volume ${PWD}:/app itkdev/php8.3-fpm:latest composer coding-standards-check ``` Apply coding standard changes ``` docker run --interactive --rm --volume ${PWD}:/app itkdev/php8.3-fpm:latest composer install docker run --interactive --rm --volume ${PWD}:/app itkdev/php8.3-fpm:latest composer coding-standards-apply ``` Code analysis ------------- [](#code-analysis) phpstan is used to perform static analysis of the code. Run the following script: ``` ./scripts/code-analysis ``` ### Markdown files [](#markdown-files) ``` docker run --interactive --rm --volume "$PWD:/md" itkdev/markdownlint markdownlint '**/*.md' --fix docker run --interactive --rm --volume "$PWD:/md" itkdev/markdownlint markdownlint '**/*.md' ``` ### Health Score 43 — FairBetter than 91% of packages Maintenance61 Regular maintenance activity Popularity26 Limited adoption so far Community22 Small or concentrated contributor base Maturity57 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits 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 ~19 days Recently: every ~31 days Total 17 Last Release 319d ago Major Versions 0.2.2 → 1.0.02025-02-28 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/33924554?v=4)[ITK Development](/maintainers/itk-dev)[@itk-dev](https://github.com/itk-dev) ![](https://avatars.githubusercontent.com/u/827308?v=4)[Jørn Skifter Andersen](/maintainers/skifter)[@skifter](https://github.com/skifter) --- Top Contributors [![cableman](https://avatars.githubusercontent.com/u/111397?v=4)](https://github.com/cableman "cableman (49 commits)")[![jekuaitk](https://avatars.githubusercontent.com/u/78410897?v=4)](https://github.com/jekuaitk "jekuaitk (49 commits)")[![martinyde](https://avatars.githubusercontent.com/u/545272?v=4)](https://github.com/martinyde "martinyde (10 commits)")[![sinejespersen](https://avatars.githubusercontent.com/u/15377965?v=4)](https://github.com/sinejespersen "sinejespersen (7 commits)")[![rimi-itk](https://avatars.githubusercontent.com/u/11267554?v=4)](https://github.com/rimi-itk "rimi-itk (1 commits)")[![stankut](https://avatars.githubusercontent.com/u/1537807?v=4)](https://github.com/stankut "stankut (1 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/os2web-os2web-audit/health.svg) ``` [![Health](https://phpackages.com/badges/os2web-os2web-audit/health.svg)](https://phpackages.com/packages/os2web-os2web-audit) ``` ### Alternatives [psr/log Common interface for logging libraries 10.4k1.2B9.2k](/packages/psr-log)[itsgoingd/clockwork php dev tools in your browser 5.9k27.6M94](/packages/itsgoingd-clockwork)[graylog2/gelf-php A php implementation to send log-messages to a GELF compatible backend like Graylog2. 41838.2M138](/packages/graylog2-gelf-php)[bugsnag/bugsnag-psr-logger Official Bugsnag PHP PSR Logger. 32132.5M2](/packages/bugsnag-bugsnag-psr-logger)[consolidation/log Improved Psr-3 / Psr\\Log logger based on Symfony Console components. 15462.2M7](/packages/consolidation-log)[ekino/newrelic-bundle Integrate New Relic into Symfony2 28111.2M8](/packages/ekino-newrelic-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)