Prerequisite
Information and Items needed:
- Extrahop server url
- API Key for Extrahop
- List of server IPs to be monitored
- Optional: Device ID for servers as well, if wanting exact match with device ID and avoid issues with layers
- Python 3.6.8 and Pip3
- Freetds library
- InsightFinder Extrahop Agent
Project Creation
- Go to “Settings” -> “System Settings”. Click on “Add New Project”. (See Figure 1)
- Select “Metric Monitoring” and then “Extrahop” from the list. (See Figure 2)
- All the fields are pre-populated and can be left as default.
- Set “Project Name” to the desired project name and enter the “System Name” for the System that should host the project, and click “Finish”. (See Figure 3)
- Once a project is successfully created, you will be redirected to the settings page for the project, and should be good to use the project now
Agent Installation
- Required Dependencies:
- Python == 3.6.8
- Pip3
- Freetds library
- Install the freetds
- osx: brew install freetds
- linux: yum install freetds
- Download the extrahop.tar.gz from this link (link: https://github.com/insightfinder/InsightAgent/tree/master/extrahop)
- Copy and extract the agent package to the machine that will be running the agent
- Navigate to extracted location and folder, and configure venv and python dependencies
- ./setup/configure_python.sh
- The configure_python.sh script will generate a config.ini file; however, if need to create a new one, simply copy the config.ini.template file over the config.ini file to start over, or update the new generated config.ini file in ./conf.d folder
Agent Setup
- Requirements:
- Extrahop server url
- API Key for Extrahop
- List of server IPs to be monitored
- Optional: Device ID for servers as well, if wanting exact match with device ID and avoid issues with layers
- Enter the extrahop details (See Figure 4)
- Enter the user and project details (See Figure 5)
- Test the Agent:
- ./setup/test_agent.sh
- Once the setup is complete, run the agent using th command:
- nohup venv/bin/python3 cron.py &
More Information about the agent and setup can be found at https://github.com/insightfinder/InsightAgent/tree/master/extrahop