# ilagent

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](/developer-docs/client-libraries/ilagent/edge-connector.md)
* [Send events and heartbeats from the command line](/developer-docs/client-libraries/ilagent/cli.md)
* [Run a local HTTP proxy server with a retry queue for events and heartbeats](/developer-docs/client-libraries/ilagent/cli.md#http-proxy)
* [Consume and forward MQTT messages to ilert](/developer-docs/client-libraries/ilagent/mqtt.md)
* [Consume and forward Apache Kafka messages to ilert](/developer-docs/client-libraries/ilagent/kafka.md)
* [Map and filter consumer messages to ilert events](/developer-docs/client-libraries/ilagent/event-mapping.md)
* [Sync escalation policy levels from external systems](/developer-docs/client-libraries/ilagent/escalation-policies.md)

## Installing

### Docker

```sh
docker run ilert/ilagent --help
```

### Compile from source

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

```sh
git clone git@github.com:iLert/ilagent.git
cd ilagent
cargo build --release
./target/release/ilagent --help
```

### Install script (macOS / Linux)

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

Pre-compiled binaries are available on the [releases page](https://github.com/iLert/ilagent/releases).

## Quick reference

* The proxy exposes the same API as `https://api.ilert.com/api` — see the [API docs](https://api.ilert.com/api-docs/#tag/Events)
* 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>

{% hint style="info" %}
Missing a feature? Let us [know](https://github.com/iLert/docs/blob/master/developer-docs/contact.md)
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ilert.com/developer-docs/client-libraries/ilagent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.