Frequently Asked Questions

How do I do (some feature) in Analog?

Look at the Analog documentation. It's there. Really. If you can't figure it out or can't find it, try joining the Analog-help mailing list and posting your question there.

I get a GD error when I try to run Report Magic

or, GD won't build when I try to install Report Magic

or, libgd won't build. It can't find 'jpeg' (or other resource).

As described in the Source Package Installation instructions,you must install libgd before you can install GD (the Perl module). You must install GD before Report Magic will run. When installing libgd, you will likely need to edit the Makefile for the gd library to tell it which optional components (TTF support, Jpeg support, XPM support) should be added. When you build GD, it now asks you which of these options you built libgd with. Please remeber the options and answer accordingly. It should build without issue thereafter.

The "Most Active" quantity in my time reports not right

The Most Active entry will list the last line of the report whether or not it appears to be most active, if you have set your Active_Column to a column that is not in the report. For example, if your report only show columns for page request (P) and percent of page requests (p), then set the Active_Column for that report (or all your reports) to P or p.

Why don't I get any pie charts?

When configuring Report Magic, you set the column that you consider the most important as the Active_Column in your settings file. That is, if you are concerned about the number of pages requested and sent on your servers, you would set [reports] Active_Column to 'P'. This tells Report Magic what column to graph, in each report that has a graph, and what column to track for summaries in the Quick Summary report. If you aren't getting pie charts then Analog isn't producing 'Percent of page' (or Percent of Request or Percent of Bytes) data. Change this either by adding a Active_Column section specific to the offending report in that report's section, or by modifying your Analog config file to include both 'P' and 'p' (or 'R' and 'r' or 'B' and 'b') in the *COLS commands for the reports in question.

I'm still confused about how Report Magic decides what charts to build. Can you elaborate?

Report Magic determines it's charts based on the GraphType setting, the ActiveColumn setting and the available columns of data.

GraphType takes a comma-separated list of types of graphs that you want Report Magic to produce for the report. Valid values are pie, bar and line.

ActiveColumn takes a single character representing the column to chart: P, B, or R.

The value of ActiveColumn is case-insensitive. So if you set it to p, b, or r, you should get the same charts you do when set to P, B, or R.

To get both a bar and a line chart, simply set your GraphType value like this:

   GraphType = bar,pie

If your data contains both the count and percent values for the column you have chosen in your ActiveColumn (e.g. if you have ActiveColumn=R and your data has both R and r columns) then you will get both charts. Otherwise it will only plot the chart that it has data for.

Why don't my bullets show up in the navigation page?

The bullets are images specified by the Bullet_Image setting in the [navigation] section of your configuration file. This setting should point, virtually, to the bullet image, relative to the completed navigation page. In other words, whatever you put in here (say, "image/bar1.gif") end up as the SRC attribute of the IMG tag for the bullet. So when the navigation page is loaded by your browser it looks for the file relative to that page. (If the navigation page is in "/stats/navfile.html" as specified by the File_Out setting in the [navigation] section, then the image above should be in your website area in "/stats/images/bar1.gif".)

Other Questions

For questions not answered here or in the docs or suggestions for future versions, please try the Report Magic Help mailing list. See the Report Magic mailing lists page for information on joining.