Skip to main content
HCI
1.10

Enable Active IQ and NetApp HCI monitoring

Contributors netapp-dbagwell netapp-pcarriga amgrissino

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.

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 that do not have external connectivity.

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. 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",
      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. 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:

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

Find more information