NetApp E/EF-Series Monitoring

Overview

LogicMonitor’s NetApp E/EF-Series package ​monitors E and EF series storage arrays using SANtricity Web Services. It collects metrics for hardware health, performance, and space usage.

Technology notes:

• The package uses the Web Services API for data collection. For API documentation, see SANtricity® Web Services API Technical Report.
• The package works with the embedded Web Services server or the Web Services Proxy (recommended). For proxy documentation, see SANtricity® Web Services Proxy 3.1 User Guide.
• The SANtricity Web Services Proxy supports role-based user access starting with the version 3.0 release.

Compatibility

As of January 2020, this package is compatible with all current E/EF-series devices. An embedded Web Services API server is available on the following devices:

• E2800/EF280 running NetApp SANtricity 11.30 or later
• E5700/EF570 running SANtricity 11.40 or later versions
• EF600 running SANtricity 11.60 or later versions

In general, it is recommended that you use the Web Services Proxy (WSP) for networks with more than 10 storage systems. The proxy can handle numerous requests more efficiently than the embedded server.

Setup Requirements

As discussed in the following sections, several steps must be taken in order to set up monitoring of NetAPP E/EF-Series devices, including the installation of SANtricity Web Services Proxy.

Add Resources Into Monitoring

Add your NetAPP E/EF-Series devices into monitoring. For more information on adding resources into monitoring, see Adding Devices.

Obtain Credentials

​LogicMonitor must provide the appropriate credentials in order to successfully access the NetApp resource data. These credentials must belong to a SANtricity Web Services API user account that has been assigned the following minimum permissions:

The predefined users “ro” and “monitor” are assigned the storage.monitor role; both accounts are disabled until a password is set.

To create a new account, follow the instructions under the “Configuring the users.properties File” section of the Web Services Proxy User Guide.

Assign Properties to Resources

The following properties must be set on the NetApp E/EF-Series resource within LogicMonitor. For more information on assigning properties to resources, see Resource and Instance Properties.

Install and Configure SANtricity Web Services Proxy

1. Visit the SANtricity Web Services Proxy product page to download the SANtricity Web Services Proxy. For installation instructions, see the SANtricity Web Services Proxy Installing and Using guide.
2. Once you have the Web Services Proxy installed, verify that you can reach the REST API by loading the built-in documentation page:

   https:/[WSP IP or FQDN]:8443/devmgr/docs

3. Scroll down to the line labeled Storage-Systems and click Show/Hide.
4. Next, register your array(s) with the Web Services Proxy. You will need the IP addresses of your arrays (you only need one of the IPs for each). You can use the POST /storage-systems endpoint to do this conveniently from the built-in API documentation page, or with curl. You will need to pass a JSON object that looks like the following, of course, with the IP addresses changed to match your environment:

   {
     "controllerAddresses": [
       "10.0.0.31"
     ]
   }
   

   If you have a lot of arrays and need to automate this, here’s a curl snippet to get you started:

   URL="https://:/devmgr/v2/storage-systems"
   
   curl --request POST --cookie "cookies.txt" \
        --header "Accept: application/json" --header "Content-Type: application/json" \
        --data '{"controllerAddresses":["10.0.0.31, "10.0.0.32]} \
        --insecure $URL

5. If the response comes back okay, you can confirm your arrays have been registered by using the GET /storage-systems endpoint. Click the Try it out! button and you should see your arrays in the JSON results window.
6. The system.categories properties on your NetApp resources should include “SANtricityWebServices” as a value so that the DataSources are properly applied. This value will be assigned automatically via the PropertySource associated with this package, as long as the proper credentials are configured, or the default credentials are still valid.
7. You should now start seeing data for your NetApp E/EF-Series devices.

Troubleshooting

424/404 Return Codes

If you receive a 424 or 404 HTTP return code when clicking on Poll Now, it is likely that your device is not registered with the Web Services Proxy. This can be verified using the GET /storage-systems endpoint.

HTTP Client Protocol Exception

If you get a ClientProtocol Exception when testing the script from the DataSource definitions page, double check that the value of the netapp.rest.url property is correct. This error is usually due to a malformed URL, specifically when an HTTP URL is provided with an HTTPS port.
​

LogicModules in Package

​LogicMonitor’s package for NetApp E/EF-Series consists of the following LogicModules. For full coverage, please ensure that all of these LogicModules are imported into your LogicMonitor platform.

​When setting static datapoint thresholds on the various metrics tracked by this package, LogicMonitor follows the technology owner’s best practice KPI recommendations. If necessary, we encourage you to adjust these predefined thresholds to meet the unique needs of your environment. For more information on tuning datapoint thresholds, see Tuning Static Thresholds for Datapoints.