Skip to main content
The @guildai-services/guildai~aws-cloudwatch package gives your agents access to AWS CloudWatch logs, metrics, and alarms through Guild’s AWS CloudWatch integration.

Authentication

  • Type: AWS credentials (Access Key ID and Secret Access Key)

Setup

1

Open Credentials

Go to Credentials in Guild.
2

Connect AWS CloudWatch

Click AWS CloudWatch and enter your AWS Access Key ID and Secret Access Key. The IAM user or role must have CloudWatch and CloudWatch Logs read permissions.

Usage

import { awsCloudwatchTools } from "@guildai-services/guildai~aws-cloudwatch"
import { llmAgent } from "@guildai/agents-sdk"

export default llmAgent({
  description: "An agent that monitors AWS CloudWatch",
  tools: { ...awsCloudwatchTools },
})

Selecting specific tools

Tools are named with the aws_cloudwatch_ prefix. Use pick() to include only what your agent needs.
import { awsCloudwatchTools } from "@guildai-services/guildai~aws-cloudwatch"
import { llmAgent, pick } from "@guildai/agents-sdk"

export default llmAgent({
  description: "An agent that investigates CloudWatch alarms",
  tools: {
    ...pick(awsCloudwatchTools, [
      "aws_cloudwatch_describe_alarms",
      "aws_cloudwatch_get_metric_data",
      "aws_cloudwatch_logs_filter_log_events",
    ]),
  },
})