Skip to main content
A newer release of this product is available.

Enable Active IQ and NetApp HCI monitoring

Contributors netapp-pcarriga

You can enable Active IQ storage monitoring for NetApp HCI and NetApp HCI compute monitoring 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.

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.

What you'll need
  • 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://<ManagementNodeIP>/inventory/1/
    2. Select Authorize and complete the following:

      1. Enter the cluster user name and password.

      2. Enter the client ID as mnode-client.

      3. Select Authorize to begin a session.

      4. Close the window.

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

    4. Select Try it out.

    5. Select 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",
      Note 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://<ManagementNodeIP>/mnode
    2. Select 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. Select Authorize to begin a session.

      4. Close the window.

    3. Configure the base asset:

      1. Select PUT /assets/{asset_id}.

      2. Select 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. Select 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:

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

    2. Select 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": {}
      }
      Note ip is the vCenter IP address.
    5. Select Execute.

Find more information