Icinga
Icinga is a monitoring system which checks the availability of your network resources, notifies users of outages, and generates performance data for reporting
How it works
You should install Harp agent on server which has access to your Icinga environment. Agent will pull active alerts from Icinga and forward them to Harp system
How to register new integration in Harp
Follow these steps to register a new integration in Harp Platform
How to configure in Icinga
Docker daemon should be installed and running on your server – https://docs.docker.com/engine/install/
Docker Compose should be installed – https://docs.docker.com/compose/install/
1. Run the agent using Docker Compose
curl -sSL https://raw.githubusercontent.com/the-harpia-io/harp-agent/master/docker-compose.yml > docker-compose.yml
curl -sSL https://raw.githubusercontent.com/the-harpia-io/harp-agent/master/config.yaml > config.yaml
2. Get API user and password
cat /etc/icinga2/conf.d/api-users.conf
/**
* The ApiUser objects are used for authentication against the API.
*/
object ApiUser "root" {
password = "a08101bfd30ae35d"
// client_cn = ""
permissions = [ "*" ]
}
3. Specify details about your Icinga instance in config.yaml which was downloaded
icinga:
- integration_name: "icinga_test"
url: <URL to Harp Endpoint>
user: "root"
password: "a08101bfd30ae35d"
Note: How to find URL to Harp Endpoint
4. Start agent
docker-compose up -d
5. Attache notification to scenario and environment
Add environment_id and scenario_id on integration level in config.yaml. All alerts from monitoring system will be attached to that Env and Scenario
icinga:
- integration_name: "icinga_test"
url: <URL to Harp Endpoint>
user: "root"
password: "a08101bfd30ae35d"
environment_id: 10
scenario_id: 20
Note: How to find URL to Harp Endpoint