-
Notifications
You must be signed in to change notification settings - Fork 0
/
CHANGES
1106 lines (826 loc) · 40 KB
/
CHANGES
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
New features, fixes in version 1.0.6 (TBD)
$gInstallRoot is now propogated to the environment during collector
runs for the benefit of "exec" datasources.
Removed call to fixNum() in snmp.pm routine snmpFetch. This addresses
Bug #974877.
Added $gCopyConfig flag (see cricket-conf.sample.pl) for Win32 compile
and collection run conflicts. Credit goes to Adam Meltzer.
Cricket's grapher.cgi will now output real Last-Modified and Expires HTTP
header fields instead of futzing around with random numbers in the URL.
[Patch #480694]
Added two new HOWTOs, cricket-nt.html and polling-rate.html, which
explain how to get Cricket running on Windows NT and how to change the
polling rate, respectively. See the doc/HOWTO/ directory.
[Patch #205966] / [Patch #818057]
Added a target's "short-desc" string to the page title. [Bug #213706]
Added new "image-cache-interval" tag to the target dictionary to allow
explicitly setting how long graph images should be cached. The new algorithm
uses image-cache-interval, rrd-poll-interval, or 5 minutes (in that order).
Based on [Patch #400217] from Tom Honermann.
The configuration variables $subtreeSets and $gMailer from collect-subtrees
have now been exorcized in favor of $gSubtreeSets and $gMailer, respectively,
in cricket-conf.pl. [Bug #847413]
Added support for using a UNIX domain socket as the target of a "FILE"
datasource. [Patch #1083977]
Fixed race condition in config-tree recompiles. If a compile is in progress
when "compile" tries to create a lock, it will now retry 5 times at 5
second intervalls before bailing out. If the previous compile seems to have
been abandoned -- i.e. lockfile is more than 900 seconds (15 minutes) -- it
will forcibly acquire the lock and procede with the recompile. Patch from
John Magne Bredal and the NAV project, by way of Morten Werner Olsen.
[Patch #1011277]
Added an Hourly graph that will show the last 10 hours; which is short enough
to show individual data points with 5-minute polling, and something sane with
1-minute polling, while still showing an entire 8-hour period (an entire work
day, say). [Patch #921537]
Added support for new copy-to type "file" from [Patch #400598].
New features, fixes in version 1.0.5
Cricket 1.0.5 is essentially a minor bugfix release.
An error with case dependance with new style views was eliminated.
A "label" tag was added to the "view" dictionary. This eliminates
the need for using spaces in view names. It also allows the Cricket
admin to alias different targetTypes to the same name in the
HTML menu -- use this feature wisely!
systemPerfConf.pl was reverted back to using our own SNMP_Session
based SNMP interface, and interfaces detection was added [Mike Han]
The distributed sample-config/Defaults has width-hint and
height-hint commented out, to cut down on squashed graphics.
The handling of NaN was standardized throughout the code.
To check for NaN, use isNaN from Common::Util.
All text files now have LF line endings. In the 1.0.4 release,
a number of files were inadvertantly changed to have CRLF line
endings.
A small bug in threshold monitoring was identified and fixed
by Jase MacLeod.
Error reporting by the monitor subsystem has been reviewed and
made more extensive, based on a patch by Andrew Clark.
If you have scripts that look for the text string "Skipping",
you are well advised to look for "Monitor" instead, and review
your scripts while you're at it.
We now support s390x-linux, thanks to Shane Stixrud. [Patch
#877924]
New features, fixes in version 1.0.4
Added span option for monitor-thresholds of all types [Patch #838250].
Added new option to log entry format [Patch #565877].
Added new META monitor thresholds action [Patch #821255].
Added support for sparc64-netbsd from Edwin Mons [Patch #803408].
Documented the "use-gprint" target option [Bug #667178].
Documented the "show-path" target option [Bug #667179].
Added support for optionally logging the full path to a datasource
in collector output. By setting $gLogFullPath=1 in cricket-sonf.pl
you will get e.g. "Switches/Cat4000/core/FastEthernet0_1" instead
of just "FastEthernet0_1" in your logs.
Added a new "hidden" tag to the "target" dictionary. When this is
set to a true value the target will be skipped by the grapher to
enable you to display the data combined in an "mtarget" instead.
[Patch #697737]
Support for package qualification in func data source fetching
(patch #772097).
Support for RRD version 0003 files on some architectures; the
last update microsecond value is not actual available in Cricket
(and hence not published in the grapher Summary) but it is
accommodated (so that functions like getDSCurrentValue that
essentially use pointer arithmetic to jump around the binary RRD
files will work).
Fix for bug #666675; the "floating point comparison perl 5.8"
issue. The most prominent symptom of this issue is the message
"Current values not available: Something is wrong with the
header of this file" in the grapher summary panel.
Documentation for the failures monitor threshold. Permit
conditioning a failures monitor threshold on a range.
Fix to loading WMI Scripting constants library in wbem.pm.
Should allow using WMI on WinXP.
Minor fixes to Monitor.pm: detection of NaN/nan, LogToFile
duplicate line detection, and new SNMP VarBind (9) to send
value in trap. [patch #592165, #592163]
An experimental new feature allows you to use the Cricket
target name as the rrd datasource name. Some caveats apply:
- if you use COMPUTE datasources, you will have to manually
edit your config tree, and update all rrd-cdef rules to
match the new reality. Do not switch on long ds names
unless you're prepared to do this! In particular, users
of the NT perfmon tree should not yet enable this.
- RRD ds names are limited to 19 characters. Cricket datasource
names longer than 15 characters are edited automatically to
ensure the RRD ds name remains unique. You can use the
Common::Util::mungeDsName routine in your own code to generate
compatible munged names (or use target names under 16
characters to avoid the issue altogether).
The feature is enabled by putting
$gLongDSName=1
in their cricket-conf.pl
Introducing the view dictionary! Views are now separate config
tree entries. Going forward, the view tag in the targettype
dictionary should specify a comma-delimited list of views that
are defined in separate view entries. View entries support all
non-datasource specific graph tags (aka graph --default-- tags)
and view specific tags. The most important view specific tag is
'elements' which specifies a comma-delimited or space-delimited
list of data sources. Note that this change should not break
existing config trees because the old targettype view tag syntax
is still supported.
listInterfaces has been updated (users of the contributed
web site may recognize listInterfaces+). When upgrading from
previous versions of Cricket, it is recommended that you
review any scripts that call listInterfaces.
The URL style is now selectable from cricket-conf.pl. Options
are "classic" (what Cricket 1.0.3 did, default), "relative"
(which uses relative URLs, for reverse proxy) and "pathinfo"
(passes the target name as part of the URL path, which allows
for using Apache <Location> access restrictions).
It is possible to mark NaN samples in the graph with a colored
background. This is enabled via the view tag paint-nan (boolean value).
WARNING: do not enable this if you use the STACK draw-as
type anywhere in your graphs.
Added an alternate SNMP interface, using net-snmp. See
lib/alternate/snmpUtils.pm. Not recommended in its current
incarnation for users of SNMP traps and threshold monitoring.
On some systems, using it may speed up Cricket by 10-15%.
Fix mtargets bugs w.r.t. MiXeD CaSe names (hopefully for good)
[bug #521367]
Fix graph scaling with explicit "bytes=false", which was
misinterpreted by the graphing code.
Updated getFormat.c from John Woolner [Patch #454472].
New features, fixes in version 1.0.3
The many disk accesses to the config database that collector
uses are causing the collector to run slowly on sites with
huge config trees. Starting with 1.0.3, the entire config
tree is slurped into memory. This causes a significant speedup
at the expense of collectors memory size. The database access
method can be set to "lookup" in cricket-conf.pl to revert
to the old behavior if collector memory footprint is of greater
concern to you than its hammering on the disk.
A new way of configuring Cricket has been added. It is now
possible to create a file called cricket-conf.pl, which can
either reside in the same directory as the grapher.cgi
and collector scripts, or in /usr/local/etc. This should
eliminate the need to edit grapher.cgi, and make life easier
for people running Cricket on NT. The change should be
backwards compatible, please file a bug on Sourceforge if it
is not. A sample file is provided as cricket-conf.pl.sample.
The implementation of the MAIL action tag for monitor thresholds
is complete. New VarBinds added for SNMP trap monitor thresholds.
Added a new monitor threshold type, quotient. Revised and extended
monitor threshold documentation. Added "exact" monitor type.
A new config option, show-path, was added that allows the
display of the current path in the config tree with clickable
links for easier backtracking. Defaults to "no".
Support for SNMP version 2, as well as for the additional
options that SNMP_Session now offers has been added to
the sample-config/Defaults file. For existing installations,
it is recommended you install the sample-config/Defaults into
your cricket-config and merge your local changes in.
If you do this, or if you install Cricket from scratch, you
should use SNMP_Session version 0.80 or higher (it is
recommended to upgrade SNMP_Session regardless, there were
some rare but hard to diagnose bugs in versions prior to 0.78).
The defaults are
snmp-timeout = 2.0
snmp-retries = 5
snmp-version = 1
If you know what you're doing, you could reduce the number of
retries or the timeout, but this is not recommended. Existing
Cricket users should first evaluate the effectiveness of
the dead-SNMP-host detection that's new with 1.0.3 before
mucking with the SNMP settings.
Support for Windows Management Instrumentation on the Windows
2000 Platform. Refer to doc/win2kwmi.html.
The SNMP code now has intelligence built in to quickly
skip a device that is down or otherwise doesn't respond.
After two successive timeouts from the same host in one
collector run, that host is considered down and subsequent
targets on that device will be marked 'U' without checking.
This avoids the syndrome where one device with a lot of
targets can significantly slow down your collection
process. If you need, you can increase MAXTRIES in
lib/snmpUtils.pm. [patch #402839]
The top level Defaults now sets rrd-min to 0 rather than
undef. The default rrd-ds-type now is DERIVE instead of
COUNTER. These changes prevent spikes in graphs. For the
intrepid, Cricket can now monitor snmp-uptime in conjunction
with using COUNTER (usage of snmp-uptime is not recommended
unless you understand all possible causes of SNMP counter
rollover; not all agent resets can be detected). [bug #209530]
squid-proxy subtree Defaults file has changed. One
more variable is being polled now (CurrentLRUExpiration)
so you'll need to either recreate your old RRDs, or
use add_ds from the RRD distribution's contrib directory
to add a datasource to your existing RRD files.
Some internal changes were made that should not be user
visible (except perhaps by running faster in some cases).
Most notably, the internal database types "D:" and "n:" are
no longer generated.
All files were made consistent in their indentation. We now
use soft tabs exclusively, with a tab size of 4.
RPN now allows negative constants, like in this magic which
inverts a percentage from 0-100 to 100-0:
100,-,-1,*
Fixes bugs #472862 & # 450391.
Portability: Some failures on AIX have been eliminated.
More hardware platforms are supported by lib/RRD/Format.pm.
New features, fixes in version 1.0.2 (18-May-00):
Fixed bug #104757, $clmxCode/max-color bugs.
New features, fixes in version 1.0.1 (18-May-00):
Various small bugs fixed, related to mixed case names.
Documentation split into smaller files and reviewed.
First release from Sourceforge's CVS server.
Assorted bugs and patches that were also integrated:
bug 212204 compile: add config-dir name to output
bug 202221 Fix for display of scaled values in mtargets
bug 202262 Summary should show up at bottom (optionally) [feature]
bug 202266 mtargets and targets and multi-target2 [doc clarification]
bug 202455 need to quote url passed to test-url
bug 205504 collect-subtrees / subtree-times [feature]
bug 205559 integrate functions of run-subtree into collector
bug 205560 collector log rolling for .time files
bug 205595 Collector optimizations
bug 206305 Persistent monitoring toggle
patch 400218 cricket-0.72-current_path.patch
patch 400282 cricket-0.72-showmax.patch (docs changes)
patch 400431 lib/RRD/Format.pm had incorrect regex for supported
archname (similar to bug 206166, and a couple of others)
New features, fixes in version 0.72 (23-Jan-00):
Fixed a typo in one of the "fixed" split lines from the
last release.
Fixed a typo that makes scaled mtargets work right.
Fixed the height-hint in the root Defaults file to match
the height used by rrdtool-1.0.10.
Fixed y-min/y-max code, hopefully once and for all.
Directories named 'CVS' (exactly) in the config tree
are ignored now.
Collect-subtrees now makes the log directory if necessary.
Minor documentation fixes to reference.html.
Cleared up warnings when inst-names tag is missing.
New features, fixes in version 0.71 (09-Jan-00):
This release has a minimal number of patches to fix
the most pressing bugs reported to me in the last 4 months.
It works with RRD Tool 1.0.10. You must upgrade your RRD Tool
install to this version to use Cricket 0.71. (This is because some
critical bugs have been fixed recently in RRD Tool.)
If this version of Crikcet proves to be stable, it will be
renamed 1.0. Future development will take place in 1.0.x
releases, culminating in a 1.1 release. In general, three-digit
releases will be development, two digit releases production.
Here are the patches that have been applied to Cricket 0.70:
Minor documentation fixes.
A new avg() function to go with the sum() function.
Scaling works right in multitargets now.
Event names are case insensitive, as documented now.
Comma and colon delimited lists now ALWAYS allow
whitespace. Previously, rrd-tune was broken because
of a split() that was too restrictive. All of these
have been fixed.
Cricket no longer gives RRD Tool input that crashes it.
Support for various architectures added to Format.pm.
Lots of changes to Monitor.pm, but it's still not ready for
production use. Sorry.
http-performance tests a slightly different URL
New features, fixes in version 0.70 (11-Aug-99):
ATTENTION: You must use RRD Tool 1.0.x with Cricket 0.70
and higher. Cricket now defaults to making PNG pictures,
if you are using a 4.0 browser or better. If you really
want GIFs (which are big and slow, now that GD has been
lobotomized by Dr. Unisys), then you need to investigate
the graph-format tag in the graph dictionary.
Frobbed the quoting magic some. I think it was broken before.
I think it is less broken now. If you see odd behavior, suspect
quoting problems.
Integrated a patch from Shannon Reis <[email protected]>
that adds avg/max display in. This adds an additional
call to RRDs::graph. If you want it the old way, check
out the tag named show-avg-max in the graph dict.
backed out change related to lower-casing the
target names in the targets and mtargets tags. What
was I thinking?
usrModemUsage script no longer tries to use
common.pm.
removed useless and confusing reference to domain
in the routers subtree.
made warnings work right in util/* again. Oops.
made the mapping routines use collect=false when
called from the collector. Note: if you set collect
to 'false', the target will still show up in the grapher
and if necessary, the instance will be mapped. This
could cause warnings in the grapher, but they can be
ignored.
New features, fixes in version 0.69 (16-Jul-99):
A bunch of namespace fixes:
The collector can again make directories when necessary.
Instance mapping works. Lots of other fixes...
Monitoring is now documented, and seems to work.
Please read the description of the tag named
'monitor-thresholds' and discuss this stuff on the
mailing list. Javier Muniz, who wrote it, will be available
to help us learn about it in the coming weeks.
The new unknown-is-zero tag in the targets dictionary
makes it possible to add together graphs which have unknown
regions and not have the unknown regions blot out the entire
graph.
New features, fixes in version 0.68 (09-Jul-99):
Made it possible to use mixed case in mtargets and targets
specifications.
Integrated patch that makes y-min and y-max datasource-level.
Added patches to make it work under NT (again).
Significant changes to namespace usage to
make it work under mod_perl. Search for mod_perl
in reference.html for more info.
Fixed sum() to work right.
Fixes to make it work (sorta) under mod_perl.
Fixed a minor bug related to iterating over
results from the table walks done during
instance mapping.
Made the error message for an unmatched quote
include the file and line number.
New features, fixes in version 0.67 (09-Jun-99):
Fix: Added quoting to the inst tag to protect the
argument of map() from eval.
Fix: made overzealous warning from Perl
(in Log.pm) go away.
Fix: A vector instance with one element is now
correctly treated like a fixed-instance scalar.
If you didn't understand that, don't worry. What
it means is that Cricket will Do the Right Thing.
Fix: missed a conversion of expandString. Instance
mapping now works again.
New features, fixes in version 0.66 (03-Jun-99):
Fix: instance names are correctly shown in the title
after visiting the instance seletor widget.
New feature: target tag collect=false tells the
collector to skip that target.
Fix: all dictionaries are expanded with respect
to the target dictionary, which seems to be more in
line with how people thought it would behave.
I'm not certain how people are going to use this,
but if it makes people less confused, it's good, I
guess.
New feature: events. You can mark a graph with a
vertical rule of any color to mark the time something
of interest happened. Check out the new events target
tag, and the event dictioanry. This requires Date::Parse,
but you should have that anyway. If not, go to CPAN
and get it.
New feature: eval's during expansion. You can surround
code you want eval'd with {} in a tag, and that will
happen immediately after expansion. So this:
snmp-port-2 = "%snmp-port% + 1"
results in snmp-port-2 getting set to 162 (i.e. 161 + 1).
Useful functions to make use of this will be coming
to a release near you soon. In particular, there
will be a snmpget() and a snmpwalk() that behave
in ways that help make the config tree more compact.
New feaute: directories can have descriptions which
show up in directory selection list. See
target tag directory-desc.
SLIGHTLY INCOMPATIBLE CHANGE: I renamed the meta
tag, since it makes more sense to call it
'head-html' where it is used. Compare your existing
root Defaults file to the one in sample-config
and you'll see the change. See the docs for how you
might use this to use stylesheets to override my
terrible sense of style.
Converter completely removed. If you have RRD files
in pre 0.99 format, you'll need to use Cricket 0.65
to convert them, then upgrade to later versions.
The white in cricket-sm.gif is now transparent. And
it's 20 bytes smaller. Cool.
Added a new subtree for monitoring news servers.
grapher.cgi will no longer fail on negative data.
We now compute the si_unit using abs($value).
Expansion is now working correctly in the target
selector widget.
There's a new trap subroutine in snmpUtils that
makes it possible to specify OIDs in outgoing traps.
New features, fixes in version 0.65 (19-May-99):
This is the paper-bag-over-my-head release.
This fixes a big bug in the config tree system
that made it unable to understand config trees
deeper than two levels.
There are also some minor fixes to ignore RCS
files correctly.
New features, fixes in version 0.64 (18-May-99):
Sorry I got a bit verbose this time... a lot of
infrastructure stuff has been happening recently. Keep
reading all the way... there are some incompatible
changes in this release.
This version was tested with RRD Tool 0.99.29.1.
It should work with other 0.99.x releases of RRD Tool
also.
You need to have the Perl module named DB_File
installed to use this release. It's relatively
standard, but if you don't have it, go get it
from CPAN. (See doc/beginner.txt for more info on
CPAN.) You can check to see if you have it by executing:
perl -MDB_File -e 'print $DB_File::VERSION, "\n"'
New feature: Cricket operates off of a compiled
form of the config tree, which is stored in a file
named config.db in the root of your config tree.
The collector will recompile this as necessary,
but when you are making interactive changes to the
config tree, you need to remember to recompile it
yourself -- the grapher does not have the permissions
it needs to recompile it. The grapher will set the
variable auto-error with a warning about the out-of-date
compiled form. If you have added that variable to your
page-footer tag, you'll at least get a reminder message.
(search for auto-error in sample-config/Default for
an example).
To recompile the config tree manually, run:
$HOME/cricket/compile -base <config-tree-base>
If your config tree is in ~/cricket-config, you can omit
the -base argument, since that is the default.
New feature: ds-sources can now return text information
after an floating point number, and Cricket will correctly
ignore the text and use only the number. See the EXEC
example in the docs for how this might be useful.
New feature: you can defeat the cache by hand editing the
URL that points to the target display page. Add '&cache=no'
onto the end of the URL. This is helpful when you are
making changes to the graph dictionary, and you want to
regenerate the graphs on demand to see your changes.
Remember, however, that you still need to recompile the
Config Tree after each change.
INCOMPATIBLE CHANGE: collect-subtree is now named
collect-subtrees. It reads a file named subtree-sets
which is slightly different format. For one, you need
to replace the "subtree foo" lines with "set foo". You
also need to nae subtrees by their full path relative
to the root of the config tree. For instance,
"router-interfaces" becomes "/router-interfaces".
INCOMPATIBLE CHANGE: the URLs used by the grapher
are a bit different now. If you have saved bookmarks
that jump into certain parts of the config tree,
they might not work now. Check them, and fix them
if necessary. (The target parameter is no longer
rooted at the Unix root.)
New subtrees: usr, for monitoring USR modem chassis.
New utilities: generate-statics and pmlines.pm, a more
flexible replacement for PM3lines. Note that the portmaster
subtree may not be in sync with the utility anymore...
I'm not a portmaster user, so I'm relying on patches from
you guys.
generate-statics is a cool little tool to take snapshots
of the GIFs. Read about it in the util/README file.
New feature: graph dict tag rrd-graph-args allows
you to send arguments directly in to RRD Tool, which
Cricket does not already send for you. A notable use
of this would be to set colors on the graphs to something
other than the default. See the docs for more info.
I made the page-footer easier to override in subtrees.
If you want to put something in the center pane
replace the tag named contact with your stuff.
New feature: if mtargets-ops is "sum()", it is replaced
with the right number of plusses.
Grapher.cgi is a big mother, and it takes a long time
for Perl to parse it. It now redirects image requests
through mini-graph.cgi, which is a tiny mother, which
is fast to parse. This makes your webserver spend less
time parsing Perl and more time spraying GIFs, which
is a Good Thing. This may not work on NT. If not,
comment out the line in grapher.cgi with "mini-graph.cgi"
in it. (It's a substitution on the variable $me.)
Please send patches to make this work on NT. :)
You may need to add a new link in ~/public_html/cricket
to point to mini-graph.cgi.
New features, fixes in version 0.63 (02-Apr-99):
INCOMPATIBLE CHANGE: If you have installed previous
versions, you need to compare your targetType
lines to the ones in the sample-config tree and fix them.
Basically, tags are no longer allowed to appear
multiple times, instead they must appear once
with a comma-delimited list inside quotes.
Jeff Jensen gave us the kick butt routing subtree,
which lets you watch BGP updates with Cricket.
The paper I wrote for NetA 99 is in doc/neta-paper.
A new smaller rrdtool.gif Tobi gave me a long time
ago which I forgot to add.
Various bugfixes to jpj's new mtargets thing.
Fixed a goofy bug which made view get set wrong
when there were targets with and without a view
in the same directory.
collect-subtrees processes all subtree sets if it
was given no arguments. Also cleaned up an error
message.
We now set --base correctly when drawing graphs.
We decide how to set it based on the bytes tag
in the graph dictionary.
Unspecified bug in VRULE generation for yearly graphs
fixed. Russ is the man.
New features, fixes in version 0.62 (27-Mar-99):
Fixed some bugs in getFormat.c that the Compaq (cough)
Alpha let us notice. It now creates output suitable to
cut and paste into lib/RRD/Format.pm. Yippee.
atm-interfaces subtree was contributed by Alan.
grapher.cgi is friendlier about a missing VERSION
file. But you really _should_ still have it in the
same directory that grapher.cgi is in.
Added the new disable-short-desc tag, which
can make more room in the target selection table
by skipping the description column.
Fixed the README to reflect a recursive diff for submitting
patches. (jpj)
Updated or created documentation for targets,
targets-short-desc, targets-long-desc, mtargets,
and mtargets-ops. (jpj)
Implemented support for graphing multiple targets on
the same graph using the mtargets tag. (jpj)
Implemented basic support for graphing of arithematic
operations on targets. You can now graph the sum of
multiple targets, as well as other operations! (jpj)
New features, fixes in version 0.61 (07-Mar-99):
Interlaced now works as specified in the manual.
Previously you had to use "interleaved", which is
not what the docs said.
You can specify the time at which a given measurement
was taken. Search for XXX@YYY in the reference docs.
Minor efficiency change in collector.
Cricket can now send traps with the data it is collecting
inside. This is useful if you happen to be running
Netcool, and you've set things up correctly to
escalate alerts holding data that violates
certain thresholds. However, it is implemented to be
flexible enough to later let us send data other places.
See the docs for tag copy-to for more info.
As part of the copy-to implementation, snmpUtils now
knows how to send SNMP traps. Cool.
New features, fixes in version 0.60 (05-Mar-99):
CHANGE REQUIRING YOUR INTERVENTION!!!
Old versions of Cricket might not have set rrd-min
and rrd-max correctly in your RRD files. In this
version of Cricket, the values come from the
datasource dictionary, and from the target dictionary.
If they are present in the target dictionary, they override
the ones in the datasource dictionary. Check
your config now to make certain it's doing what you
want, and then run rrd-tune to apply the values
to your existing RRD's.
support for Portmasters, via an EXEC script.
support for FreeBSD.
removed unused call to localtime from grapher.cgi
listInterfaces no longer lets colons creep into target
names.
rrd-dump truncates C strings correctly now.
More control over multitargets with targets-desc-long
and targets-desc-short. (Thanks, jpj.)
Datasource descriptions are now displayed in the order
they occur on the graphs.
New features, fixes in version 0.59 (15-Feb-99):
grapher now handles blank long-desc gracefully.
grapher will attempt to put up an error message
in a GIF (failed.gif) when it cannot give you
a graph.
Minor fix in options to handle unset $HOME better.
Grapher debug level defaults to 'info' again.
Multi-target supports instances now. The separator
in the targets tag is now ";". This is not a backwards
compatible change; if you were using targets before,
you need to change it now. It's all still undocumented
but it getting stable enough to document it.
Fixed bug reated to inst not getting set and
causing a warning.
FAQ updated... keep those "dumb" questions coming! The
only dumb question is one we don't document and learn
from!
RRD::Format now supports Linux again, and there's
a nifty tool from Ed that makes it a no-brainer
to port to new OS's. See the comments in RRD::Format.
New features, fixes in version 0.58 (05-Feb-99):
FINALLY: Support for RRD 0.99.* (tested with 0.99.7)
(only the RRDs (shared library) module, at this time)
NOTE: You MUST edit your RRA definitions, if you will
be creating new RRD's. (Do it now before you forget!!!)
You need to add the x-files-factor into the RRA definition
after the consolidation function. See the comments in the
root Defaults file. (New users can simply copy sample-config
as usual.)
Collector will do auto-conversion from old-format RRD files,
for all you old-timers. It works like this; run 'collector'
by hand once with the option '-convert'. Any RRD files that
need to be converted will be. You can run with '-convert' as
often as you want -- it will only do the conversion once.
You can also convert a file on demand using util/convert-file.
The old files are left in the same directory as "foo.rrd.old".
Using find to remove them would save a lot of disk space --
if you trust the converter. :) The command is:
find ~/cricket-data -name '*.old' -exec rm {} \;
collect-subtrees now takes a -cf arg, which you can
use to tell it to look at a different subtrees file.
Fixed incorrect HTML entity in sample-configs/rotuers/Defaults.
Cricket's version is now available in the HTML dictionary,
in both it's long and short forms. You can see it in action
in the newest root Defaults file, which puts the version number
in the footer.
New features, fixes in version 0.57 (02-Feb-99):
Sample config tree now contains Cricket logo and the RRD
logo. You should definately upgrade your root Defaults file...
the logos look cool!
Changes cached expiration system to be real-time. This means
no evil cron job (yeah), no permissions problems (yeah) and
no possibility of incorrectly cached graphs. I think.
Expansions on the target list pages are now handled
correctly.
Short-desc is used now in the aggregates and at the
top of target pages.
New tag: bytes, which tells si_unit to calculate the prefix
using powers of 2 instead of 10. "bytes" is set to true for
ifInOctets and ifOutOctets in the sample tree now.
Ignores files like "#foo#", which emacs can leave behind
as backups.
Datasources were not actually case insensitve like the
docs claimed they were. Now they are. (Rumor has it they
aren't everywhere yet...)
Fixed bugs related to instance lists with variable expansions
in them. Also a bug related to quoting these guys.
Fixed bug in the way micro symbol was displayed.
RRD::Format now supports arch i86pc-solaris and MSWin32-x86.
listInterface will quote more lines that need it (i.e.
empty or whitespace only lines).
New features, fixes in version 0.56 (15-Jan-99):
Documentation updated in various ways, including
new features, new info on purging the GIF cache, and
fixed typos.
Made RRD::Format cross-architecture. Supports
sun4-solaris and i386-linux. For tips on
porting to other archtectures, see lib/RRD/Format.pm.
Reworked Makefile to make a more better tarfile (writeable
files, and no garbage in lib).
Added a "rand" parameter to image URLs so that Netscape
will let RRD decide what things should be cached. Search
for "rand" in grapher.cgi to shut this off, if you are
annoyed by the slightly longer load times.
Added a caching mechanism to the graph drawing routine.
The cache dir can be changed easily by editing the beginning
of grapher.cgi. It will never hold more than 5 minutes worth
of graphs, so /tmp should be appropriate. Clearing the
cache is done by running grapher.cgi from cron with certain
options. Search for "cache" in the documentation.
Made collect-subtree strip leading whitespace from
subtree names correctly.
Taught listInterfaces and router-interfaces subtree
about sub-interfaces. It turns out that some interfaces,
like those related to PVC's on frame relay circuits,
will not tell you the packet or error counts. So
listInterfaces tries to mark those as "sub-interface"
type interfaces, so that we don't try to fetch things
that we can't get.
New feature: inst-names will let you name the instances
in a vector instance list. See documentation for details.
New feature: the graph dict tag si-units=false will
let you disable si_unit(), which turns 2000 in 2k. The
scales of the graph will still have the SI transformation
done to them.
The instance selector widget is now formatted as a
5 column table.
New features, fixes in version 0.55 (07-Jan-99):
Various fixes to make it work better on NT.
Documentation expanded.
listInterfaces handles quoting right.
Squid OIDs revisited. (Still might not be right...)
Changed the layout of the time-navigation links some.
Other minor bugfixes to the grapher and collector.
New features, fixes in version 0.54 (21-Dec-98):
Made collect-subtree work right when there are two or more
different users running it on the same machine. Also made
it scan logs for errors.
Made the collector more robust when making new RRD files.
It reports useful stats again (# targets, amount of wall
clock time).
Fixed a stupid bug in RPN.pm that made it impossible to
divide.
Made grapher.cgi work with installs where RRD.pm
needs to be installed in the local lib directory for
some reason. Fixed bug in graphParam. Layed out datasources
more nicely in HTML summary.
Made regexp-based instance mapping work. Included
an interesting example of how to use this feature.
See sample-config/Defaults, and search for ^map.
Added new switches subtree, which polls interesting things
from a switch. This is relatively untested -- we use it here,
but not in the exact form I am shipping. Please try it out
and give me feedback.
Resolved some questions in the docs.
Added a new file datasource type. See docs for more info.
New features, fixes in version 0.53 (10-Dec-98):
Fixed a bug in collector regarding creating new
RRD files with more than one DS. This bug has been in
since 0.50.
Worked on the documentation some more, including more
information about the graph dictionary.
New features, fixes in version 0.52 (10-Dec-98):
SMRTG is now named Cricket. The website changed.
There's a configure script that will take care
of you if your Perl is not where mine is.
Once RRD tool supports the -i (--interlaced) feature
(a patch has been sent to Tobias) you will be
able to use the "interlaced" attribute of the
"graph --default--" dictionary to control the
encoding of the GIF.
New features, fixes in version 0.51 (8-Dec-98):
fixes to the squid-proxy subtree (already!)
fixes to the http-performance tree
actually implemented locking in collect-subtrees
grapher.cgi:
new feature lets you set the upper and lower bounds
on graphs which have occasional spikes that you don't
want to see. Set "y-max" to (for example) 3.0 to
trim peaks higher than 3.0. Setting y-max or
y-min will disable auto-scaling, so only use it when
you mean it!
New features, fixes in version 0.50 (4-Dec-98):
sample-config:
squid-proxy subtree added
all RRD users converted to use RRD module instead of talking
over pipe.
more complete documentation
New features, fixes in version 0.49 (21-Nov-98):
sample-config
lots of things added to show off various features
grapher.cgi:
new 'precision' attribute of graph dictionary lets you
control the precision of the HTML summary for that
datasource. Set it to "integer" for things which should
be rounded to the nearest integer (like the number of
modems in use).
new "space" tag in graph dict that will let you
override the space printed before units. (Useful
for things like the degree mark.)
case-sensitivity bugfixes related to datasource
descriptions.
New features, fixes in version 0.48 (12-Nov-98):