You can use Amazon CloudWatch Logs to monitor, store, and access your log files from Amazon EC2 instances, AWS CloudTrail, or other sources. You can then retrieve the associated log data from CloudWatch Logs using the CloudWatch console, CloudWatch Logs commands in the AWS CLI, CloudWatch Logs API, or CloudWatch Logs SDK.
You can use CloudWatch Logs to:
Monitor logs from EC2 instances in real-time: You can use CloudWatch Logs to monitor applications and systems using log data. For example, CloudWatch Logs can track the number of errors that occur in your application logs and send you a notification whenever the rate of errors exceeds a threshold that you specify. CloudWatch Logs uses your log data for monitoring; so, no code changes are required. For example, you can monitor application logs for specific literal terms (such as \"NullReferenceException\") or count the number of occurrences of a literal term at a particular position in log data (such as \"404\" status codes in an Apache access log). When the term you are searching for is found, CloudWatch Logs reports the data to a CloudWatch metric that you specify.
Monitor AWS CloudTrail logged events: You can create alarms in CloudWatch and receive notifications of particular API activity as captured by CloudTrail and use the notification to perform troubleshooting.
Archive log data: You can use CloudWatch Logs to store your log data in highly durable storage. You can change the log retention setting so that any log events older than this setting are automatically deleted. The CloudWatch Logs agent makes it easy to quickly send both rotated and non-rotated log data off of a host and into the log service. You can then access the raw log data when you need it.
cloudwatchlogs(config = list())
Optional configuration of credentials, endpoint, and/or region.
svc <- cloudwatchlogs( config = list( credentials = list( creds = list( access_key_id = "string", secret_access_key = "string", session_token = "string" ), profile = "string" ), endpoint = "string", region = "string" ) )
associate_kms_key | Associates the specified AWS Key Management Service (AWS KMS) customer master key (CMK) with the specified log group |
cancel_export_task | Cancels the specified export task |
create_export_task | Creates an export task, which allows you to efficiently export data from a log group to an Amazon S3 bucket |
create_log_group | Creates a log group with the specified name |
create_log_stream | Creates a log stream for the specified log group |
delete_destination | Deletes the specified destination, and eventually disables all the subscription filters that publish to it |
delete_log_group | Deletes the specified log group and permanently deletes all the archived log events associated with the log group |
delete_log_stream | Deletes the specified log stream and permanently deletes all the archived log events associated with the log stream |
delete_metric_filter | Deletes the specified metric filter |
delete_resource_policy | Deletes a resource policy from this account |
delete_retention_policy | Deletes the specified retention policy |
delete_subscription_filter | Deletes the specified subscription filter |
describe_destinations | Lists all your destinations |
describe_export_tasks | Lists the specified export tasks |
describe_log_groups | Lists the specified log groups |
describe_log_streams | Lists the log streams for the specified log group |
describe_metric_filters | Lists the specified metric filters |
describe_queries | Returns a list of CloudWatch Logs Insights queries that are scheduled, executing, or have been executed recently in this account |
describe_resource_policies | Lists the resource policies in this account |
describe_subscription_filters | Lists the subscription filters for the specified log group |
disassociate_kms_key | Disassociates the associated AWS Key Management Service (AWS KMS) customer master key (CMK) from the specified log group |
filter_log_events | Lists log events from the specified log group |
get_log_events | Lists log events from the specified log stream |
get_log_group_fields | Returns a list of the fields that are included in log events in the specified log group, along with the percentage of log events that contain each field |
get_log_record | Retrieves all the fields and values of a single log event |
get_query_results | Returns the results from the specified query |
list_tags_log_group | Lists the tags for the specified log group |
put_destination | Creates or updates a destination |
put_destination_policy | Creates or updates an access policy associated with an existing destination |
put_log_events | Uploads a batch of log events to the specified log stream |
put_metric_filter | Creates or updates a metric filter and associates it with the specified log group |
put_resource_policy | Creates or updates a resource policy allowing other AWS services to put log events to this account, such as Amazon Route 53 |
put_retention_policy | Sets the retention of the specified log group |
put_subscription_filter | Creates or updates a subscription filter and associates it with the specified log group |
start_query | Schedules a query of a log group using CloudWatch Logs Insights |
stop_query | Stops a CloudWatch Logs Insights query that is in progress |
tag_log_group | Adds or updates the specified tags for the specified log group |
test_metric_filter | Tests the filter pattern of a metric filter against a sample of log event messages |
# NOT RUN {
svc <- cloudwatchlogs()
svc$associate_kms_key(
Foo = 123
)
# }
# NOT RUN {
# }
Run the code above in your browser using DataLab