piwik-pro-log-analytics 5.2.1

Allows importing common web server log formats (nginx, apache, iss and more) directly to Piwik PRO. It's Free Software available under GPLv3 license, available on GitHub

Piwik PRO Server Log Analytics

Import your web server logs to Piwik PRO.

Requirements

• Python 3.6+.
• Piwik PRO >= 16+, all the versions, including Cloud, Core and On-Premises are supported

Getting started

1. Download this git repository git clone [e-mail]:PiwikPRO/log-analytics.git. The script uses only python standard library, so no external packages are required. Alternatively you can download our PyPi package - pip install piwik-pro-log-analytics.
2. Generate Client ID and Client Secret for communication with Piwik PRO API - docs on how to do this can be found on developers.piwik.pro
3. You are now ready to import your web server's access logs into Piwik PRO:

• piwik_pro_log_analytics/import_logs.py --client-id <client-id> --client-secret <client-secret> --url=<my-organization>.piwik.pro /path/to/access.log
• If you installed log analytics via pip, instead of piwik_pro_log_analytics/import_logs.py use piwik_pro_log_analytics
• If the code fails, saying, that your log format doesn't contain hostname - you must decide what App you'd like to track to. You can find App ID in Piwik PRO UI> Administration> Sites & apps>. After that, use --idsite <app-id> flag to tell the importer which App you'd like to track to.

More usage instructions

More usage instructions can be found on developers.piwik.pro

License

Log-analytics is released under the GPLv3 or later. Please refer to LEGALNOTICE for copyright and trademark statements and LICENSE.txt for the full text of the GPLv3.