PRTG Manual: AWS Alarm v2 Sensor
The AWS Alarm v2 sensor monitors the status of an Amazon Web Services (AWS) alarm by reading its data from Amazon CloudWatch via the AWS API.
If you use the same Identity and Access Management (IAM) policy that you use for this sensor, you must update it. For more information, see the Knowledge Base: How do I set permissions for the Amazon Web Services (AWS) API key to use certain sensors in PRTG?
If you monitor an AWS alarm that is based on a metric math expression, this sensor does not create an additional channel that monitors the math expression.
For a list of regions that this sensor supports, see section Supported AWS Regions and Their Codes.
For a detailed list and descriptions of the channels that this sensor can show, see section Channel List.
- Dutch: AWS Alarm v2
- French: Alarme AWS v2
- German: AWS Alarm v2
- Japanese: AWS Alarm v2
- Portuguese: Alarme da AWS v2
- Russian: Аварийный сигнал AWS v2
- Simplified Chinese: AWS 警报 v2
- Spanish: Alarma AWS v2
Consider the following remarks and requirements for this sensor:
Remark |
Description |
---|---|
Permissions for the AWS API key |
This sensor requires permissions for the AWS API key. For more information, see the Knowledge Base: How do I set permissions for the Amazon Web Services (AWS) API key to use certain sensors in PRTG? |
Credentials |
This sensor requires credentials for AWS. |
Alarms |
This sensor supports MetricAlarm and CompositeAlarm. |
IPv6 |
This sensor supports IPv6. |
Performance impact |
This sensor has a low performance impact. |
Lookups |
This sensor uses lookups to determine the status values of one or more channels. |
Pricing |
Amazon can charge you based on the number of API calls that the sensor sends to the Amazon servers. For more information, see Amazon CloudWatch Pricing – Amazon Web Services (AWS). |
Add Sensor dialog |
It can take up to several minutes before objects appear in the Add Sensor dialog. |
Scanning interval |
This sensor has a fixed minimum scanning interval for performance reasons. You cannot use a shorter scanning interval. Consequently, shorter scanning intervals in the Monitoring settings are not available for this sensor.
|
The sensor has the following default tags that are automatically predefined in the sensor's settings when you add the sensor:
- alarm
- aws
- cloudwatch
- cloudwatchsensor
For more information about basic sensor settings, see section Sensor Settings.
Setting |
Description |
---|---|
Name |
The name of the AWS alarm that this sensor monitors. |
Type |
The type of the AWS alarm that this sensor monitors. |
Description |
The description of the AWS alarm that this sensor monitors. |
Region |
The region in which the AWS alarm that this sensor monitors occurs. For a list of regions that this sensor supports, see section Supported AWS Regions and Their Codes. |
Setting |
Description |
---|---|
Primary Channel |
Select a channel from the list to define it as the primary channel. In the device tree, PRTG displays the last value of the primary channel below the sensor's name. The available options depend on what channels are available for this sensor. You can set a different primary channel later by clicking below a channel gauge on the sensor's Overview tab. |
Graph Type |
Define how this sensor shows different channels:
|
Stack Unit |
This setting is only visible if you select Stack channels on top of each other above. Select a unit from the list. PRTG stacks all channels with this unit on top of each other. By default, you cannot exclude single channels from stacking if they use the selected unit. However, there is an advanced procedure to do so. |
Setting |
Description |
---|---|
Result Handling |
Define what PRTG does with the sensor result:
This option is not available when the sensor runs on the hosted probe of a PRTG Hosted Monitor instance. In a cluster, PRTG stores the result in the PRTG data directory of the master node. |
By default, all of these settings are inherited from objects that are higher in the hierarchy. We recommend that you change them centrally in the root group settings if necessary. To change a setting for this object only, click under the corresponding setting name to disable the inheritance and to display its options.
For more information, see section Inheritance of Settings.
Which channels the sensor actually shows might depend on the target device, the available components, and the sensor setup.
Channel |
Description |
---|---|
Alarm State |
The alarm status This channel is the primary channel by default. |
Downtime |
In the channel table on the Overview tab, this channel never shows any values. PRTG uses this channel in graphs and reports to show the amount of time in which the sensor was in the Down status. |
[Metric] |
The metric on which the alarm is based |
KNOWLEDGE BASE
How do I set permissions for the Amazon Web Services (AWS) API key to use certain sensors in PRTG?
What security features does PRTG include?