{"id":18867734,"url":"https://github.com/apix/log-tracker","last_synced_at":"2026-05-01T18:31:59.913Z","repository":{"id":56949422,"uuid":"70502760","full_name":"apix/log-tracker","owner":"apix","description":"The tracking companion to Apix-Log","archived":false,"fork":false,"pushed_at":"2019-10-31T22:34:42.000Z","size":40,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-30T15:17:33.344Z","etag":null,"topics":["apix","apix-log","composer","dashbot","google-analytics","log-tracker","psr-3"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apix.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-10-10T15:41:13.000Z","updated_at":"2019-10-31T22:34:44.000Z","dependencies_parsed_at":"2022-08-21T08:20:20.136Z","dependency_job_id":null,"html_url":"https://github.com/apix/log-tracker","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/apix/log-tracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apix%2Flog-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apix%2Flog-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apix%2Flog-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apix%2Flog-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apix","download_url":"https://codeload.github.com/apix/log-tracker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apix%2Flog-tracker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32508900,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apix","apix-log","composer","dashbot","google-analytics","log-tracker","psr-3"],"created_at":"2024-11-08T05:10:57.976Z","updated_at":"2026-05-01T18:31:59.891Z","avatar_url":"https://github.com/apix.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Log-Tracker, the tracking companion to [Apix-Log](//github.com/apix/log)\n\n[![Latest Stable Version](https://poser.pugx.org/apix/log-tracker/v/stable.svg)](https://packagist.org/packages/apix/log-tracker)  [![Build Status](https://travis-ci.org/apix/log-tracker.png?branch=master)](https://travis-ci.org/apix/log-tracker)  [![Code Quality](https://scrutinizer-ci.com/g/apix/log-tracker/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/apix/log-tracker/?branch=master)  [![Code Coverage](https://scrutinizer-ci.com/g/apix/log-tracker/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/apix/log-tracker/?branch=master)  [![License](https://poser.pugx.org/apix/log-tracker/license.svg)](https://packagist.org/packages/apix/log-tracker)\n\nAn extension for the [Apix-Log](//github.com/apix/log) PSR-3 logger which adds log tracking to:\n * [GoogleAnalytics](src/GoogleAnalytics.php),\n * [Dashbot](src/Dashbot.php).\n\nFeatures:\n * Send tracking data asynchnonously (non-blocking).\n * Handles batched/deferred mode.\n * 100% Unit tested and compliant with PSR0, PSR1 and PSR2.\n * Continuously integrated against all modern PHP versions (**5.3 all the way through 7.3**, ~~including HHVM~~).\n * Home repo is on [on github](//github.com/apix/log-tracker), and the Composer package is [on packagist](//packagist.org/packages/apix/log-tracker).\n\nFeel free to comment, send pull requests and patches...\n\n## Installation\n\nInstall the latest version via composer:\n\n    $ composer require apix/log-tracker\n\nYou require at least PHP 5.3.\n\n## Basic usage, Google Analytics.\n\n```php\nuse Apix\\Log;\n\n$options = [\n    'tid' =\u003e '\u003cUA-XX-XX\u003e',   // Tracking/Property ID (required). \n    //'cid' =\u003e '\u003cUUID-v4\u003e',  // Anonymous Client ID UUIDv4 (if not provided, auto-generated one).\n    //...                    // Any numbers of Google Analytics Parameters (see notes). \n];\n\n$ga_logger = new GoogleAnalytics($options);\n$ga_logger-\u003esetDeferred(true); // Enable batched mode (recommneded).\n\n$dataToTrack = $ga_logger-\u003egetPage('http://foo.tld/...', 'Welcome page');\n//$dataToTrack = $ga_logger-\u003egetEvent('category', 'action', 'label', 'value');\n//$dataToTrack = $ga_logger-\u003egetSocial('action', 'network', 'target');\n//$dataToTrack = $ga_logger-\u003egetException('description');\n//$dataToTrack = $ga_logger-\u003egetApp('name', 'version', 'id');\n\n$ga_logger-\u003enotice('GA Tracking', $dataToTrack);\n```\n\nNotes:\n * The log level and message are not forwarded to Google Analytics (TBD).\n * If required, you can add some additional [Google Analytics Parameters](https://developers.google.com/analytics/devguides/collection/protocol/v1/parameters) to the `options` array such as `uip` (user IP), `ua` (user agent), etc... If not provided, these will be generated and/or guessed from the current context.\n\n## Basic usage, Dashbot.\n\n```php\nuse Apix\\Log;\n\n$dashbot_logger = new Dashbot('\u003cAPI-Key');\n//$dashbot_logger-\u003esetPlatform('facebook'); // 'generic' (default), 'slack', 'kik'.\n//$dashbot_logger-\u003esetGlobalTag('myTag');   // Useful to combined metrics.\n\n$messages_received = [\"text\" =\u003e \"Hi, bot\", \"userId\" =\u003e \"...\"];\n$dataToTrack = $dashbot_logger-\u003eincoming($messages_received);\n//$dataToTrack = $dashbot_logger-\u003eincoming($messages_received, \"localTag\"); // Override the global tag\n\n$messages_sent = [\"text\" =\u003e \"Hello, user\", \"userId\" =\u003e \"...\"];\n$dataToTrack = $logger-\u003eoutgoing($messages_sent);\n\n$dashbot_logger-\u003einfo('Dashbot Tracking', $dataToTrack);\n```\n\nNotes:\n * The log level and message are not forwarded to Dashbot (TBD).\n * A local tag (which override the main global tag) can be passed to the `incoming` and `outgoing` methods as a second argument.\n\n## Advanced usage.\n\nPlease for now just follow [Apix Log Examples](//github.com/apix/log).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapix%2Flog-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapix%2Flog-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapix%2Flog-tracker/lists"}