ackee-report
Advanced tools
CLI tool to generate performance reports of websites using the self-hosted analytics tool Ackee.
CLI tool to generate performance reports of websites using the self-hosted analytics tool Ackee.
ackee-report lets you create monthly website performance reports using your Ackee analytics data and deliver them to multiple recipients via email. It uses Ackee's Graphql API and can be configured to send multiple reports for different websites and recipients.
Install ackee-report globally via npm:
npm install ackee-report -g
On the first run ackee-report will ask you to input a few values:
The configuration will be stored in your home directory under ~/.config/configstore/ackee-report.json and can be changed at any point.
If you want to send your report via email, you have to specify your email providers SMTP server and credentials, aswell as the from option:
smtp.example.com465username@example.compasswordusername@example.com or Ackee <username@example.com>Common providers:
If you use gmail to send emails, use these values:
smtp.gmail.com465If you use SendGrid to send emails, use these values:
smtp.sendgrid.net465apikey (everyone's username is apiKey)If you use SendGrid to send emails, use these values:
smtp.mailgun.org465postmaster@yourdomain.nameUsage: ackee-report generate [options]
Generates report and sends it via specified service
Options:
-d, --domain <titles...> specify domains by title
-i, --id <ids...> specify domains by id
-t, --to <recipient...> to whom the report should be sent (when using email)
-o, --output <file> path to output file (when using json)
-s, --service <name> service to use (default: "email")
-h, --help display help for command
If you want to send the report periodically, you have to setup a cron job which runs the command at a set interval (example below).
ackee-report generate -d example.com -t hello@example.com
This will generate a report for the domain example.com and send it via email to hello@example.com.
ackee-report generate -d example.com example2.com -t hello@example.com hey@example2.com
To send a report periodically, for example every month setup a cron job like this:
0 0 1 * * ackee-report generate -d example.com -t hello@example.com >> /tmp/ackee-report.log 2>&1
If you are not familiar with cron, here's a tutorial on how to get started.
Note: You may have to specify the actual path to ackee-report. In that case, replace ackee-report in the command above with the output of which ackee-report.
To send multiple reports to different people, add them all as seperate cron jobs.
You can also save the report in a JSON file instead of sending it via email:
ackee-report generate -s json -d example.com -o report.json
Here is what's currently planned for ackee-report:
Issues and PRs are very welcome!
Run yarn lint or npm run lint to use eslint.
Please check out the contributing guide before you start.
This project adheres to Semantic Versioning. To see differences with previous versions refer to the CHANGELOG.
This library is an extension to the awesome privacy focused analytics tool Ackee.
Ackee was developed by @electerious, if you want to support him and the development of Ackee visit the Donate section on the Ackee repository.
Copyright 2020 Maximilian Schiller
This project is licensed under the MIT License - see the LICENSE file for details.
[v0.3.1] - 2020-10-28
FAQs
CLI tool to generate performance reports of websites using the self-hosted analytics tool Ackee.
The npm package ackee-report receives a total of 1 weekly downloads. As such, ackee-report popularity was classified as not popular.
We found that ackee-report demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Ransomware negotiators share how modern cybercriminals operate like corporations, using specialized teams, negotiation tactics, and reputation management.
Security News
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.