> #### Graphical output environment variables

> There are two environment variables that control how graphs display in HTML report output.

> - GRAPH1COLUMNS — For use with report output associated with either a single resource or multiple resources:
> - For instances reporting on single resources, this variable controls the number of columns displayed in the graph. For example, most historical reports are designed to display graphical data in HTML output associated with report-related default fields. However, by adding the variable GRAPH1COLUMNS followed by other fields associated with a report, you can customize the graphic report output. See the "Single resource output" section for an example.
> - For instances reporting on multiple resources, GRAPH1COLUMNS controls the number of graphs displayed. The output will contain one graph for each output category you indicate. Enter the names of the output categories in quotes.
> - fathomResourcesPerGraph — For use with report instances that report on multiple resources. This variable controls the number of resources displayed in each graph. The default number of resources displayed is five.
> Note: Only AppServer and WebSpeed reports allow you to report on multiple resources.

> ##### Single resource output

> Figure 2–1 shows an example of the type of graph that displays when you run the CPU Summary report without GRAPH1COLUMNS defined. In instances when you do not choose to define environment variables in the Environment field on the Create Report page, Fathom creates a report graph using the values associated with a report type's default fields.

> The graph report output example in Figure 2–1 uses the values associated with the CPU Summary report's default fields.

> Figure 2–1: CPU Summary output

> In contrast, the following code, entered in the Environment field on the Create Report page, shows how you can customize the graph output of the report by defining fields:

> `GRAPH1COLUMNS=CPU_Idle,CPU_System,CPU_Wait`

> When the CPU Summary report is run with this code, the data associated with the specified fields appears. Figure 2–2 shows this customized output.

> Figure 2–2: Customized graph output for CPU Summary

> See the "Report output field and column headings" section for a complete list of the column and field headings available for each report template.

> ##### Multiple resources output

> Figure 2–3 shows an example of the type of graph that displays when you run the AppServer Application Profile report without the GRAPH1COLUMNS or the fathomResourcesPerGraph defined. In instances when you do not choose to define environment variables in the Environment field in the Create Report page, Fathom creates a report graph using the values associated with a report type's default fields.

> The graph report output example in Figure 2–3 uses the values associated with the AppServer Application Profile report's default fields.

> Figure 2–3: AppServer Application Profile output

> In contrast, the following code, entered in the Environment field on the Create Reports page, shows how you can customize the graph output of the report by defining:

> - Column headings for GRAHP1COLUMNS.
> - Number of resources to display per graph for fathomResourcesPerGraph.

> When the AppServer Application Profile report is run with the following code, only the column heading-related data with the specified number of resources per graph appear:

> `GRAPH1COLUMNS="Run Count,Request Duration (avg),Return Code Success"` `fathomResourcesPerGraph="7"`

> Figure 2–4, Figure 2–5, and Figure 2–6 show this customized output.

> Figure 2–4: Request duration graph

> Figure 2–5: Return code success graph

> Figure 2–6: Run count graph

Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095