EV Observe - Use Global-SNMP-Operation Service Template

Last modified on 2023/06/23 16:43

The Global-SNMP-Operation service template uses the generic plugin, check_snmp_operation, to display two values or perform mathematical operations using multiple OIDs in order to return one or two results. A notification will be triggered when the result of the first calculation exceeds a specified threshold.

For each calculation, performance data can be generated to create a chart.

     Open url.png See the service template catalog

Customers can use the generic plugin to create their own service templates for monitoring any element referenced in the host MIB, e.g. RAM usage, CPU usage, bandwidth or temperature, etc.

Example

Monitoring and analysis of disk space usage for an ExaGrid appliance

  • Based on the host MIB, there are two storage spaces. Values are in MB.
  • A calculation using OID values is run to obtain the usage of disk space 1 as a percentage and in GB.
    • Disk space 1 usage as a percentage: (Space1Configured – Space1Available) / Space1Configured * 100

      example  (.1.3.6.1.4.1.14941.4.1.1 – .1.3.6.1.4.1.14941.4.1.3) / .1.3.6.1.4.1.14941.4.1.1 * 100

    • Disk space 1 usage in GB: (Space1Configured – Space1Available) / 1024

      example  (.1.3.6.1.4.1.14941.4.1.1 – .1.3.6.1.4.1.14941.4.1.3) /1024

Best Practice

  • To query a host using its OID and compare its value with warning and critical thresholds, you should use the GLOBAL-SNMP-OID service template.

Screen description

        Global-SNMP-Operation.png

     Open url.png See the Description of fields common to all service templates

Command: The check_snmp_operation command run by the services created using the service template.

  • Once the command is selected, the fields specific to the command, as shown below, will appear.

SNMP Community / SNMP Version / SNMP Port: Information on the version of the SNMP protocol used by the service template.

OID List: List of OIDs used in the calculation.

  • Use a semicolon to separate the different OIDs (;).

example  OID1;OID2;....;OIDn

Formula: Operations to be performed on the OIDs.

  • Use the pipe symbol | to separate operations.

Best Practice icon.png  

  • If you do not need to perform two operations, you are not required to specify the second formula.
  • To return raw values obtained from OIDs without running any calculation, specify only the name of the OIDs.

example OID1|OID2 ==> Returns the values of OID1 and OID2

Warning threshold / Critical threshold: Thresholds used for comparing values and triggering notifications if exceeded.

   Only the result of the first operation will be compared with the thresholds.

Output format and performance data: Instruction made up of two parts separated by the pipe symbol  |.

  • The first part is used to:
    • Define the text to be displayed in the Details form in Monitoring.
    • Indicate the unit of the result from the first calculation.
    • (optional) Indicate the unit of the result from the second calculation, if required.

example  Used space;%;GB

  • The second part is used to define the name of the performance data generated by the plugin.
    • One chart is created for each performance data specified.
    • Use the semicolon (;) to separate each performance data.

example  used_prct;used_GB ==> Create two performance data used_prct and used_GB

Best Practice icon.png  Specify this part only if you want to display charts.

Default value: Value returned by the plugin when the result of the calculation leads to a division by zero.

  • If there is a division by zero and no default value is defined, the plugin will return an error.

Procedures

How to create a service template using the generic plugin, check_snmp_operation

SelectCompanyInCompanyTree_Procedure

1. Go to the Web app.

2. Select the company from the company tree structure.

Notes:

  • The selected company must be associated with a Box.
  • You can create a new company. Open url.png See the procedure

    Company tree structure.png

3. Create a new service template.

  • Select Configuration > Services > Templates.
  • Click + Add in the Mode: Box tab. 

4. Specify the information on the service template.

     Open url.png See:

5. Click Apply.

The service template will be created.

  • It will be visible to the company and all lower-level sites.
  • It can be used to deploy new services.

How to use a service template built using the plugin, check_snmp_operation

SelectCompanyInCompanyTree_Procedure

1. Go to the Web app.

2. Select the company from the company tree structure.

Notes:

  • The selected company must be associated with a Box.
  • You can create a new company. Open url.png See the procedure

    Company tree structure.png

3. Create a new service.

  • Select Configuration > Services > List in the menu.
  • Click + Add in the Mode: Box tab. 

4. Specify the information below.

General information tab
    Global-SNMP-Operation configuration.png

  • Service template: Select the custom service template built using the plugin, check_snmp_operation.
  • Name: Enter the name of the new service to be created. Its name should correspond to the event to be captured.

example  Exagrid-Space-1

Availability and checks tab
      GLOBAL-SNMP-OID configuration - Availability and checks tab.png

  • Specify the information specific to the service template.

     Open url.png See the description of information
 

Relations tab
      Global-SNMP-Operation configuration - Relations tab.png

  • Select the host to be monitored.

5. Click Apply.

6. Generate the Box configuration to ensure that the new service is taken into account. You can do this in the Configuration > General > Loading menu.

You can view the two performance data metrics in the Details form of the host. To do so, select Monitoring > Monitoring in the menu.

        Global-SNMP-Operation - Result metric host.png

Tags:
Powered by XWiki © EasyVista 2022