Document toolboxDocument toolbox

AWS CloudWatch Logs

CloudWatch Logs enables you to centralize the logs from all of your systems, applications, and AWS services that you use, in a single, highly scalable service.

Connect Amazon CloudWatch Logs with Devo SOAR

  1. Navigate to Automations > Integrations.

  2. Search for Amazon CloudWatch Logs.

  3. Click Details, then the + icon. Enter the required information in the following fields.

    • Label: Enter a connection name.

    • Reference Values: Define variables here to templatize integration connections and actions. For example, you can use https://www.{{hostname}}.com where, hostname is a variable defined in this input.

    • Verify SSL: Select option to verify connecting server's SSL certificate (Default is Verify SSL Certificate).

    • Remote Agent: Run this integration using the Devo SOAR Remote Agent.

    • Region Name: Valid AWS Region Name.

    • Access Key: AWS Account Access Key.

    • Secret Key: AWS Account Secret Key.

  4. After you've entered all the details, click Connect.

Actions for Amazon CloudWatchLogs

Get Log Events

Lists log events from the specified log stream.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Input Name

Description

Required

Input Name

Description

Required

Log Group Column name

Column name from parent table holding value for Log Group.

Required

Log Stream Column name

Column name from parent table holding value for Log Stream.

Required

Start Time Column name

Column name from parent table holding value for Start Time, expressed as epoch seconds (default is Batch start time). Events with a timestamp equal to this time or later than this time are included.

Optional

End Time Column name

Column name from parent table holding value for End Time, expressed as epoch seconds (default is Batch end time). Events with a timestamp later than this time are not returned.

Optional

Limit Column name

Column name from parent table holding value for Limit. The maximum number of events to return (default is 1,000 events).

Optional

Output

A JSON object containing multiple rows of result:

  • has_error: True/False

  • error: message/null

  • result: List of dictionaries in which each dict describes a log event.

Filter Log Events

Lists log events from the specified log group.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Input Name

Description

Required

Input Name

Description

Required

Log Group Column name

Column name from parent table holding value for Log Group.

Required

Log Streams

Jinja Template holding value for Log Streams (Default is all streams). Example: {{stream1}},{{stream2}}.

Optional

Log Stream Prefix Column name

Column name from parent table holding value for Log Stream Prefix (default is all streams).

Optional

Start Time Column name

Column name from parent table holding value for Start Time, expressed as epoch seconds (default is Batch start time). Events with a timestamp equal to this time or later than this time are included.

Optional

End Time Column name

Column name from parent table holding value for End Time, expressed as epoch seconds (default is Batch end time). Events with a timestamp later than this time are not returned.

Optional

Filter Pattern

Jinja Template holding value for Filter Pattern (Default is no filter). Example: {{msg1}} {{msg2}}. For more information, see Filter and Pattern Syntax.

Optional

Limit Column name

Column name from parent table holding value for Limit. The maximum number of events to return (default is 1,000 events).

Optional

Output

A JSON object containing multiple rows of result:

  • has_error: True/False

  • error: message/null

  • result: List of dictionaries in which each dict describes a log event.

Release Notes

  • v2.0.0 - Updated architecture to support IO via filesystem