ilagent

ilagent is a lightweight program that lets you easily integrate your on-premise systems with ilert.

ilagent comes as a single binary with a small footprint and is available for all major platforms. We also provide an official Docker image.

Features

• Pull and deliver alert action events to local targets
• Send events and heartbeats from the command line
• Run a local HTTP proxy server with a retry queue for events and heartbeats
• Consume and forward MQTT messages to ilert
• Consume and forward Apache Kafka messages to ilert
• Map, enrich, and filter consumer messages to ilert events
• Sync escalation policy levels from external systems

Installing

Docker

docker run ilert/ilagent --help

Compile from source

Requires Rust to be installed, see https://rustup.rs

git clone [e-mail]:iLert/ilagent.git
cd ilagent
cargo build --release
./target/release/ilagent --help

Install script (macOS / Linux)

curl -sL https://raw.githubusercontent.com/iLert/ilagent/master/install.sh | bash -

Pre-compiled binaries are available on the releases page.

Quick reference

• The proxy exposes the same API as https://api.ilert.com/api — see the API docs
• In daemon mode, provide -b il1hbt123... to monitor ilagent's uptime via heartbeats
• Adjust the log level with multiple -v flags (default: error, -v warn, -v -v info)
• ilagent buffers events locally using SQLite3 (except in Kafka mode) and requires file system access in daemon mode

Source code

The ilagent source code is open source and managed on GitHub: https://github.com/iLert/ilagent

Missing a feature? Let us know