PHPackages devskio/typo3\_ohdear\_health\_check - 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. [Utility & Helpers](/categories/utility) 4. / 5. devskio/typo3\_ohdear\_health\_check ActiveTypo3-cms-extension[Utility & Helpers](/categories/utility) devskio/typo3\_ohdear\_health\_check ==================================== Oh Dear Health Check extension for TYPO3 13.4.2(6mo ago)012.9k↓47.6%[2 issues](https://github.com/devskio/TYPO3-OhDear-Health-Check/issues)GPL-2.0-or-laterPHP Since Jul 13Pushed 3w ago2 watchersCompare [ Source](https://github.com/devskio/TYPO3-OhDear-Health-Check)[ Packagist](https://packagist.org/packages/devskio/typo3_ohdear_health_check)[ RSS](/packages/devskio-typo3-ohdear-health-check/feed)WikiDiscussions main Synced 2d ago READMEChangelog (5)Dependencies (4)Versions (59)Used By (0) TYPO3 OhDear Health Check Extension =================================== [](#typo3-ohdear-health-check-extension) The TYPO3 OhDear Health Check Extension allows you to monitor the health and performance of your TYPO3 application and server using Oh Dear. With this extension, you can receive alerts and notifications for critical issues, ensuring the smooth operation of your TYPO3 application. Features -------- [](#features) - Disk Space: Monitors the disk space usage of your server. - PHP Error Log Size: Checks the size of the PHP error log. - TYPO3 Error Log Size: Checks the size of the TYPO3 error log. - MySQL Database Size: Checks the size of the MySQL database. - Forgotten Files on the Server: Scans the document root for forgotten files. - TYPO3 Database Log: Retrieves the TYPO3 database log. - TYPO3 Version: Retrieves the installed TYPO3 version. Requirements ------------ [](#requirements) - TYPO3 version 11.5.0 or later. - An active Oh Dear account with the necessary API credentials. Installation ------------ [](#installation) 1. Run the following command to require the OhDear Health Check Extension via Composer: `composer require devskio/typo3_ohdear_health_check` 2. Compare and update the database table and field definitions 3. Include the static TypoScript of the extension. `EXT:typo3_ohdear_health_check/Configuration/TypoScript/setup.typoscript` 4. Once installed, go to the extension configuration settings and provide your Oh Dear API credentials together with Health Report Secret. Optionally, you can enable or disable the monitoring of specific checks together with setting the alert thresholds. 5. \[Optional\] If you want to have nice Health Report URL, you can add a routeEnhancer for OhDear Health Check Extension in your site configuration yaml file. ``` ... routeEnhancers: PageTypeSuffix: map: healthcheck: 1689678601 ... ``` Usage ----- [](#usage) 1. After installing and configuring the extension, you can access the OhDear Health Check dashboard. 2. In Application Health you have to set the URL of the health check endpoint. The URL is `https://yourdomain.com/?type=1689678601`. In case you have added the routeEnhancer, you can use `https://yourdomain.com/healthcheck`. 3. The dashboard displays the current status of various monitored aspects, such as disk space, PHP Error Log Size, TYPO3 Error Log Size, MySQL Database Size, Forgotten Files on the Server, TYPO3 Database Log, TYPO3 Version. 4. Configure the desired alert thresholds and notification settings in OhDear. 5. When an issue is detected, you will receive alerts through your preferred communication channels (e.g., email, Slack, SMS) based on your Oh Dear configuration. Widget ------ [](#widget) You can add the OhDear Health Check widget to your TYPO3 dashboard. Widget is using the OhDear API to fetch basic Oh Dear checks and custom Application health checks. In order to use the widget, you need to provide the Oh Dear API Key and Oh Dear Site ID in the extension configuration settings. [![TYPO3 OhDear Health Check Widget](https://github.com/devskio/TYPO3-OhDear-Health-Check/raw/main/widget-add.png?raw=true)](https://github.com/devskio/TYPO3-OhDear-Health-Check/blob/main/widget-add.png?raw=true) [![TYPO3 OhDear Health Check Widget](https://github.com/devskio/TYPO3-OhDear-Health-Check/raw/main/widget.png?raw=true)](https://github.com/devskio/TYPO3-OhDear-Health-Check/blob/main/widget.png?raw=true) Customization ------------- [](#customization) ### Adding Custom Checks [](#adding-custom-checks) You can add custom checks by extending the `AbstractCheck` and registering your custom check(s) in the `ext_localconf.php` file. ``` $GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['typo3_ohdear_health_check']['checks'][] = \Vendor\MyExtension\HealthCheck\CustomCheck::class; ``` ### Customizing Check Results Array [](#customizing-check-results-array) You can customize the result array of all checks by listening to the `HealthCheckAfterRunEvent` event. ``` # EXT:my_extension/Configuration/Services.yaml services: # ... MyVendor\MyExtension\EventListener\HealthCheckAfterRunEventListener: tags: - name: event.listener method: handleEvent identifier: 'myHealthCheckAfterRunEventListener' event: Devskio\Typo3OhDearHealthCheck\Events\HealthCheckAfterRunEvent ``` Contributing ------------ [](#contributing) Contributions to the TYPO3 OhDear Health Check Extension are welcome! If you encounter any bugs, have suggestions, or want to contribute new features, please submit a pull request or open an issue in the GitHub repository. License ------- [](#license) This TYPO3 OhDear Health Check Extension is released under the [MIT License](LICENSE). ### Health Score 47 — FairBetter than 93% of packages Maintenance82 Actively maintained with recent releases Popularity25 Limited adoption so far Community13 Small or concentrated contributor base Maturity58 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 ~15 days Total 57 Last Release 207d ago Major Versions 11.4.2 → 12.1.42024-07-19 11.4.5 → 12.4.02024-08-14 11.4.6 → 12.4.12024-09-05 11.4.x-dev → 13.4.12025-10-08 12.4.x-dev → 13.4.x-dev2025-12-02 ### Community Maintainers ![](https://www.gravatar.com/avatar/1ed8b219e562bd124e9fdd3693d2272f404f8ff1bc448cf67cccb1c4c4a9c2f1?d=identicon)[devskio](/maintainers/devskio) --- Top Contributors [![DevskDenysYefimenko](https://avatars.githubusercontent.com/u/160607691?v=4)](https://github.com/DevskDenysYefimenko "DevskDenysYefimenko (47 commits)")[![devsk-io](https://avatars.githubusercontent.com/u/104497805?v=4)](https://github.com/devsk-io "devsk-io (34 commits)")[![miroslavborecky](https://avatars.githubusercontent.com/u/142002780?v=4)](https://github.com/miroslavborecky "miroslavborecky (14 commits)")[![michalpodrouzek](https://avatars.githubusercontent.com/u/172371092?v=4)](https://github.com/michalpodrouzek "michalpodrouzek (3 commits)")[![devskio](https://avatars.githubusercontent.com/u/138782632?v=4)](https://github.com/devskio "devskio (1 commits)") --- Tags TYPO3 CMS ### Embed Badge ![Health badge](/badges/devskio-typo3-ohdear-health-check/health.svg) ``` [![Health](https://phpackages.com/badges/devskio-typo3-ohdear-health-check/health.svg)](https://phpackages.com/packages/devskio-typo3-ohdear-health-check) ``` ### Alternatives [yoast-seo-for-typo3/yoast_seo Yoast SEO for TYPO3 511.7M9](/packages/yoast-seo-for-typo3-yoast-seo)[typo3/cms-install TYPO3 CMS Install Tool - The Install Tool is used for installation, upgrade, system administration and setup tasks. 1812.3M495](/packages/typo3-cms-install)[friendsoftypo3/content-blocks TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML 103519.9k53](/packages/friendsoftypo3-content-blocks)[netresearch/rte-ckeditor-image Image support in CKEditor for the TYPO3 ecosystem - by Netresearch 611.1M8](/packages/netresearch-rte-ckeditor-image)[web-vision/wv_deepltranslate DeepL Translate (CORE) - This extension provides option to translate content element, and TCA record texts to DeepL supported languages. 33304.3k](/packages/web-vision-wv-deepltranslate)[derhansen/sf_event_mgt Event management and registration - Configurable event management and registration extension based on ExtBase and Fluid 66338.4k10](/packages/derhansen-sf-event-mgt) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)