Standard Install

This integration’s package (computed metrics, dashboards, and policies) is automatically enabled and provisioned to your account as soon as CloudWisdom receives data.

For users taking advantage of our Capacity Monitoring (or all) features, follow the steps below. For users using Cost Optimization features only, skip to the Cost Optimization Quick Setup section below.

  1. Copy Install Command from Linux Integration Setup Page

    1. From the left navigation menu, select Integrations.

    2. Select the Linux card. The name should be already populated, and Data Collection should be enabled.

    3. Highlight the one-line install command from the instructions and copy them. A unique API key for your account has already been generated and included in the command line.

      Linux Install Command

    If you’d prefer to specify the element name, copy the following instead:

    sudo N_APIKEY=your-apikey N_HOSTNAME=your-element-name bash -c "$(curl -Ls http://repos.app.netuitive.com/linux.sh)"
    

    your-apikey is the API key generated from the integration and your-element-name can be any element name you wish (it must be unique from your other elements).

    sudo N_APIKEY=your-apikey N_HOSTNAME_METHOD=hostname-method bash -c "$(curl -Ls http://repos.app.netuitive.com/linux.sh)"
    

    hostname-method can be a hostname method described on the Optional Config page.

  2. Install Linux Agent

    • Paste the command from step 1c into your command line. This installs the agent and adds your account’s unique API key to the configuration file.

      Tip

      If you install our Linux agent on an AWS EC2 or Azure VM, the EC2’s / VM’s power state (it will come in as the attribute hostRunning with a value of true or false) and tags are copied over to the corresponding Linux SERVER element. You can then use this information to create policies.

  3. Edit Linux Agent Config File

    1. Navigate to the Linux Agent configuration file found at /opt/netuitive-agent/conf/netuitive-agent.conf.

    2. Ensure the API key provided in step 1 is input in the netuitive-agent.conf file. The section below is only a portion of the config file. Go here to view the full config file.

      [[NetuitiveHandler]]
          ### CloudWisdom Cloud URL to post the metrics
          url = https://api.us.cloudwisdom.virtana.com/ingest/infrastructure
      
          ## CloudWisdom Datasource api key
          api_key = <datasource api key>
      
          ### Uncomment to add tags (optional)
          # tags = tag1:tag1val, tag2:tag2val
      
          ### Uncomment to add relations
          # relations = element1, element2
      
          # How many samples to store before sending to CloudWisdom
          batch = 100
      
          # how many batches to store before trimming
          max_backlog_multiplier = 5
      
          # Trim down how many batches
          trim_backlog_multiplier = 4
      
          # local statsd server
          [[[statsd]]]
          enabled = False
      
    3. Save the configuration file.

    4. Restart the Linux Agent service to begin monitoring your data with CloudWisdom.

Config Options

  • Option 1: Substitute tags value with desired tags and uncomment the line to pass in tags for your element.

  • Option 2: Substitute relations value with desired element relationships; must include the fully qualified name of the elements. Uncomment the line to pass in relationships for your element.

  • Option 3: Adjust default collectors (CPU, DiskSpace, DiskUsage, Heartbeat, LoadAverage, Memory, VMStat, Network) using the configuration options found here.

Cost Optimization Quick Setup

Customers using only Cost Optimization features, such as the Right Sizing reports, can install the Linux Agent with just one quick command! This method enables the Linux Agent’s Simple Collector.

Tip

Remember to update your Linux Agent config file if you start using CloudWisdom's Capacity Monitoring tools.

  1. Navigate to your Linux Agent integration in CloudWisdom.

  2. Copy the Installation Script.

    copy-script
  3. Open your command prompt.

  4. Run the script. It should look like this: sudo N_APIKEY=your-api-key N_USE_SIMPLE_COLLECTOR=true bash -c "$(curl -Ls http://repos.app.netuitive.com/linux.sh)".

  5. Done!

Enable/Disable

The PACKAGES toggle on the Linux Integration page becomes active once data is received. You are able to disable and re-enable the package at will. Disabling the packages deletes respective dashboard, policies, as well as discontinues computed metric computation.