Shoreline makes it easy to automate fleet-wide remediation by creating an Alarm associated with your infrastructure Resources -- the Alarm fires when an incident occurs, which executes an associated remediation Action. Monitoring everything Shoreline does during this remediation process is accessible via the graphical web UI. Still, we knew it was critical to provide access to the same data via the CLI.
We're excited to announce the release of Shoreline Events, which allows you to use the Op CLI to evaluate the status of every Alarm, Action, Bot, and Resource within your infrastructure. Every part of the remediation loop is tracked and associated with an Event, giving you the ability to execute many Op commands to filter and act upon the results.
Event Types
Shoreline generates Events anytime a core object is created or modified.
- Alarm Events - Created whenever an Alarm triggers, resolves, or ends.
- Action Events - Created whenever an Action executes, completes, or fails.
- Bot Events - Created whenever a Bot executes, completes, or fails.
- Resource Events - Created whenever a Resource registers or de-registers.
For example, use the events | type="alarm" command to get all Alarm Events:
Filter Events
You can filter Event records using many of the same Op commands that power the rest of the platform. Check out some simple examples below.
For example, this command gets the first five Alarm Events that fired and then resolved:
For example, the following finds Alarm Events for Resources within either the us-west-2a or us-west-2b availability zones.
Check out the Filter Events documentation for more details.
Filter Resources by Events
Alter the Resources returned by a Resource query based on associated Events. This capability is particularly potent when piped to additional Op commands.
To illustrate, consider the following Op statement:
This statement goes through the following steps:
- Get all host Resources
- Filter down hosts to those that
triggeredthemy_cpu_alarmAlarm at least three times - Execute a custom Linux command to output the current processes
Although we've just scratched the surface of what it can do, the new Events command allows you to use the CLI to determine the status of everything that Shoreline is remediating on your behalf.
Head over to the Events documentation for more details and examples. If you're ready to jump in and see what Shoreline can do, please click here to request a demo.