5 =head1 NAME $RCSfile: plotstorage.cgi,v $
7 Plot Clearcse Storage usage
15 Andrew DeFaria <Andrew@ClearSCM.com>
23 Mon Dec 13 09:13:27 EST 2010
27 $Date: 2011/01/14 16:37:04 $
33 Usage plotstorage.cgi: tag=<tag> type=<vob|view> storage=<storage>
34 [height=<height>] [width=<width>] [color=<color>]
35 [scaling=<scaling>] [points=<points>] [tiny=<0|1>]
38 <tag>: Tag of the Clearcase object (vob or view)
39 <type>: Designates whether <tag> is a vob of a view
40 <storage>: Name of the Clearcase storage pool to plot information for
41 <height>: Height of chart (Default: 480px - tiny: 40)
42 <width>: Width of chart (Default: 800px - tiny: 150)
43 <color>: A GD::Color color value (Default: lblue)
44 <scaling>: Currently one of Minute, Hour, Day or Month. Specifies how
45 Clearadm::GetFS will scale the data returned (Default: Minute
47 <points>: Number of points to plot (Default: all points - tiny: 7)
51 Draws a chart of the storage usage for the Clearcase object (vob|view).
52 Parameters such as height, width, color, scaling and points can be set
53 individually though more often the user will just use the web controls to set
54 them. Defaults produce a nice chart. Tiny mode is used by
55 <vob|view>details.cgi to draw tiny charts in the table. Setting tiny sets
56 a number of the other chart options to produce a standard, tiny chart.
65 use lib "$FindBin::Bin/lib", "$FindBin::Bin/../lib";
72 use CGI qw (:standard :cgi-lib);
77 my $VERSION = '$Revision: 1.13 $';
78 ($VERSION) = ($VERSION =~ /\$Revision: (.*) /);
80 $opts{color} ||= 'lblue';
81 $opts{height} ||= 350;
88 $opts{scaling} = 'Day';
91 my $clearadm = Clearadm->new;
93 my $graph = GD::Graph::area->new ($opts{width}, $opts{height});
95 graphError "Tag is required" unless $opts{tag};
96 graphError "Type is required" unless $opts{type};
97 graphError "Storage is required" unless $opts{storage};
99 graphError "Points not numeric (points: $opts{points})"
100 if $opts{points} and $opts{points} !~ /^\d+$/;
102 my @storage = $clearadm->GetStorage (
113 graphError "No data found for $opts{type} $opts{tag} for storage pool $opts{storage}"
127 push @x, $storage{timestamp};
130 push @y, $opts{meg} ? $storage{size} / (1024 * 1024) :
131 $storage{size} / (1024 * 1024 * 12024);
134 my @data = ([@x], [@y]);
136 my $x_label_skip = @x > 1000 ? 200
142 my $storageLabel = ucfirst $opts{storage};
143 my $x_label = $opts{tiny} ? '' : "$storageLabel Storage";
144 my $y_label = $opts{tiny} ? '' :
145 $opts{msg} ? 'Used (Meg)' : 'Used (Gig)';
146 my $title = $opts{tiny} ? '' : "Storage usage for "
147 . "$opts{type}:$opts{tag} $storageLabel";
148 my $labelY = $opts{tiny} ? '' : '%.2f';
152 x_labels_vertical => 1,
153 x_label_skip => $x_label_skip,
154 x_label_position => .5,
156 y_number_format => $labelY,
158 dclrs => [$opts{color}],
166 ) or graphError $graph->error;
168 my $image = $graph->plot(\@data)
169 or croak $graph->error;
171 print "Content-type: image/png\n\n";
176 =head1 CONFIGURATION AND ENVIRONMENT
178 DEBUG: If set then $debug is set to this level.
180 VERBOSE: If set then $verbose is set to this level.
182 TRACE: If set then $trace is set to this level.
192 L<Getopt::Long|Getopt::Long>
194 L<GD::Graph::area|GD::Graph::area>
196 =head2 ClearSCM Perl Modules
209 <a href="http://clearscm.com/php/scm_man.php?file=clearadm/lib/Clearadm.pm">Clearadm</a><br>
210 <a href="http://clearscm.com/php/scm_man.php?file=clearadm/lib/ClearadmWeb.pm">ClearadmWeb</a><br>
211 <a href="http://clearscm.com/php/scm_man.php?file=lib/Display.pm">Display</a><br>
216 =head1 BUGS AND LIMITATIONS
218 There are no known bugs in this script
220 Please report problems to Andrew DeFaria <Andrew@ClearSCM.com>.
222 =head1 LICENSE AND COPYRIGHT
224 Copyright (c) 2010, ClearSCM, Inc. All rights reserved.