CloudWatch

使用说明

Integrate AWS CloudWatch into workflows. Run Log Insights queries, list log groups, retrieve log events, list and get metrics, and monitor alarms. Requires AWS access key and secret access key.

工具

`cloudwatch_query_logs`

Run a CloudWatch Log Insights query against one or more log groups

输入

参数	类型	必填	描述
`awsRegion`	string	是	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	是	AWS access key ID
`awsSecretAccessKey`	string	是	AWS secret access key
`logGroupNames`	array	是	Log group names to query
`queryString`	string	是	CloudWatch Log Insights query string
`startTime`	number	是	Start time as Unix epoch seconds
`endTime`	number	是	End time as Unix epoch seconds
`limit`	number	否	Maximum number of results to return

输出

参数	类型	描述
`results`	array	Query result rows (each row is a key/value map of field name to value)
`statistics`	object	Query statistics
↳ `bytesScanned`	number	Total bytes of log data scanned
↳ `recordsMatched`	number	Number of log records that matched the query
↳ `recordsScanned`	number	Total log records scanned
`status`	string	Query completion status (Complete, Failed, Cancelled, or Timeout)

`cloudwatch_describe_log_groups`

List available CloudWatch log groups

输入

参数	类型	必填	描述
`awsRegion`	string	是	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	是	AWS access key ID
`awsSecretAccessKey`	string	是	AWS secret access key
`prefix`	string	否	Filter log groups by name prefix
`limit`	number	否	Maximum number of log groups to return

输出

参数	类型	描述
`logGroups`	array	List of CloudWatch log groups with metadata
↳ `logGroupName`	string	Log group name
↳ `arn`	string	Log group ARN
↳ `storedBytes`	number	Total stored bytes
↳ `retentionInDays`	number	Retention period in days (if set)
↳ `creationTime`	number	Creation time in epoch milliseconds

`cloudwatch_get_log_events`

Retrieve log events from a specific CloudWatch log stream

输入

参数	类型	必填	描述
`awsRegion`	string	是	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	是	AWS access key ID
`awsSecretAccessKey`	string	是	AWS secret access key
`logGroupName`	string	是	CloudWatch log group name
`logStreamName`	string	是	CloudWatch log stream name
`startTime`	number	否	Start time as Unix epoch seconds
`endTime`	number	否	End time as Unix epoch seconds
`limit`	number	否	Maximum number of events to return

输出

参数	类型	描述
`events`	array	Log events with timestamp, message, and ingestion time
↳ `timestamp`	number	Event timestamp in epoch milliseconds
↳ `message`	string	Log event message
↳ `ingestionTime`	number	Ingestion time in epoch milliseconds

`cloudwatch_describe_log_streams`

List log streams within a CloudWatch log group

输入

参数	类型	必填	描述
`awsRegion`	string	是	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	是	AWS access key ID
`awsSecretAccessKey`	string	是	AWS secret access key
`logGroupName`	string	是	CloudWatch log group name
`prefix`	string	否	Filter log streams by name prefix
`limit`	number	否	Maximum number of log streams to return

输出

参数	类型	描述
`logStreams`	array	List of log streams with metadata, sorted by last event time (most recent first) unless a prefix filter is applied
↳ `logStreamName`	string	Log stream name
↳ `lastEventTimestamp`	number	Timestamp of the last log event in epoch milliseconds
↳ `firstEventTimestamp`	number	Timestamp of the first log event in epoch milliseconds
↳ `creationTime`	number	Stream creation time in epoch milliseconds
↳ `storedBytes`	number	Total stored bytes

`cloudwatch_list_metrics`

List available CloudWatch metrics

输入

参数	类型	必填	描述
`awsRegion`	string	是	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	是	AWS access key ID
`awsSecretAccessKey`	string	是	AWS secret access key
`namespace`	string	否	Filter by namespace (e.g., AWS/EC2, AWS/Lambda)
`metricName`	string	否	Filter by metric name
`recentlyActive`	boolean	否	Only show metrics active in the last 3 hours
`limit`	number	否	Maximum number of metrics to return

输出

参数	类型	描述
`metrics`	array	List of metrics with namespace, name, and dimensions
↳ `namespace`	string	Metric namespace (e.g., AWS/EC2)
↳ `metricName`	string	Metric name (e.g., CPUUtilization)
↳ `dimensions`	array	Array of name/value dimension pairs

`cloudwatch_get_metric_statistics`

Get statistics for a CloudWatch metric over a time range

输入

参数	类型	必填	描述
`awsRegion`	string	是	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	是	AWS access key ID
`awsSecretAccessKey`	string	是	AWS secret access key
`namespace`	string	是	Metric namespace (e.g., AWS/EC2, AWS/Lambda)
`metricName`	string	是	Metric name (e.g., CPUUtilization, Invocations)
`startTime`	number	是	Start time as Unix epoch seconds
`endTime`	number	是	End time as Unix epoch seconds
`period`	number	是	Granularity in seconds (e.g., 60, 300, 3600)
`statistics`	array	是	Statistics to retrieve (Average, Sum, Minimum, Maximum, SampleCount)
`dimensions`	string	否	Dimensions as JSON (e.g., {"InstanceId": "i-1234"})

输出

参数	类型	描述
`label`	string	Metric label returned by CloudWatch
`datapoints`	array	Datapoints sorted by timestamp with statistics values
↳ `timestamp`	number	Datapoint timestamp in epoch milliseconds
↳ `average`	number	Average statistic value
↳ `sum`	number	Sum statistic value
↳ `minimum`	number	Minimum statistic value
↳ `maximum`	number	Maximum statistic value
↳ `sampleCount`	number	Sample count statistic value
↳ `unit`	string	Unit of the metric

`cloudwatch_put_metric_data`

Publish a custom metric data point to CloudWatch

输入

参数	类型	必填	描述
`awsRegion`	string	是	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	是	AWS access key ID
`awsSecretAccessKey`	string	是	AWS secret access key
`namespace`	string	是	Metric namespace (e.g., Custom/MyApp)
`metricName`	string	是	Name of the metric
`value`	number	是	Metric value to publish
`unit`	string	否	Unit of the metric (e.g., Count, Seconds, Bytes)
`dimensions`	string	否	JSON string of dimension name/value pairs

输出

参数	类型	描述
`success`	boolean	Whether the metric was published successfully
`namespace`	string	Metric namespace
`metricName`	string	Metric name
`value`	number	Published metric value
`unit`	string	Metric unit
`timestamp`	string	Timestamp when the metric was published

`cloudwatch_describe_alarms`

List and filter CloudWatch alarms

输入

参数	类型	必填	描述
`awsRegion`	string	是	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	是	AWS access key ID
`awsSecretAccessKey`	string	是	AWS secret access key
`alarmNamePrefix`	string	否	Filter alarms by name prefix
`stateValue`	string	否	Filter by alarm state (OK, ALARM, INSUFFICIENT_DATA)
`alarmType`	string	否	Filter by alarm type (MetricAlarm, CompositeAlarm)
`limit`	number	否	Maximum number of alarms to return

输出

参数	类型	描述
`alarms`	array	List of CloudWatch alarms with state and configuration
↳ `alarmName`	string	Alarm name
↳ `alarmArn`	string	Alarm ARN
↳ `stateValue`	string	Current state (OK, ALARM, INSUFFICIENT_DATA)
↳ `stateReason`	string	Human-readable reason for the state
↳ `metricName`	string	Metric name (MetricAlarm only)
↳ `namespace`	string	Metric namespace (MetricAlarm only)
↳ `threshold`	number	Threshold value (MetricAlarm only)
↳ `stateUpdatedTimestamp`	number	Epoch ms when state last changed

`cloudwatch_mute_alarm`

Create a CloudWatch alarm mute rule that suppresses alarms for a fixed duration

输入

参数	类型	必填	描述
`awsRegion`	string	是	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	是	AWS access key ID
`awsSecretAccessKey`	string	是	AWS secret access key
`muteRuleName`	string	是	Unique name for the mute rule (used later to unmute)
`alarmNames`	array	是	Names of the CloudWatch alarms this mute rule targets
`durationValue`	number	是	How long the mute lasts (paired with durationUnit)
`durationUnit`	string	是	Unit for durationValue: minutes, hours, or days
`description`	string	否	Optional description of why the alarms are being muted
`startDate`	number	否	When the mute window begins as Unix epoch seconds. Defaults to now (mute starts immediately).

输出

参数	类型	描述
`success`	boolean	Whether the mute rule was created successfully
`muteRuleName`	string	Name of the mute rule that was created
`alarmNames`	array	Names of the alarms this rule mutes
`expression`	string	Schedule expression used by the mute rule
`duration`	string	ISO 8601 duration of the mute window

`cloudwatch_unmute_alarm`

Delete a CloudWatch alarm mute rule, restoring alarm notifications

输入

参数	类型	必填	描述
`awsRegion`	string	是	AWS region (e.g., us-east-1)
`awsAccessKeyId`	string	是	AWS access key ID
`awsSecretAccessKey`	string	是	AWS secret access key
`muteRuleName`	string	是	Name of the mute rule to delete

输出

参数	类型	描述
`success`	boolean	Whether the mute rule was deleted successfully
`muteRuleName`	string	Name of the mute rule that was deleted

CloudWatch

On this page