Internetmonitor
This page documents function available when using the Internetmonitor
module, created with @service Internetmonitor
.
Index
Main.Internetmonitor.create_monitor
Main.Internetmonitor.delete_monitor
Main.Internetmonitor.get_health_event
Main.Internetmonitor.get_monitor
Main.Internetmonitor.list_health_events
Main.Internetmonitor.list_monitors
Main.Internetmonitor.list_tags_for_resource
Main.Internetmonitor.tag_resource
Main.Internetmonitor.untag_resource
Main.Internetmonitor.update_monitor
Documentation
Main.Internetmonitor.create_monitor
— Methodcreate_monitor(monitor_name)
create_monitor(monitor_name, params::Dict{String,<:Any})
Creates a monitor in Amazon CloudWatch Internet Monitor. A monitor is built based on information from the application resources that you add: Amazon Virtual Private Clouds (VPCs), Amazon CloudFront distributions, and WorkSpaces directories. Internet Monitor then publishes internet measurements from Amazon Web Services that are specific to the city-networks, that is, the locations and ASNs (typically internet service providers or ISPs), where clients access your application. For more information, see Using Amazon CloudWatch Internet Monitor in the Amazon CloudWatch User Guide. When you create a monitor, you set a maximum limit for the number of city-networks where client traffic is monitored. The city-network maximum that you choose is the limit, but you only pay for the number of city-networks that are actually monitored. You can change the maximum at any time by updating your monitor. For more information, see Choosing a city-network maximum value in the Amazon CloudWatch User Guide.
Arguments
monitor_name
: The name of the monitor.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"ClientToken"
: A unique, case-sensitive string of up to 64 ASCII characters that you specify to make an idempotent API request. Don't reuse the same client token for other API requests."InternetMeasurementsLogDelivery"
: Publish internet measurements for Internet Monitor to an Amazon S3 bucket in addition to CloudWatch Logs."MaxCityNetworksToMonitor"
: The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and the network or ASN, such as an internet service provider (ISP), that clients access the resources through. This limit helps control billing costs. To learn more, see Choosing a city-network maximum value in the Amazon CloudWatch Internet Monitor section of the CloudWatch User Guide."Resources"
: The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs). You can add a combination of Amazon Virtual Private Clouds (VPCs) and Amazon CloudFront distributions, or you can add Amazon WorkSpaces directories. You can't add all three types of resources. If you add only VPC resources, at least one VPC must have an Internet Gateway attached to it, to make sure that it has internet connectivity."Tags"
: The tags for a monitor. You can add a maximum of 50 tags in Internet Monitor."TrafficPercentageToMonitor"
: The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.
Main.Internetmonitor.delete_monitor
— Methoddelete_monitor(monitor_name)
delete_monitor(monitor_name, params::Dict{String,<:Any})
Deletes a monitor in Amazon CloudWatch Internet Monitor.
Arguments
monitor_name
: The name of the monitor to delete.
Main.Internetmonitor.get_health_event
— Methodget_health_event(event_id, monitor_name)
get_health_event(event_id, monitor_name, params::Dict{String,<:Any})
Gets information the Amazon CloudWatch Internet Monitor has created and stored about a health event for a specified monitor. This information includes the impacted locations, and all of the information related to the event by location. The information returned includes the performance, availability, and round-trip time impact, information about the network providers, the event type, and so on. Information rolled up at the global traffic level is also returned, including the impact type and total traffic impact.
Arguments
event_id
: The internally generated identifier of a health event. Because EventID contains the forward slash (“/”) character, you must URL-encode the EventID field in the request URL.monitor_name
: The name of the monitor.
Main.Internetmonitor.get_monitor
— Methodget_monitor(monitor_name)
get_monitor(monitor_name, params::Dict{String,<:Any})
Gets information about a monitor in Amazon CloudWatch Internet Monitor based on a monitor name. The information returned includes the Amazon Resource Name (ARN), create time, modified time, resources included in the monitor, and status information.
Arguments
monitor_name
: The name of the monitor.
Main.Internetmonitor.list_health_events
— Methodlist_health_events(monitor_name)
list_health_events(monitor_name, params::Dict{String,<:Any})
Lists all health events for a monitor in Amazon CloudWatch Internet Monitor. Returns all information for health events including the client location information the network cause and status, event start and end time, percentage of total traffic impacted, and status. Health events that have start times during the time frame that is requested are not included in the list of health events.
Arguments
monitor_name
: The name of the monitor.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"EndTime"
: The time when a health event ended. If the health event is still ongoing, then the end time is not set."EventStatus"
: The status of a health event."MaxResults"
: The number of health event objects that you want to return with this call."NextToken"
: The token for the next set of results. You receive this token from a previous call."StartTime"
: The time when a health event started.
Main.Internetmonitor.list_monitors
— Methodlist_monitors()
list_monitors(params::Dict{String,<:Any})
Lists all of your monitors for Amazon CloudWatch Internet Monitor and their statuses, along with the Amazon Resource Name (ARN) and name of each monitor.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"MaxResults"
: The number of monitor objects that you want to return with this call."MonitorStatus"
: The status of a monitor. This includes the status of the data processing for the monitor and the status of the monitor itself. For information about the statuses for a monitor, see Monitor."NextToken"
: The token for the next set of results. You receive this token from a previous call.
Main.Internetmonitor.list_tags_for_resource
— Methodlist_tags_for_resource(resource_arn)
list_tags_for_resource(resource_arn, params::Dict{String,<:Any})
Lists the tags for a resource. Tags are supported only for monitors in Amazon CloudWatch Internet Monitor.
Arguments
resource_arn
: The Amazon Resource Name (ARN) for a resource.
Main.Internetmonitor.tag_resource
— Methodtag_resource(resource_arn, tags)
tag_resource(resource_arn, tags, params::Dict{String,<:Any})
Adds a tag to a resource. Tags are supported only for monitors in Amazon CloudWatch Internet Monitor. You can add a maximum of 50 tags in Internet Monitor. A minimum of one tag is required for this call. It returns an error if you use the TagResource request with 0 tags.
Arguments
resource_arn
: The Amazon Resource Name (ARN) for a tag that you add to a resource. Tags are supported only for monitors in Amazon CloudWatch Internet Monitor.tags
: Tags that you add to a resource. You can add a maximum of 50 tags in Internet Monitor.
Main.Internetmonitor.untag_resource
— Methoduntag_resource(resource_arn, tag_keys)
untag_resource(resource_arn, tag_keys, params::Dict{String,<:Any})
Removes a tag from a resource.
Arguments
resource_arn
: The Amazon Resource Name (ARN) for a tag you remove a resource from.tag_keys
: Tag keys that you remove from a resource.
Main.Internetmonitor.update_monitor
— Methodupdate_monitor(monitor_name)
update_monitor(monitor_name, params::Dict{String,<:Any})
Updates a monitor. You can update a monitor to change the maximum number of city-networks (locations and ASNs or internet service providers), to add or remove resources, or to change the status of the monitor. Note that you can't change the name of a monitor. The city-network maximum that you choose is the limit, but you only pay for the number of city-networks that are actually monitored. For more information, see Choosing a city-network maximum value in the Amazon CloudWatch User Guide.
Arguments
monitor_name
: The name of the monitor.
Optional Parameters
Optional parameters can be passed as a params::Dict{String,<:Any}
. Valid keys are:
"ClientToken"
: A unique, case-sensitive string of up to 64 ASCII characters that you specify to make an idempotent API request. You should not reuse the same client token for other API requests."InternetMeasurementsLogDelivery"
: Publish internet measurements for Internet Monitor to another location, such as an Amazon S3 bucket. The measurements are also published to Amazon CloudWatch Logs."MaxCityNetworksToMonitor"
: The maximum number of city-networks to monitor for your resources. A city-network is the location (city) where clients access your application resources from and the network or ASN, such as an internet service provider, that clients access the resources through."ResourcesToAdd"
: The resources to include in a monitor, which you provide as a set of Amazon Resource Names (ARNs). You can add a combination of Amazon Virtual Private Clouds (VPCs) and Amazon CloudFront distributions, or you can add Amazon WorkSpaces directories. You can't add all three types of resources. If you add only VPC resources, at least one VPC must have an Internet Gateway attached to it, to make sure that it has internet connectivity."ResourcesToRemove"
: The resources to remove from a monitor, which you provide as a set of Amazon Resource Names (ARNs)."Status"
: The status for a monitor. The accepted values for Status with the UpdateMonitor API call are the following: ACTIVE and INACTIVE. The following values are not accepted: PENDING, and ERROR."TrafficPercentageToMonitor"
: The percentage of the internet-facing traffic for your application that you want to monitor with this monitor.