RHEL5

Setup your collectors!¶

Epoch collectors can be run in both containerized as well as non-containerized environments. Only one collector is needed per host (VM or bare metal OS). Please follow the environment specific installation instructions below.

About¶

If you are viewing this documentation outside of the Epoch AOC, you may need to fill in untemplated variables in some of the steps below.
If you are running behind a load balancer, you will need to use the private IP address instead of the hostname ${host}.

Installation¶

This section provides instructions for manual installation of the collectors.

Run the commands below as a root user.

Setup¶

  # Download the collectors with the command
  wget -q -O \
      epoch-collectors.rpm \
      https://repo.epoch.nutanix.com/stable/epoch-collectors-rhel-5-x64.rpm

  # Install the collectors
  rpm -i -U --replacefiles --replacepkgs epoch-collectors.rpm

Configuration¶

Next, configure your collectors

EPOCH_ROLE=infra_only EPOCH_AUTOUPGRADE_COLLECTORS=no EPOCH_AOC_HOST=${your_epoch_host} EPOCH_ORGANIZATION_ID=${organizationId} EPOCH_INTERFACE=any EPOCH_ANALYSIS_DEPTH=layer4 EPOCH_L7_SAMPLINGRATE=20  /opt/nutanix/epoch/collectors/configure.sh

Note that the role is set to infra_only and collector autoupgrade is turned off. The default sp_collector role and collector autoupgrade are not yet supported, so please leave them disabled if you modify the configuration.

If you wish to collect layer 4 or layer 7 metrics as well, you may set EPOCH_ROLE to collector instead. Please refer the standalone stream processor section for more information.

Usage¶

Finally, start the collectors with

  /etc/init.d/epoch-collectors start

Tagging¶

Tagging the collectors is highly recommended in non-containerized environments. Tags help identify and group hosts in meaningful ways, e.g. Staging vs Production, DB vs Load Balancer vs App VM's etc. Refer Tagging Infrastructure

Configuration¶

To reconfigure the collectors, first, stop the collectors. Then, re-run the configure.sh script with the variables you wish to update and restart the collectors. An example is given below:

# First, stop the collectors
/etc/init.d/epoch-collectors stop

# Then, reconfigure
EPOCH_AOC_HOST=${your_epoch_host} /opt/nutanix/epoch/collectors/configure.sh

# Now, restart the collectors
/etc/init.d/epoch-collectors restart

Refer to the configuration section for a list of the other parameters you can configure. /etc/init.d/epoch-collectors stop

Installing Integrations¶

Creating the Config File¶

Create the necessary yaml config file in the /etc/nutanix/epoch-dd-agent/conf.d directory of your collectors.

You can use the Configuration section from the instructions page for your integration as reference for the name and contents of the config file.

Checking Configuration¶

Check to make sure that all yaml files are valid with the following command:

/etc/init.d/epoch-collectors configcheck

Running the Integration¶

Enable the integration by restarting the collector as follows:

/etc/init.d/epoch-collectors restart

Checking Runtime¶

Check to make sure that the integration is working with following command:

/etc/init.d/epoch-collectors info

The output of the info command should contain a section similar to the following:

    Checks
    ======
      [...]
      <name-of-integration>
      ----------
          - instance #0 [OK]
          - Collected 8 metrics & 0 events

Reporting Troubleshooting Information¶

If you are having issues with your collectors, you can run an inspect command which will gather troubleshooting information about the collectors, as well as any necessary logs.

Generate the tar file.
```
/etc/init.d/epoch-collectors inspect
```
The tar file is created in the /tmp directory, and the file name begins with epoch-collectors-inspection.
Send the tar file to Epoch support through email at epoch-support@nutanix.com.

Upgrade¶

Currently, upgrade consists of collector reinstallation.

First, stop the collectors

    /etc/init.d/epoch-collectors stop

Then, uninstall them

    yum remove epoch-collectors

Next, download the new collector package

    wget -q -O \
        epoch-collectors.rpm \
        https://repo.epoch.nutanix.com/stable/epoch-collectors-rhel-5-x64.rpm

Now, follow the post-setup installation instructions in the section above.

Finally, start up the collectors again

    /etc/init.d/epoch-collectors start

Uninstallation¶

Please uninstall the collectors with

    yum remove epoch-collectors