deekayen.alagent

Ansible Role: alagent

This playbook installs and configures the Alert Logic agent.

It is based on an old, now inactive project originally supported by Alert Logic. The change was made to fix issues with GPG checks causing failed installations.

Requirements

Supported platforms:

Debian versions:

buster
bullseye

Ubuntu versions:

22.04
20.04

RHEL/CentOS versions:

Amazon Linux version:

Karoo

Windows versions:

Windows Server 2016, 2019

Role Variables

al_agent_registration_key: Your unique registration key. This is required unless you're using supported cloud platforms (AWS, Azure). Default value is your_registration_key_here.
al_agent_for_imaging: This variable controls if the agent will be configured and set up. If it’s set to true, the agent installs but doesn't start, allowing you to save instance snapshots. If set to false, the agent installs and starts immediately. Default is false.
al_agent_egress_host, al_agent_egress_port: By default, all traffic goes to https://vaporator.alertlogic.com. This variable is for machines handling outbound traffic (like a NAT box). If you provide a different URL, ensure it's correctly formatted. Default is https://vaporator.alertlogic.com.
al_agent_proxy_url: The al-agent usually doesn’t need a proxy. If you want to use one, you need to provide both al_agent_egress_host and al_agent_proxy_url. Ensure the proxy URL is correctly formatted. Default is nil.

Dependencies

No known dependencies.

Example Playbook

---
- name: Install AL Agent on specific hosts
  hosts: al_agents
  roles:
    - { role: deekayen.alagent }

Configurations

The variable al_agent_for_imaging determines your installation type. It's a boolean that defaults to false. Setting it to true prepares the agent for imaging only, without provisioning it.

Using the default attributes will set up and start the agent immediately. If you set your registration key correctly, your host should show up in Alert Logic's Console within 15 minutes. Note: For AWS and Azure, using the key is generally optional.