Configuring Data Collectors Edit on GitHub Request doc changes

Contributors netapp-alavoie dgracenetapp

You configure Data Collectors in your Cloud Insights environment to collect data from hosts, services, or devices in the data center.

Before you begin
  • You must have Account owner or Admin privileges to configure data collectors.

  • You must have configured an Acquisition Unit (for Infrastructre) or an Agent (for Services or Hosts) before you can start collecting data.

  • You need credentials for the infrastructure devices from which you are collecting data.

    Device network addresses, account information, and passwords are required for all devices from which you wish to collect data.

Credential Security

Data collector credentials are encrypted when entered in Cloud Insights, and are sent to the Acquisition Unit (AU) encrypted first by the public key of the AU, and then encrypted over HTTPS. Encrypted values are decrypted when the AU uses them to communicate with devices & software.

Configuring the Data Collector

  • From the Cloud Insights menu, click Admin > Data Collectors and click the + Data Collector button. You can choose to show all data collectors, or filter to show only the data collectors available to you based on your subscription.

    The system displays the data collectors arranged in three categories—​Operating Systems, Services, and Infrastructure—​alphabetically by vendor.

  • Depending on the data collector category you choose, installation steps will vary.

Operating Systems:

You must install at least one Cloud Insights Agent to begin collecting Operating System or Service data from your environment. You can install as many agents as you wish. Each agent can collect data from multiple Services.

In addition to collecting data from Services, each agent also acts as a data collector for the VM/host on which it is installed. The data collected is presented as "Node" data in dashboard widgets or queries.

  1. Click on the platform type of the VM or host (i.e. the Node) from which you access Cloud Insights.

  2. Choose an Agent Access Key.

  3. Copy the displayed command to the clipboard. You can click the clipboard icon to quickly copy the command.

  4. Open a terminal/command window on the agent VM/host and paste the command. Press Enter to execute the command.

  5. After the agent is installed, click Finish. The agent begins collecting data.

    It may take up to two poll periods before data for the Node is displayed in dashboards or available for querying.

Services:

Before you begin
  • You must have at least one Cloud Insights Agent to collect Service data from your environment. If you do not have an agent installed, you will be prompted to install one when you configure a Service data collector.

  • The Service from which you wish to collect data must be installed and running in your environment.

    1. Click on a Services data collector.

    2. Choose an agent operating system or platform. If you have not installed an agent for the platform, follow the instructions to do so.

    3. Choose an Agent Access Key.

    4. Click Continue.

    5. Follow the instructions for configuring the data collector. You can click the clipboard icon to quickly copy the commands or code snippets displayed.

    6. Once the data collector is configured properly, click Finish.

      It may take up to two poll periods before data from the service is displayed in dashboards or available for querying.

Infrastructure:

Before you begin
  • You must have at least one Acquisition Unit configured to begin collecting Infrastructure data.

    1. Click on an Infrastructure data collector.

    2. Enter a name for the data collector. Names can contain the following characters:

  • letter (a-z)

  • number (0-9)

  • hyphen (-)

  • underscore (_)

  • period (.)

  • space ( )

    Names may not begin or end with a space, period, or hyphen.

    1. Enter the Acquisition Unit to associate with this data collector.

    2. Enter the required fields in the Configuration screen.

    3. Click Advanced Configuration to enter additional configuration fields. Not all data collectors require advanced configuration.

    4. Click Test Configuration to verify that the data collector is properly configured.

    5. When finished, click Add Collector.

For help adding a new Acquisition Unit, see Configuring acquisition units

+ It may take up to two poll periods before data from the environment is displayed in dashboards or available for querying.