paws.management (version 0.5.0)

cloudwatch: Amazon CloudWatch

Description

Amazon CloudWatch monitors your Amazon Web Services (Amazon Web Services) resources and the applications you run on Amazon Web Services in real time. You can use CloudWatch to collect and track metrics, which are the variables you want to measure for your resources and applications.

CloudWatch alarms send notifications or automatically change the resources you are monitoring based on rules that you define. For example, you can monitor the CPU usage and disk reads and writes of your Amazon EC2 instances. Then, use this data to determine whether you should launch additional instances to handle increased load. You can also use this data to stop under-used instances to save money.

In addition to monitoring the built-in metrics that come with Amazon Web Services, you can monitor your own custom metrics. With CloudWatch, you gain system-wide visibility into resource utilization, application performance, and operational health.

Usage

cloudwatch(
  config = list(),
  credentials = list(),
  endpoint = NULL,
  region = NULL
)

Value

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Arguments

config

Optional configuration of credentials, endpoint, and/or region.

  • credentials:

    • creds:

      • access_key_id: AWS access key ID

      • secret_access_key: AWS secret access key

      • session_token: AWS temporary session token

    • profile: The name of a profile to use. If not given, then the default profile is used.

    • anonymous: Set anonymous credentials.

  • endpoint: The complete URL to use for the constructed client.

  • region: The AWS Region used in instantiating the client.

  • close_connection: Immediately close all HTTP connections.

  • timeout: The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.

  • s3_force_path_style: Set this to true to force the request to use path-style addressing, i.e. http://s3.amazonaws.com/BUCKET/KEY.

  • sts_regional_endpoint: Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html

credentials

Optional credentials shorthand for the config parameter

  • creds:

    • access_key_id: AWS access key ID

    • secret_access_key: AWS secret access key

    • session_token: AWS temporary session token

  • profile: The name of a profile to use. If not given, then the default profile is used.

  • anonymous: Set anonymous credentials.

endpoint

Optional shorthand for complete URL to use for the constructed client.

region

Optional shorthand for AWS Region used in instantiating the client.

Service syntax

svc <- cloudwatch(
  config = list(
    credentials = list(
      creds = list(
        access_key_id = "string",
        secret_access_key = "string",
        session_token = "string"
      ),
      profile = "string",
      anonymous = "logical"
    ),
    endpoint = "string",
    region = "string",
    close_connection = "logical",
    timeout = "numeric",
    s3_force_path_style = "logical",
    sts_regional_endpoint = "string"
  ),
  credentials = list(
    creds = list(
      access_key_id = "string",
      secret_access_key = "string",
      session_token = "string"
    ),
    profile = "string",
    anonymous = "logical"
  ),
  endpoint = "string",
  region = "string"
)

Operations

delete_alarmsDeletes the specified alarms
delete_anomaly_detectorDeletes the specified anomaly detection model from your account
delete_dashboardsDeletes all dashboards that you specify
delete_insight_rulesPermanently deletes the specified Contributor Insights rules
delete_metric_streamPermanently deletes the metric stream that you specify
describe_alarm_historyRetrieves the history for the specified alarm
describe_alarmsRetrieves the specified alarms
describe_alarms_for_metricRetrieves the alarms for the specified metric
describe_anomaly_detectorsLists the anomaly detection models that you have created in your account
describe_insight_rulesReturns a list of all the Contributor Insights rules in your account
disable_alarm_actionsDisables the actions for the specified alarms
disable_insight_rulesDisables the specified Contributor Insights rules
enable_alarm_actionsEnables the actions for the specified alarms
enable_insight_rulesEnables the specified Contributor Insights rules
get_dashboardDisplays the details of the dashboard that you specify
get_insight_rule_reportThis operation returns the time series data collected by a Contributor Insights rule
get_metric_dataYou can use the GetMetricData API to retrieve CloudWatch metric values
get_metric_statisticsGets statistics for the specified metric
get_metric_streamReturns information about the metric stream that you specify
get_metric_widget_imageYou can use the GetMetricWidgetImage API to retrieve a snapshot graph of one or more Amazon CloudWatch metrics as a bitmap image
list_dashboardsReturns a list of the dashboards for your account
list_managed_insight_rulesReturns a list that contains the number of managed Contributor Insights rules in your account
list_metricsList the specified metrics
list_metric_streamsReturns a list of metric streams in this account
list_tags_for_resourceDisplays the tags associated with a CloudWatch resource
put_anomaly_detectorCreates an anomaly detection model for a CloudWatch metric
put_composite_alarmCreates or updates a composite alarm
put_dashboardCreates a dashboard if it does not already exist, or updates an existing dashboard
put_insight_ruleCreates a Contributor Insights rule
put_managed_insight_rulesCreates a managed Contributor Insights rule for a specified Amazon Web Services resource
put_metric_alarmCreates or updates an alarm and associates it with the specified metric, metric math expression, anomaly detection model, or Metrics Insights query
put_metric_dataPublishes metric data points to Amazon CloudWatch
put_metric_streamCreates or updates a metric stream
set_alarm_stateTemporarily sets the state of an alarm for testing purposes
start_metric_streamsStarts the streaming of metrics for one or more of your metric streams
stop_metric_streamsStops the streaming of metrics for one or more of your metric streams
tag_resourceAssigns one or more tags (key-value pairs) to the specified CloudWatch resource
untag_resourceRemoves one or more tags from the specified resource

Examples

Run this code
if (FALSE) {
svc <- cloudwatch()
svc$delete_alarms(
  Foo = 123
)
}

Run the code above in your browser using DataLab