11.4 Direct opening of a measurement pageThe PVSR interface allows that at startup a site or device is immediately opened under the Measurements main menu independently what the user has configured as the starting page in his preferences. Accordingly, the PVSR system can easily be connectable to other systems (i.e. recording system). The URL that corresponds to the currently displayed object can be revealed and consequently copied by clicking on the Link button on the right hand side of the alarms panel, therefore making the manual assembly of the URL according to the following set of rules avoidable. This functionality can be accessed with two different types of arguments, in both cases the PVSR interface has to be started with the http://PVSR_SERVER/cgi-bin/link.pl?view=MM&other_parameter URL (in case the system is on the port 80 of PVSR server’s WEB server):
o S: site o G: virtual site o E: device o R: virtual device o F: traffic measurement o O: other measurement
o type: the type of the object. The short forms mentioned above can be used or one of the longer names: site, virtual_site, equip, virtual_equip, traffic, measurement. o name: the name of the object
o type: it has to be equip or E o search_for: its value is either ip_address or a collector specific parameter name, for example “ORA EQ 1 CONN” for the Oracle connection parameter. The available parameter names are documented in the collector specific section of 14.1 Specifics of measurement server types o name: value of the parameter
o meas_type: either F for traffic measurement or Otype, where type must be replaced with the measurement type (for example UPT for SNMP uptime measurement) o meas_index: value of the measurement’s Index parameter o meas_name: name of the measurement The advantage of the first and the fourth method is that it identifies the element unambiguously since for the first case the inner identifier does not change and uniquely identifies the object and for the fourth the equipment name – measurement type – measurement index triplet is also unique. The other methods do not guarantee unique identification (i.e. one measurement name can occur more than once) but its usage is much easier. The inner identifiers’ of objects can be seen by the admin users: in case of measurements at the configuration panel of the device, in case of site or device at the appropriate link on their configuration page. If the specified object is a measurement or a chart then PVSR can be instructed to show an image with the measurement’s values instead of opening the PVSR UI. To do the show_image_chart parameter with the value 1 must be added to the URL. This will show the chart for the last two hours (120 minutes). The interval can be changed with the chart_sample parameter (default 120). The width and height of the chart can be changed by the parameters chart_xsize (default 300) and chart_ysize (default 120). The minimum and maximum values can be defined with the chart_min and chart_max parameters (no default values). Additonaly the user_name and user_pwd parameters might be provided, in which case the login procedure is done immediately. The following options are simil to the show_image_chart parameter in the sense that they result in a chart, but unlike the show_image_chart their result is a small HTML page with an interactive JavaScript chart: · show_js_chart: results in a Javascript chart The link parameters with the exceptions of XSIZE, YSIZE, ALLOW_YSIZE_GROWTH, bg_color and hide_menus are the same as in a normal chart link URL: · TO and FROM: in the form of YYYY.MM.DD. HH:MM:SS If they are not both present then the result will be a chart showing the last coupe of hours · BUSINESS_HOURS: id of the business hours · PEAK: a one character value: Y for Yes, N for No and D for default · FLASH_AUTO_KMGT: either Y for automatically scaled Y axis or N · STEPMOD: a one character value: S for small, M for medium and L for large resolution · MINVAL: minimum value on the chart, for example 10K · MAXVAL: maximum value on the chart, for example 12.3M The XSIZE and YSIZE are the sizes of the HTML page in pixels, by default 450 and 270. If PVSR determines that it needs additional height then it will automatically increase the value of YSIZE unless the ALLOW_YSIZE_GROWTH parameter is set to N. Similarly to show_image_chart the URL might contain the parameters user_name and user_pwd. The bg_color can have a value in the format of RRGGBB and so the user can change the background of the small generated HTML page. If the user specifies the hide_menus=1 parameter and value as well then the interactive menus will be hidden on the chart. Examples for the two different methods (assuming that the PVSR runs on port 80 of the PVSR server):
|