This page is also available in English (Anglais)

Diagnostic des problèmes

  1. Piwik doesn't track any visits and pages, and shows "There is no data for this report" in all reports.
  2. Visits from search engines or campaigns are not recorded, Piwik shows "There is no data for this report" for all Referrers reports.
  3. Piwik doesn't track Downloads and Outlinks on my website.
  4. Piwik ne détecte pas précisément la pays et/ou le continent des visiteurs.
  5. Piwik is slow! It takes a long time to load widgets, reports and pages.
  6. Les statistiques de Piwik et de mes autres outils d'analyse Web (log analyzer, webalizer ou javascript based) sont différents, pourquoi ?
  7. After I updated Piwik, it stopped working (blank page, widgets not loading, error message, etc.). How can I fix this?
  8. Les graphiques (camembert, barre, graphique évolution) ne s'affiche pas dans Piwik.
  9. The sparklines (small graphs like ) are not showing in my Piwik.
  10. Piwik reporting UI doesn't have any css style or, the menu text appears on a white background. How to fix this display problem?
  11. When tracking visits on an intranet website, Piwik assigns all page views to a few visitors who have very high page views count. How to fix it?
  12. The World map is not showing in my Piwik.
  13. Le code Javascript Piwik afficher une croix rouge (dans IE) ou une icône d'image cassée à la place du pixel de 1*1 transparent, quel est le problème ?
  14. How do I configure Piwik when mod_security is enabled?
  15. Only one or a small number of days/months/date ranges are showing 0 zero visits, but other periods are working as expected.
  16. How do I delete historical Piwik data? (purge old logs)
  17. I would like to import an existing Users database (login, password, emails) in Piwik, but the usernames and passwords are more permissive than what Piwik allows. How do I disable the checks on the Logins & Passwords?
  18. Piwik doesn't show me when new updates are available, and the SEO plugin doesn't work.
  19. "Segmentation fault Error". Piwik reporting or via cron crashes with Segmentation Fault error. What to do?
  20. J'ai ce message d'erreur: "Fatal error: require_once() [function.require]: Failed opening required XYZ in /path/piwik/XYZ.php on line X". Comment faire fonctionner Piwik ?
  21. Que faire quand j'ai un message d'erreur de type : SQLSTATE[HY000] [2002] Can't connect to local MySQL server through socket '/var/lib/mysql/mysql.sock' (11)
  22. J'obtiens l'erreur "Warning: gzuncompress() [function.gzuncompress]: data error" lorsque je consulte mes rapports piwik.
  23. Emails sent from Piwik use the email address @defaultHostnameIfEmpty.example.org, how do I specify my domain name instead?
  24. Piwik reports this error and fails: "Fatal error: Allowed memory size of X bytes exhausted (tried to allocate X bytes)". What should I do?
  25. Piwik reports this error and doesn't continue: "Fatal error: Maximum execution time of 30 seconds exceeded in ..."
  26. Graphs in PDF/HTML reports and/or Piwik Mobile do not display characters correctly in my language (display squares instead).
  27. When I use http with force_ssl_login=1 or force_ssl=1, I get "Too many redirects". Also when I use https, CSV/PDF reports and graphs don't work.
  28. When included in an IFrame, Piwik reports do not load. How do I allow Piwik reports to load from within an iframe?
  29. I'm a developer, how do I enable logging (and / or SQL profiling) in Piwik?
  30. Widgets don't load. I get the error message: "Fatal error: Class '...' not found in ... What's wrong?

Réponses

  1. Piwik doesn't track any visits and pages, and shows "There is no data for this report" in all reports.

    There are several possible reasons why Piwik is not tracking your visits properly:

    • Incorrect Piwik tracking code
      Please check that you can find the Piwik javascript code on your website pages that you wish to track. Sometimes, when you copy paste the javascript code in other softwares, like Word or FrontPage, they may add extra spaces or characters. Make sure the code looks like this example (and that it mentions the right URL of your Piwik installation).
      In some cases, when you install Piwik on your local test server, the javascript code might contain "localhost" or "127.0.0.1". When you deploy Piwik in production, you have to edit the Javascript code so that it points to your website URL, eg. "http://example.org/piwik/".
      Also, each Piwik tracking code contains the idsite of your website registered in Piwik. If you only registered one website in Piwik, the idsite found in your Javascript code should be "1".
    • Make sure you are viewing reports for the correct website and date in Piwik
      In Piwik, make sure you selected the right website in the website selector. Also, try to look at reports for "today" by changing the date in the date picker. Please wait at least 10 seconds after generating visits on your website: by default Piwik will only process reports every 10 seconds when "today" is selected.
    • Archiving triggered from the browser must be enabled, if it is disabled the Cron script must be configured properly

      In Settings > General Settings, 'Allow Piwik archiving to trigger when reports are viewed from the browser' must be set to 'Yes'. If it is set to 'No', you must configure the cron script to automatically archive your web analytics reports, or Piwik will show 'No Data'. More information about auto archiving.
    • Third party Piwik plugins
      It is possible that some Third party Piwik plugins could cause problems when tracking your visitors. Please try to disable all the third party plugins you are using to see if it fixes the issue.
    • Browser addons blocking the Piwik Tracking Javascript
      If you use browsers addons such as Adblock, Adblock plus, NoScript, Ghostery or others, the Piwik Javascript code is not executed in your browser. Try to use a different browser that does not have these extensions, or disable them and try again.
    • Do you have logs registered in your Piwik database?
      If your Piwik tracking code is properly installed, Piwik would record visits in your database. To check if you have logs in your database, go to Piwik > Visitors > Visitor log, and select "today" in the calendar. If you see recent visitor information, it means that the visitor tracking is working, but maybe there is a problem with reports archiving.
      Note: you can also check if logs are recorded correctly by looking at the table "piwik_log_visit" (using phpMyAdmin for example) and see if there are visits recorded. Alternatively, you can enable the plugin "DBStats", and then go to the "Database usage" tab in your Piwik administration area, and check if the table piwik_log_visit has any rows.
    • Testing Piwik with disabled Javascript
      By default, Piwik only tracks visitors with javascript enabled. When you are testing that Piwik tracks visits properly make sure you have javascript enabled.
      If you need help with javascript tracking check out docs/javascript-tracking.
      If you need to use a tracking method which doesn't involve javascript have a look at docs/tracking-api.
    • Piwik displays a red cross (on IE) or a broken image icon on your tracked pages, instead of the 1*1 transparent Pixel
      Check out this FAQ answer.
    • Access to piwik.php fails
      If your host uses mod_security to block requests containing URLs (eg. hosts like HostGator, The Planet), check out the Piwik and mod_security FAQ.
      If you use HTTP Authentication (Basic or Digest) on your Piwik files, you should exclude piwik.php and piwik.js from this authentication, or visitors on your website would be prompted with the authentication popup.
    • Tracking https (SSL) pages
      If you install the Piwik Javascript Tracking tag on https:// pages, then the tracking requests will be sent to Piwik via https. This means that the server you installed Piwik on must be able to handle these https requests, or no data will be tracked. See also Piwik and SSL tracking.
    • Local copy of piwik.js outdated
      Some users make a local copy of piwik.js on a different server than their Piwik installation. This is not officially supported and causes issues when the piwik.js bundled with Piwik is updated and not compatible with the previous version (for example, this is the case in Piwik 0.5.5). Please check that your Piwik JS tracking code is exactly the one given in the Piwik admin screen.
    • Using Piwik latest version
      If you are still seing "No data", please make sure you are using the latest version of Piwik (if not, update now).
    • Check your webserver error logs
      If all else fails, it is possible that there is a server misconfiguration preventing Piwik from tracking your visits or processing reports. Often, there will be an error in the webserver error logs (apache logs, IIS logs, nginx logs, etc.). Please check that your PHP is configured to log errors: (php.ini should contain log_errors = On and error_log = /path/to/log). The messages in the webserver error log will help you find the source of the problem, for example search for the error message on this website.

  2. Visits from search engines or campaigns are not recorded, Piwik shows "There is no data for this report" for all Referrers reports.

    There are a few possible explanations:

    • Are your pages tagged correctly?
      If you click on your website in a search result, and look at your page source, can you see the Piwik tracking code? Make sure the Piwik tracking code is installed on all the pages you want to track, and is not within an iframe. We advise to put the Piwik code just before the </body> tag.
    • Are you using a redirect on your website landing page?
      If you are using a redirect, the visitor browser may lose the referer information. If you are tracking campaigns, and the landing page has a redirect, the URL loaded after the redirection will have lost the URL parameters. Make sure that your visitors arrive directly on the page with the Piwik tracking code installed.
    • Piwik only records 1 referer by visit, which means that only the first referer used to access the website will be recorded.
      If you search for a keyword in a search engine, click on your website in the search engine results, and land on a page with the Piwik tracker, you may expect to see the keyword in your Piwik reports.
      However, if you visited your website less than 30 minutes ago, Piwik will recognize you as an known visitor on the website, will record your page view, but will not update your visit referer. Piwik only record the first referer of a visit. When testing Piwik and search engine detection, make sure you make the test more than 30 minutes after your last page view on your website.
    • Check that the Piwik domain name in your Javascript tracking code is correct (this URL is in the second line of the Piwik tracking code).
      There have been cases of missing referrers when the Piwik JS code in the pages points to a URL that returns a 302 response instead of the final destination. It seems that some webserver compromise the tracking request when such redirects occur. Check in particular if the URL (doesn't) contains "www.". Also, if the server does an automatic redirection from http to https which also affects tracking requests to piwik.php, it might create problems such as missing referer data. Make such any http->https redirection excludes piwik.php requests.

  3. Piwik doesn't track Downloads and Outlinks on my website.

    Piwik should automatically track clicks on Download files (with a known extension, eg. jpg, png, exe, zip, etc.) and clicks on Outlinks (links to other websites) using Javascript click handlers. There are a few reasons why this could fail:

    • Conflicting Javascript code

      In some rare cases, Download and Outlink tracking doesn't work in Piwik is because your page is using another Javascript script or library which sets click handlers as well. If a third-party click handler returns a value, it is causing the browser to cancel other registered click handlers. Instead they should return false. Most scripts and libraries are doing it correctly, but you might have to manually edit your Javascript code to return false in onclick events.
    • Piwik doesn't respond fast enough and user is redirected to the click target

      Piwik click handler works by adding a small delay during which the request is sent to the Piwik server. If somehow the request doesn't reach the server within this delay, the request will be not be tracked and the user will be redirected to the clicked download file or to the external website. You can increase this delay, from the default of 500ms (0.5 second), by adding the following in the Javascript code, after the piwik.getTracker(..) line: piwikTracker.setLinkTrackingTimer( 750 ); // increase to 750 milliseconds
    • You're using Safari, Chrome, or some other WebKit-based browser.

      There is a known WebKit bug (feature?) that interrupts the tracking request. One workaround is to add the target="_blank" attribute to anchor elements.

  4. Piwik ne détecte pas précisément la pays et/ou le continent des visiteurs.

    Unless you're using the GeoIP plugin, Piwik is guessing your location from the language locale disclosed by the browser, e.g. en-us -> country is set to USA, fr-fr -> country is set to France, etc.
    In some cases, Piwik will guess the location when the region is omitted, e.g., fr -> France. This can be disabled from config/global.ini.php (or overridden in your config.ini.php):
    [Tracker]
    enable_language_to_country_guess = 0

    If you want to improve the country detection accuracy in Piwik, please install the GeoIP plugin.

  5. Piwik is slow! It takes a long time to load widgets, reports and pages.

    There are a few possible reasons that Piwik could be slow to load:

  6. Les statistiques de Piwik et de mes autres outils d'analyse Web (log analyzer, webalizer ou javascript based) sont différents, pourquoi ?

    Il peut y avoir des raisons différents expliquant pourquoi les chiffres de Piwik sont différents des autres solutions d'analyse Web.

    • Méthode de pistage: Piwik utilise un tracker basé sur javascript, et comptabilise les visiteurs uniques avec un cookie de traçage. Les analyseurs de logs (AWStats, Webalizer, Analog, etc.) ou les script personnalisés côté serveur vont enregistrer tous le trafic incluant les bots et utiliserons l'adresse IP et le User Agent pour déterminer un visiteur unique, ce qui est moins précis.
    • Hits vs Visites: Les logiciels d'analyse de logs vont rapporter des "hits". Les hits prennent en compte toutes les requêtes HTTP de votre site Web : pages, images, css, fichiers javascript, etc. Piwik rapporte les pages vues, les visiteurs uniques, les visites, etc. ce qui constitue moins que le nombre de hits.
    • Enregistrer les pages chargées : lorsque vous placez le code Javascript de Piwik à la fin d'une page, Piwik ne tiendra compte que des pages qui sont complètement chargées. Les analyseurs de logs enregistrent aussi les pages dont le chargement a été annulé, exemple : lorsqu'un utilisateur clic sur le bouton Retour avant que la page ne s'affiche.
    • Navigateur du visiteur : Piwik va comptabiliser les visiteurs avec le Javascript et l'affichage des images activés. Les autres logiciels vont enregistrer les visites avec le Javascript désactivé ce qui inclut une activité automatique tel que les bots des moteurs de recherche.
    • Position et présence du tag Javascript : lorsque vous comparez des statistiques basées sur Javascript( ex: le nombre de visiteurs unique), vous devez vous assurer que les deux tags Javascript soient présent sur toutes les pages que vous voulez tracer. Il est préférable de mettre les tags Javascript à la fin de votre page juste avant

    En ce qui concerne Google Analytics, plusieurs utilisateurs ont comparé les chiffres de Piwik et Google Analytics, et ont trouvés des statistiques similaires: sur le trafic, la différence n'excédait pas 5 pourcent.

    La conservation du comptage est définitivement la meilleur solution - elle permet d'avoir des statistiques plus réelle sur ce que vous souhaitez mesurer. La plupart des compilations de données d'analyse sont utilisées pour mesurer les phases de reprise, nous recommandons d'utiliser le même outil pour toutes les mesures et comparaisons.

  7. After I updated Piwik, it stopped working (blank page, widgets not loading, error message, etc.). How can I fix this?

    When you upgrade Piwik to the latest version, it sometimes happen that Piwik stops working -- especially when the User Interface is not working (blank white page, widgets not loading, error message, etc.).
    There are a few things to check that will most likely resolve the User Interface issue you are having:

    • 1) Delete your browser cache or try to access your Piwik with a different browser. If it still does not work...
    • 2) Delete all files in piwik/tmp/*. After deleting the files and directories, refresh the page. If it still does not work...
    • 3) Check your web server error logs. Maybe your error log will contain an explanation for the problem. If the log file has no Piwik related error...
    • 4) Reupload all Piwik files from the latest version. Sometimes, there are errors while uploading files and some of your Piwik files were maybe not overwritten by the latest version. Upload all files again, and check in your FTP software that the upload was successful.

    Also, check out the other FAQs in this "Troubleshooting" category, as there might be other solutions for your problem.
    If it still does not work, please search the Piwik Forums, and if there is no post about your problem, please create a new topic.

  8. Les graphiques (camembert, barre, graphique évolution) ne s'affiche pas dans Piwik.

    If you are not seeing Graphs in Piwik, the most likely reason is that you are using Piwik < 1.5 which are using Flash graphs, and you do not have Flash enabled in your browser.

    As of Piwik 1.5, graphs in Piwik are drawn using open source technologies supported in all modern browsers: see Canvas and Jquery graphs blog post.

  9. The sparklines (small graphs like ) are not showing in my Piwik.

    The GD library is not installed on your server. This library is required to produce the sparklines. Please ask your system administrator or your web host to install php-gd for you.

    On linux, you can install php-gd by executing "apt-get install php-gd" on debian type systems, then restart your webserver.

  10. Piwik reporting UI doesn't have any css style or, the menu text appears on a white background. How to fix this display problem?

    To improve performance, Piwik tries to automatically combine all CSS stylesheets and Javascript files into two large files, instead of having to download 20 individual files. However, on some webhosts, PHP scripts have a max execution time and if the server is overloaded, the script that merges all files together can take more than the time limit.

    There are 2 solutions

    • Ask your webhost to increase the max_execution_time in your php.ini file, for example to 30 seconds.
    • If you can't change this setting, you can alternatively disable the feature to combine together CSS and JS files. To disable this feature, edit your config/config.ini.php and add the following:
      [Debug]
      disable_merged_assets = 1

    Then, delete your browser cache and refresh Piwik: after a few seconds, it should display correctly again!

  11. When tracking visits on an intranet website, Piwik assigns all page views to a few visitors who have very high page views count. How to fix it?

    On Intranet websites, often most users have the same IP address, and often the same browser and configuration settings. This causes Piwik to believe that most page views come from the same visitor. To fix this on Intranet websites, see this FAQ: Enabling Piwik on Intranet websites.

  12. The World map is not showing in my Piwik.

    The Piwik World Map requires the plugin Flash to be displayed. Please check that you have installed Flash in your browser. Click here to install the flash plugin.
    If you have installed the Flash plugin, and the world map is still not showing, maybe you are using a browser extension that blocks the flash content? For example, if you're using the AdBlock extension, there's a notable bug where it blocks Flash content in <object> tags even if the page is whitelisted. Please consider using AdBlock Plus as a replacement.

  13. Le code Javascript Piwik afficher une croix rouge (dans IE) ou une icône d'image cassée à la place du pixel de 1*1 transparent, quel est le problème ?

    Lorsque Piwik afficher une image avec une croix rouge, ou une icône d'image cassé, cela signifie que le pistage des visites ne fonctionne avec votre installation Piwik. Il n'est pas prévu et devrait être étudier de corriger l'origine du problème dès que possible (en attendant vos visites ne sont susceptibles de ne pas être enregistrées).

    Pour voir d'où vient l'erreur, ouvrer votre navigateur Firefox, cliquer avec le bouton droit sur l'icône de l'image cassée et cliquer sur "Voir l'image". Ceci devrait vous rediriger sur l'URL "yourwebsite.com/piwik/piwik.php?..." et le message d'erreur devrait apparaître.

    Si le message d'erreur mentionne MySQL, l'erreur provient d'une erreur de table ou d'instance MySQL. Essayer de 'réparer' vos tables MySQL (en utilisant phpMyAdmin par exemple).
    Si l'erreur mentionne "failed to open stream: No such file or directory" ceci doit provenir d'un fichier manquant dans votre répertoire d'installation Piwik. Assurez-vous que vous les fichiers Piwik sont bien présents.
    Pour d'autre erreurs, essayer de rechercher avec le moteur de recherche sur Piwik.org.
    Vous pouvez aussi essayer le forum de support Piwik pour plus d'aide.

  14. How do I configure Piwik when mod_security is enabled?

    If your host uses mod_security to block requests containing URLs (eg. hosts like HostGator, The Planet), you should contact your provider to whitelist your domain (or URL) and disable mod_security for your website.

    Alternately, if your Piwik is hosted on the same domain as your website being tracked, you can edit your Piwik Javascript Tracking code to force data to be sent in POST, to avoid the mod_security check. Before the line piwikTracker.trackPageView(); you can add the following line piwikTracker.setRequestMethod('POST');

  15. Only one or a small number of days/months/date ranges are showing 0 zero visits, but other periods are working as expected.

    In rare cases, Piwik will show "no data" only for one day or one month, while other periods work fine and report visits as expected.
    If you are not yet using at least Piwik 1.6, please update now (we fixed issues related to this problem in 1.6 and latest).

    It is possible to re-process the specific days or months that are showing zero visit, check out this faq: Re-process reports.

  16. How do I delete historical Piwik data? (purge old logs)

    You can configure Piwik to automatically delete your older logs from the database. Deleting old logs has many advantages: 1) it will free significant database space, 2) which will slightly increase performance, 3) for Privacy reasons, it is sometimes recommended to keep detailed logs only for 6 months or so, and remove older data.

    To configure Log delete in Piwik, login as the Super User, click on Settings > Privacy > Delete old visitor logs from database. You can then configure to Delete logs older than N days, and execute the log purging every day, every week or every month.

    Important: When you enable automatic log deletion, you must ensure that all previous daily reports have been processed, so that no data is lost. See this FAQ for more information.

    Deleted data: When 'Delete old logs' is enabled, only the raw logs of activity will be deleted from the database. Specifically, only the Mysql tables starting with piwik_log_* are affected. All deleted data is lost forever.

    If you have properly setup the auto archiving script (see important note), you will still access all historical reports (even when logs are deleted).

  17. I would like to import an existing Users database (login, password, emails) in Piwik, but the usernames and passwords are more permissive than what Piwik allows. How do I disable the checks on the Logins & Passwords?

    When you automatically import your existing userbase in Piwik using the UsersManager API, you might want to disable the check of minimum length and valid characters for the User's login and password.
    In particular, Piwik requires a password at least 6 characters long, and a login string that must contain only valid characters (ie. letters, @, etc.).
    You can disable these checks by adding in the file config/config.ini.php the following: [General]
    disable_checks_usernames_attributes = 1

  18. Piwik doesn't show me when new updates are available, and the SEO plugin doesn't work.

    Your firewall may be blocking outbound HTTP requests. If you have a HTTP proxy (e.g., squid), you can configure the forward proxy as follows.
    Edit your config/config.ini.php and add the following:
    [proxy]
    host = ; Proxy host: the host name of your proxy server (mandatory)
    port = ; Proxy port: the port that the proxy server listens to. There is no standard default, but 80, 1080, 3128, and 8080 are popular
    username = ; Proxy username: optional; if specified, password is mandatory
    password = ; Proxy password: optional; if specified, username is mandatory

    Once configured, Piwik will contact external hostnames using this proxy server.

  19. "Segmentation fault Error". Piwik reporting or via cron crashes with Segmentation Fault error. What to do?

    Unfortunately, Segmentation fault Piwik errors mean that the lower level software has crashed in some unexpected fashion. In this case, most likely PHP or some of its specific modules (PDO, mysqli, etc.). It is possible to overcome this issue by updating these softwares.
    If you get the Segmentation fault error, the solution is to:

    • Upgrade Piwik and make sure to use the latest version
    • upgrade PHP to the latest version
    • upgrade PDO (and/or mysqli) to the latest version
    • You can also try to switch from PDO_MYSQL to MYSQLI in the config/config.ini.php ; edit the line "adapter = [...]"
    • if you still get the error, try disabling extensions such as eAccelerator, APC, xcache and/or Suhosin.
    • if you still get the segmentation fault error at this point, please try the suggestion in this forum post. If it works for you, please post a reply in the thread

    You should now have a working Piwik instance that does not crash, congratulations.

  20. J'ai ce message d'erreur: "Fatal error: require_once() [function.require]: Failed opening required XYZ in /path/piwik/XYZ.php on line X". Comment faire fonctionner Piwik ?

    Ce message d'erreur signifie que PHP n'a pas inclus un fichier nécessaire à Piwik. Assurez-vous que tous les fichiers Piwik sont bien présents sur votre serveur. Vous pouvez recopier les fichiers manquants en regardant le message d'erreur, ou recopier tous les fichiers Piwik et recommencer: ceci devrait fonctionner!

  21. Que faire quand j'ai un message d'erreur de type : SQLSTATE[HY000] [2002] Can't connect to local MySQL server through socket '/var/lib/mysql/mysql.sock' (11)

    Cela signifie que Piwik n'arrive pas à se connecter à la base de données MySQL. Si vous êtes sur un serveur dédié, vous pouvez essayer de redémarrer Mysql en exécutant par exemple, /etc/init.d/mysql restart. Si vous êtes sur un serveur partagé, nous vous recommandons de contacter votre hébergeur pour qu'ils analysent votre problème de connexion Mysql.

  22. J'obtiens l'erreur "Warning: gzuncompress() [function.gzuncompress]: data error" lorsque je consulte mes rapports piwik.

    Cette erreur apparaît dans des cas très rares lorsque pour, des raisons inconnues, les données ne sont pas correctement enregistrées dans la base de données. Dans Piwik, tous les rapports sont compressés (gzip) et stockés dans les tables piwik_archive_*.

    Pour corriger ce problème, analyser le message d'erreur et rechercher "piwik_archive_blob". Par exemple, si l'erreur ressemble à :

    #0 Piwik_ErrorHandler(2, gzuncompress() [function.gzuncompress]: data error, /path/piwik/core/Archive/Single.php, 250, Array ([name] => Referers_searchEngineByKeyword,[typeValue] => blob,[table] => piwik_archive_blob_2009_05,[...]

    Vous pouvez trouvez "piwik_archive_blob_2009_05". Supprimer cette table dans votre base de données. Piwik la recréera la prochaine fois que vous solliciterez le rapport. Ceci corrigera le problème.

  23. Emails sent from Piwik use the email address @defaultHostnameIfEmpty.example.org, how do I specify my domain name instead?

    By default Piwik will try to detect the current Hostname and use it in all emails sent. In some cases, the hostname cannot be detected and Piwik will use "defaultHostnameIfEmpty.example.org". You can specify your domain name to appear in From: email addresses by adding the following lines in your config/config.ini.php file:
    [mail]
    defaultHostnameIfEmpty = mydomain.com

    This will affect all emails sent from Piwik: Password reminder, Email reports. You can also change the default email address "From:" in PDF reports emails.

  24. Piwik reports this error and fails: "Fatal error: Allowed memory size of X bytes exhausted (tried to allocate X bytes)". What should I do?

    You must increase PHP memory limit. See this page for more info.

  25. Piwik reports this error and doesn't continue: "Fatal error: Maximum execution time of 30 seconds exceeded in ..."

    Your PHP is configured to stop running a script after some time, generally 30 seconds. When Piwik is used on a websites with few thousands visits per day, then this limit might not be high enough. To fix this, modify in your php.ini the max_execution_time value to zero (which means no time limit):

    max_execution_time = 0

    This will ensure that Piwik always has enough time to process your analytics reports.

  26. Graphs in PDF/HTML reports and/or Piwik Mobile do not display characters correctly in my language (display squares instead).

    To display unicode characters in the Static image graphs, please see this FAQ.

  27. When I use http with force_ssl_login=1 or force_ssl=1, I get "Too many redirects". Also when I use https, CSV/PDF reports and graphs don't work.

    If you're not using a reverse proxy, but using https with a web server that doesn't set the HTTPS environment variable, you can either set assume_secure_protocol=1 or reconfigure your web server.
    For example, lighttpd should be configured with setenv.add-environment = ( "HTTPS" => "on" ). Similarly, nginx users should use something like fastcgi_param HTTPS on;.

  28. When included in an IFrame, Piwik reports do not load. How do I allow Piwik reports to load from within an iframe?

    By default, for security reasons, Piwik prevents standard pages and reports to be included in an iframe.
    If you wish to include widgets in your website or app, we recommend you use the standard "Widgets" mechanism.
    If you wish to include the whole Piwik in an iframe, edit your config/config.ini.php under the category [General] add the following line:
    [General]
    enable_framed_pages=1    .

    If you also wish to enable the "Settings" pages (Manage websites, Users, etc.) to load in an iframe you can also add the setting:
    enable_framed_settings=1

    See also: How do I enable users to login into Piwik inside an iframe?

  29. I'm a developer, how do I enable logging (and / or SQL profiling) in Piwik?

    There are a few possibilities with regards to debug logging in Piwik:

    • Enable logging in the Tracker can be useful to debug Tracking issues or improvements. See the documentation page about enabling Debug logging in the piwik.php tracker
    • Enable logging in the Piwik UI: if you are writing a plugin for example, you would need to output messages on screen (or in a file). To do so, you can edit your config.ini.php and add the following block:
      [log]
      logger_message[] = "screen"
      logger_error[] = "screen"
      logger_exception[] = "screen"

      If you wish to debug a live server in production, you can enable logging so that it only outputs the message if you manually append "&debug" in the URL. Under the section [log] in your config.ini.php you can add the following:
      log_only_when_debug_parameter = 1

      All logging configuration options can be found in config/global.ini.php
    • Enable SQL logging & profiling: to see the list of SQL queries executed by Piwik on any given page or widget, you must first enable logging on screen (see point above). Then, edit your config.ini.php and add the following:[Debug]
      enable_sql_profiler = 1

      • Piwik will then output all SQL queries, group them by unique query, and show the total time spent as well as average time spent on each query.

  30. Widgets don't load. I get the error message: "Fatal error: Class '...' not found in ... What's wrong?

    If you have the APC cache extension enabled, then check your PHP settings. For example, 'apc.include_once_override' is experimental and should be disabled. Also there are reported problems when apc.mmap_file_mask is set. So, try this and restart the Apache httpd process/service.
    apc.include_once_override = 0
    apc.mmap_file_mask = /dev/zero

Entries (RSS)