Administer > Integrate NNMi Elsewhere with URLs > Launch Menu Items > Actions: Line Graph (showLineGraph)

Launch the Actions: Line Graph (showLineGraph)

Use the showLineGraph URL to launch a Line Graph that displays real-time SNMP data about a selected object. See Configure SNMP Line Graph Actions.

Note If you are displaying graphs for NNMi objects, the node or interface for which you want to graph information must support SNMPv1, SNMPv2c, or SNMPv3.

Use the showLineGraph syntax in a URL when you want to do any of the following:

  • Display a Line Graph in an application other than NNMi.
  • Display a Line Graph outside of an application and add it to your Favorites browser list.

To launch a Line Graph with the showLineGraph syntax, use the following URL:

Note If you copy/paste this URL, remove the spaces that were added for line-ending purposes in the documentation.

http://<serverName>:<portNumber>/nnm/launch?cmd=showLineGraph [parameter list]

http://<serverName>:<portNumber>/nnm/launch?cmd=showLineGraph &init=<x>&objtype=<x> &maxlines=<x> &maxtimerange=<x> &defaultsecs= <x>&faststart=<true/false>

Note If the NNMi Web server uses the https protocol, use https instead of http.

<serverName> = the fully-qualified domain name of the NNMi management server (values allowed here are determined by the Enable URL Redirect setting in User Interface Configuration, see Configure the NNMi User Interface)

<portNumber> = the NNMi HTTP port number

For a quick-reference list of all URL choices for launching NNMi, see HelpDocumentation LibraryIntegrate NNMi Elsewhere with URLs. The Integrate NNMi Elsewhere with URLs page also contains a link to a list of sample URLs that you can copy/paste as a starting point.

Line Graph Parameters
Parameter Description
&init

Use  to define the lines you want displayed in the graph:

  • instancelist - Use to specify which instances of the SNMP MIB object to display.
  • One of the following for each line:

    • oid - Use to specify the SNMP MIB object identifier value of each instance.
    • expr - Use to specify the name of a MIB Expression that will be used for gathering the values on the Line Graph.
  • label - Use to specify the label to be used in the legend that describes each line on the graph.
&objtype

Use to specify the Object Type.

For a Node Object Type, this value must be ${snmpAgent.id}. For an Interface Object Type, this value must be ${hostedOn.snmpAgent.id}

Note If you want to provide a Line Graph for a specified node, use the ID value for the node's SNMP Agent. NNMi displays the ID attribute value on the SNMP Agent form's Registration tab.

&maxlines Use to specify the number of lines that NNMi should initially display on the Line Graph. To use the default value specified in the User Interface Configuration, omit this parameter.
&maxtimerange

Use to specify the number of hours for the Maximum Time Range in which the data in the Line Graph should be retained. After the Maximum Time Range number is reached, NNMi discards the oldest data point sets so that it can display the most recent data for the time range specified.

&defaultsecs Use to specify the Polling Interval in which the graph data should be collected. To use the default value specified in the User Interface Configuration, omit this parameter.
&faststart

Use to specify whether to increase the initial Polling Interval so that the initial data appears more quickly on the graph. Possible values are true or false.

When you specify true for this option, NNMi increases the initial Polling Interval and then gradually decreases the Polling Interval until it reaches the Polling Interval configured for the graph.

When you specify false, NNMi uses the Polling Interval set for the graph.

&defaultfixedvertical

Used to specify whether to lock the Y-axis. Possible values are true or false.

When you specify true, the Y-axis remains fixed at the minimum and maximum values for the current set of data regardless of the time segment selected. This means NNMi does not automatically re-adjust the Y-axis to match the data values for the selected time segment.

When you specify false, NNMi automatically adjusts the Y-axis to match the data values for the selected time segment.

&ylabel Use to specify the label to be used for the Y-axis of the Line Graph.
more... Network Node Manager i Software Smart Plug-ins (iSPIs) might provide more attributes to customize the line graph. See the documentation for the NNM iSPIs installed in your network environment.