English

Enable Active IQ and NetApp HCI monitoring

Contributors netapp-dbagwell netapp-mwallis Download PDF of this page

You can enable Active IQ storage monitoring (for SolidFire all-flash storage and NetApp HCI) and NetApp HCI compute monitoring (for NetApp HCI only) if you did not already do so during installation or upgrade. You might need to use this procedure if you disabled telemetry using the NetApp HCI Deployment Engine or did not set up SolidFire Active IQ during installation for a SolidFire all-flash storage system.

The Active IQ collector service forwards configuration data and Element software-based cluster performance metrics to NetApp Active IQ for historical reporting and near real-time performance monitoring. The NetApp HCI monitoring service enables forwarding of storage cluster faults to vCenter for alert notification.

Before you begin
  • Your storage cluster is running NetApp Element software 11.3 or later.

  • You have deployed a management node running version 11.3 or later.

  • You have internet access. The Active IQ collector service cannot be used from dark sites.

Steps
  1. Get the base asset ID for the installation:

    1. Open the inventory service REST API UI on the management node:

      https://[management node IP]/inventory/1/
    2. Click Authorize and complete the following:

      1. Enter the cluster user name and password.

      2. Enter the client ID as mnode-client.

      3. Click Authorize to begin a session.

      4. Close the window.

    3. From the REST API UI, click GET ​/installations.

    4. Click Try it out.

    5. Click Execute.

    6. From the code 200 response body, copy the id for the installation.

      {
        "installations": [
          {
            "_links": {
              "collection": "https://10.111.211.111/inventory/1/installations",
              "self": "https://10.111.217.111/inventory/1/installations/abcd01e2-ab00-1xxx-91ee-12f111xxc7x0x"
            },
            "id": "abcd01e2-ab00-1xxx-91ee-12f111xxc7x0x",
      Your installation has a base asset configuration that was created during installation or upgrade.
  2. Activate telemetry:

    1. Access the mnode service API UI on the management node by entering the management node IP address followed by /mnode:

      https://[management node IP]/mnode
    2. Click Authorize or any lock icon and complete the following:

      1. Enter the cluster user name and password.

      2. Enter the client ID as mnode-client.

      3. Click Authorize to begin a session.

      4. Close the window.

    3. Configure the base asset:

      1. Click PUT /assets/{asset_id}.

      2. Click Try it out.

      3. Enter the following in the JSON payload:

        {
        "telemetry_active": true
        "config": {}
        }
      4. Enter the base ID from the previous step in asset_ID.

      5. Click Execute.

        The Active IQ service is automatically restarted whenever assets are changed. Modifying assets results in a short delay before settings are applied.

  3. If you have not already done so, add a vCenter controller asset for NetApp HCI monitoring (NetApp HCI installations only) and Hybrid Cloud Control (for all installations) to the management node known assets:

    A controller asset is required for NetApp HCI monitoring services.
    1. Click POST /assets/{asset_id}/controllers to add a controller sub-asset.

    2. Click Try it out.

    3. Enter the parent base asset ID you copied to your clipboard in the asset_id field.

    4. Enter the required payload values with type as vCenter and vCenter credentials.

      {
      "username": "string",
      "password": "string",
      "ip": "string",
      "type": "vCenter",
      "host_name": "string",
      "config": {}
      }
      ip is the vCenter IP address.
    5. Click Execute.

Find more information