PHPackages                             otternq/dtail - 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 &amp; Monitoring](/categories/logging)
4. /
5. otternq/dtail

ActiveLibrary[Logging &amp; Monitoring](/categories/logging)

otternq/dtail
=============

Prints PHP Errors that have been logged to DynamoDB

0.2(12y ago)06MITPHPPHP &gt;=5.3.3

Since Nov 15Pushed 12y ago1 watchersCompare

[ Source](https://github.com/otternq/DTail)[ Packagist](https://packagist.org/packages/otternq/dtail)[ Docs](https://github.com/otternq/DTail)[ RSS](/packages/otternq-dtail/feed)WikiDiscussions master Synced yesterday

READMEChangelog (2)Dependencies (3)Versions (4)Used By (0)

DTail
=====

[](#dtail)

Watch and search Logs entries stored in a DynamoDB table

[![Total Downloads](https://camo.githubusercontent.com/8c2e65018b5ad9de9088825b1adbaa52a3be5eac155db88986346a955f6b42ca/68747470733a2f2f706f7365722e707567782e6f72672f6f747465726e712f445461696c2f646f776e6c6f6164732e706e67)](https://packagist.org/packages/otternq/DTail)[![Latest Stable Version](https://camo.githubusercontent.com/4ba9ee1312215ffd24f609a7a9a1821332d9272153c06ec2ab9e08589b0a2f94/68747470733a2f2f706f7365722e707567782e6f72672f6f747465726e712f445461696c2f762f737461626c652e706e67)](https://packagist.org/packages/otternq/DTail)[![Dependency Status](https://camo.githubusercontent.com/b6d6247ad5d7c34bcaaf01e01fb0f922cd2092a7b6bb7e570b4b7c82418478c4/68747470733a2f2f7777772e76657273696f6e6579652e636f6d2f7061636b6167652f6f747465726e712d2d647461696c2f62616467652e706e67)](https://www.versioneye.com/package/otternq--dtail)

MasterDevelopment[![Build Status](https://camo.githubusercontent.com/8c2b64b8dd8525ee64f6ba9a20fe47537dac6e2b2691160486a5a1a0f70c6af1/68747470733a2f2f7472617669732d63692e6f72672f6f747465726e712f445461696c2e706e673f6272616e63683d6d6173746572)](https://travis-ci.org/otternq/DTail)[![Build Status](https://camo.githubusercontent.com/af2df4223b44b751fdc107099b203b809e052971c616c3d91346ac76795ac33c/68747470733a2f2f7472617669732d63692e6f72672f6f747465726e712f445461696c2e706e673f6272616e63683d646576656c6f706d656e74)](https://travis-ci.org/otternq/DTail)[![Coverage Status](https://camo.githubusercontent.com/21c0c48ad3bb8216a67045ccc3476f9446269b0c50dc9d1a183100d9bf7ffd3f/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6f747465726e712f445461696c2f62616467652e706e673f6272616e63683d6d6173746572)](https://coveralls.io/r/otternq/DTail?branch=master)[![Coverage Status](https://camo.githubusercontent.com/58f9a465f6cb03d8e4a5b5ed4d21e2ce33f31f042bb4c02fc26823849d7781c0/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6f747465726e712f445461696c2f62616467652e706e673f6272616e63683d646576656c6f706d656e74)](https://coveralls.io/r/otternq/DTail?branch=development)Installing
----------

[](#installing)

DTail is available on [Packagist](https://packagist.org/packages/otternq/dtail).

To install with composer, add: `"otternq/dtail": "dev-master"` to *composer.json* in the **require** section:

```
"require": {
    "php": ">=5.3.3",
    "otternq/dtail": "dev-master"
}
```

then run `php composer.phar update` (or `php composer.phar install` depending on the situation) and let composer do the rest.

Usage
-----

[](#usage)

If you want to incoorperate this into another system, see **Usage 1**. If you just want to see the log entries, see **Usage 2**

\###Usage 1

```
include "vendor/autoload.php";

use Colors\Color;

use Aws\Common\Aws;
use Aws\DynamoDb\DynamoDbClient;

use DTail\DTail;

$config = array(
    'dyn-table' => 'PHPErrors',
    'dyn-key'    => YOUR_AWS_KEY,
    'dyn-secret' => YOUR_AWS_SECRET,
    'dyn-region' => 'us-east-1'
);

$dynamodbClient = DynamoDbClient::factory(array(
    'key'    => $config['dyn-key'],
    'secret' => $config['dyn-secret'],
    'region' => $config['dyn-region'],
    )
);

$dtail = new DTail($dynamodbClient);

$iterator = $dtail->get(
    $config['dyn-table'],
    'PHPErrorReporter'
);

foreach($iterator as $item) {
    var_dump($item);
}
```

\###Usage 2

If you just want to watch/search log files then use the `bin/dtail` command:

```
bin/dtail -f /path/to/config/file.php
```

the config file will look like:

```
return array(
    'dyn-table' => 'PHPErrors',
    'dyn-key'    => YOUR_AWS_KEY,
    'dyn-secret' => YOUR_AWS_SECRET,
    'dyn-region' => 'us-east-1'
);
```

and the output will look like:

```
Channel           Date Time   Level      Message                                                      Context
PHPErrorReporter  2013-11-14  WARNING    Test                                                         []
PHPErrorReporter  2013-11-14  WARNING    E_WARNING: Division by zero                                  {"file":"/path/to/DTail/app.php","line":26}
PHPErrorReporter  2013-11-14  NOTICE     E_NOTICE: Undefined variable: foo                            {"file":"/path/to/DTail/error.php","line":27}
PHPErrorReporter  2013-11-14  WARNING    E_WARNING: Division by zero                                  {"file":"/path/to/DTail/error.php","line":28}
PHPErrorReporter  2013-11-14  NOTICE     E_NOTICE: Use of undefined constant T - assumed 'T'          {"file":"/path/to/DTail/error.php","line":29}
PHPErrorReporter  2013-11-14  ERROR      Uncaught exception                                           {"exception":{"class":"Exception","message":"$arr has no element with index: dyn->key","file":"/path/to/DTail/Utils/Arr.php:26","trace":["/path/to/DTail/bin/app.php:36"]}}

```

DynamoDB
--------

[](#dynamodb)

This tool was written to read log messages stored by [monolog](https://github.com/Seldaek/monolog/) using the [DynamoDB handler](https://github.com/Seldaek/monolog/blob/master/src/Monolog/Handler/DynamoDbHandler.php) and the DynamoDB structure is displayed on [Issue 259](https://github.com/Seldaek/monolog/issues/259).

###  Health Score

22

—

LowBetter than 21% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity50

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 ~0 days

Total

2

Last Release

4611d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1403880?v=4)[Nick Otter](/maintainers/otternq)[@otternq](https://github.com/otternq)

---

Top Contributors

[![otternq](https://avatars.githubusercontent.com/u/1403880?v=4)](https://github.com/otternq "otternq (35 commits)")

---

Tags

dynamodblogs

### Embed Badge

![Health badge](/badges/otternq-dtail/health.svg)

```
[![Health](https://phpackages.com/badges/otternq-dtail/health.svg)](https://phpackages.com/packages/otternq-dtail)
```

###  Alternatives

[symfony/monolog-bridge

Provides integration for Monolog with various Symfony components

2.6k203.7M335](/packages/symfony-monolog-bridge)[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.6k38.2k](/packages/matomo-matomo)[maxbanton/cwh

AWS CloudWatch Handler for Monolog library

42515.7M34](/packages/maxbanton-cwh)[illuminate/log

The Illuminate Log package.

6225.0M606](/packages/illuminate-log)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

45344.0k1](/packages/pressbooks-pressbooks)[open-telemetry/opentelemetry-logger-monolog

OpenTelemetry Monolog handler.

102.2M18](/packages/open-telemetry-opentelemetry-logger-monolog)

PHPackages © 2026

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