Automate Alert Logic Agent Installation with AWS Systems Manager Distributor
Alert Logic provides an agent that gathers data that Alert Logic must collect for analysis, such as log messages and network traffic, metadata, and host identification information.
If you have Amazon Web Services (AWS) Systems Manager managed instances, you can use AWS Systems Manager Distributor to install the Alert Logic agent on the instances. Distributor is a feature integrated with AWS Systems Manager that you can use to securely store and distribute software packages in your accounts. By integrating with Distributor, you can install the Alert Logic agent across multiple platforms to secure all your managed instances and keep the agent up to date automatically.
To automate agent installation with Distributor, complete this process in AWS and the Alert Logic console:
- Prepare to install the Alert Logic agent
- Create an IAM policy by importing a managed policy
- Create a role and assign the policy
- Schedule agent installation in Distributor
- Verify agent installation
Supported subscription types
- Alert Logic MDR Professional
- Alert Logic MDR Enterprise
Prepare to install the Alert Logic agent
Before you install the agent with Distributor:
- Ensure the managed instances meet the minimum system requirements listed in Requirements for the Alert Logic Agent.
- Ensure you have firewall rules in place:
- US: Agent or remote collector outbound rules
- EU/UK: Agent or remote collector outbound rules<![CDATA[ ]]>
Create an IAM policy by importing a managed policy
Each host that you want Distributor to install an agent on must be set up as an AWS Systems Manager managed instance. The first step is to create an IAM policy with the correct permissions in the AWS console.
Follow the instructions in the AWS document Importing existing managed policies.
In the Import managed policies window, add the AmazonSSMManagedInstanceCore policy.
Create a role and assign the policy
The next step for setting up each host as an AWS Systems Manager managed instance is to create an IAM role and assign the policy you just created.
Follow the instructions in the AWS document Creating a role for an AWS service.
In the Attach permissions policies window, add the AmazonSSMManagedInstanceCore permission.
Schedule agent installation in Distributor
- In the AWS console, go to AWS Systems Manager.
- In the navigation pane on the left, under Node Management, click Distributor.
- Find and select the AlertLogic-MDR package, and then click Install on a schedule.
- In the Create Association page that opens, fill in the required fields. For Installation Type, Alert Logic recommends the In-place update option.
- Create a schedule. Using a scheduled State Manager Association ensures agents are always installed and up to date.
- Click Create Association.
Verify agent installation
- In the Alert Logic console, click the menu icon ().
- Click Respond, and then click Health.
- Select the Unhealthy list, and then select the Hosts with No Agent view.
- Check that no hosts in your deployments appear in the list.
Agent registration can take several minutes.
If you waited several minutes and the hosts do not have an agent installed, contact Technical Support for assistance.
Agents are assigned to Alert Logic appliances automatically.
Uninstall agents installed with Distributor
To uninstall agents previously installed with Distributor, you can use the AWS Management Console or the AWS Command Line Interface. Follow the instructions in the AWS document Uninstall a package.