Difference between revisions of "ZenPack:Amazon Web Services"
John Causey (Talk | contribs) |
|||
(31 intermediate revisions by 10 users not shown) | |||
Line 6: | Line 6: | ||
|Source URI=git://github.com/zenoss/ZenPacks.zenoss.AWS.git | |Source URI=git://github.com/zenoss/ZenPacks.zenoss.AWS.git | ||
|Releases={{Release | |Releases={{Release | ||
− | |Version=2. | + | |Version=2.2.0 |
− | |Tag=2. | + | |Tag=2.2.0 |
− | |Release date= | + | |Release date=2014/05/01 |
− | + | |Compatible with=Zenoss Core 4.2.x, Zenoss Resource Manager 4.2.x | |
− | |Compatible with=Zenoss Core 4.2 | + | |Requires=PythonCollector, |
− | |Requires=PythonCollector, | + | |
}}{{Release | }}{{Release | ||
− | |Version=2. | + | |Version=2.1.0 |
− | |Tag=2. | + | |Tag=2.1.0 |
− | |Release date= | + | |Release date=2013/11/19 |
− | + | |Compatible with=Zenoss Core 4.2.x, Zenoss Resource Manager 4.2.x | |
− | + | ||
− | + | ||
− | + | ||
− | |Compatible with=Zenoss Core 4.2 | + | |
|Requires=PythonCollector, | |Requires=PythonCollector, | ||
}}{{Release | }}{{Release | ||
− | |Version=2 | + | |Version=2.0.0 |
− | + | |Tag=2.0.0 | |
− | + | |Release date=2013/03/25 | |
− | + | |Compatible with=Zenoss Core 4.2.x, Zenoss Resource Manager 4.2.x | |
− | + | |Requires=PythonCollector | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | |Tag=2 | + | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | |Release date= | + | |
− | + | ||
− | |Compatible with=Zenoss Core 4.2 | + | |
− | |Requires=PythonCollector | + | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
}} | }} | ||
|Devices= | |Devices= | ||
Line 77: | Line 30: | ||
|Integrations= | |Integrations= | ||
|DataAudits= | |DataAudits= | ||
+ | |Binaries= | ||
}} | }} | ||
This ZenPack provides support for monitoring Amazon Web Services (AWS). | This ZenPack provides support for monitoring Amazon Web Services (AWS). | ||
Line 106: | Line 60: | ||
The features added by this ZenPack can be summarized as follows. They are each | The features added by this ZenPack can be summarized as follows. They are each | ||
detailed further below. | detailed further below. | ||
+ | |||
* Discovery of EC2, VPC and S3 entities. | * Discovery of EC2, VPC and S3 entities. | ||
* Monitoring of CloudWatch metrics. | * Monitoring of CloudWatch metrics. | ||
Line 127: | Line 82: | ||
;Regions | ;Regions | ||
: Attributes: ID | : Attributes: ID | ||
− | : Collections: VPCs, Subnets, Zones, Instances, Volumes, Images, Snapshots, Gateways, Reservations, Elastic IPs | + | : Collections: VPCs, Subnets, Zones, Instances, Volumes, Images, Snapshots, Gateways, Reservations, Elastic IPs |
;Zones | ;Zones | ||
Line 152: | Line 107: | ||
: Attributes: ID, Region, Zone, Instance, Type, Created Time, Size, IOPS, Status, Attach Data Status, Attach Data Device | : Attributes: ID, Region, Zone, Instance, Type, Created Time, Size, IOPS, Status, Attach Data Status, Attach Data Device | ||
: Tags: Name | : Tags: Name | ||
− | |||
;Elastic IPs | ;Elastic IPs | ||
Line 176: | Line 130: | ||
;Images | ;Images | ||
: Attributes: ID, Region, Status, Location, Owner ID, Architecture, Image type, Kernel ID, Ramdisk ID, Description, Block device mapping, Root device type, Root device name, Virtualization type, Hypervisor | : Attributes: ID, Region, Status, Location, Owner ID, Architecture, Image type, Kernel ID, Ramdisk ID, Description, Block device mapping, Root device type, Root device name, Virtualization type, Hypervisor | ||
− | |||
− | |||
− | |||
− | |||
: Tags: Name | : Tags: Name | ||
Line 193: | Line 143: | ||
;Instances | ;Instances | ||
− | : Metrics: CPUUtilization, DiskReadOps, DiskWriteOps, DiskReadBytes, DiskWriteBytes, NetworkIn, NetworkOut, StatusCheckFailed_Instance, StatusCheckFailed_System | + | : Metrics: CPUUtilization, DiskReadOps, DiskWriteOps, DiskReadBytes, DiskWriteBytes, NetworkIn, NetworkOut, StatusCheckFailed_Instance, StatusCheckFailed_System |
;Volumes | ;Volumes | ||
Line 208: | Line 158: | ||
;S3 Buckets | ;S3 Buckets | ||
: Metrics: Keys count, Total Size | : Metrics: Keys count, Total Size | ||
− | |||
− | |||
− | |||
− | |||
− | |||
=== Soft Limits Monitoring === | === Soft Limits Monitoring === | ||
− | |||
The following resource counts subject to the soft-limits will be collected every 5 minutes and when any of these metrics approaches a soft limit threshold, a Zenoss event will be triggered. | The following resource counts subject to the soft-limits will be collected every 5 minutes and when any of these metrics approaches a soft limit threshold, a Zenoss event will be triggered. | ||
Line 232: | Line 176: | ||
You can optionally configure each monitored AWS account to attempt to discover | You can optionally configure each monitored AWS account to attempt to discover | ||
and monitor the guest Linux or Windows operating systems running within each | and monitor the guest Linux or Windows operating systems running within each | ||
− | EC2 instance, when specific Tags are present. This requires that your Zenoss system | + | EC2 instance, when specific Tags are present. This requires that your Zenoss system |
− | has the network and server access it needs to monitor the guest operating system. | + | has the network and server access it needs to monitor the guest operating system. |
VPC and non-VPC modes are supported. | VPC and non-VPC modes are supported. | ||
Line 264: | Line 208: | ||
Use the following steps to start monitoring EC2 using the Zenoss web interface. | Use the following steps to start monitoring EC2 using the Zenoss web interface. | ||
+ | |||
# Navigate to the Infrastructure page. | # Navigate to the Infrastructure page. | ||
# Choose ''Add EC2 Account'' from the add device button. | # Choose ''Add EC2 Account'' from the add device button. | ||
− | # Enter your AWS | + | # Enter your AWS account name, access key and secret key. |
# Optionally choose a collector other than the default ''localhost''. | # Optionally choose a collector other than the default ''localhost''. | ||
# Click ''Add''. | # Click ''Add''. | ||
Line 276: | Line 221: | ||
<syntaxhighlight lang="text"> | <syntaxhighlight lang="text"> | ||
− | /Devices/AWS/EC2 loader='ec2account', loader_arg_keys=[' | + | /Devices/AWS/EC2 loader='ec2account', loader_arg_keys=['accountname', 'accesskey', 'secretkey', 'collector'] |
− | < | + | <accountname> accountname='<accountname>', accesskey='<accesskey>', secretkey='<secretkey>', collector='<collector>' |
</syntaxhighlight> | </syntaxhighlight> | ||
Line 285: | Line 230: | ||
$ ##i##zenbatchload <filename> | $ ##i##zenbatchload <filename> | ||
</console> | </console> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== Configuring Guest Device Discovery === | === Configuring Guest Device Discovery === | ||
Line 303: | Line 241: | ||
# Navigate to the ''Configuration Properties'' panel and in the ''zAWSDiscover'' property specify the instances' tags and values (e.g. ''tag:value;''). | # Navigate to the ''Configuration Properties'' panel and in the ''zAWSDiscover'' property specify the instances' tags and values (e.g. ''tag:value;''). | ||
# Verify that appropriate SSH, SNMP or Windows credentials are configured for the chosen device class(es). | # Verify that appropriate SSH, SNMP or Windows credentials are configured for the chosen device class(es). | ||
− | |||
# Remodel the EC2 account by choosing ''Model Device'' from its menu. | # Remodel the EC2 account by choosing ''Model Device'' from its menu. | ||
Line 310: | Line 247: | ||
tag to containing VPC with the value set to the name of the Zenoss collector | tag to containing VPC with the value set to the name of the Zenoss collector | ||
to which discovered guest devices should be assigned. | to which discovered guest devices should be assigned. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== Configuring Instances Remodeling === | === Configuring Instances Remodeling === | ||
− | You can optionally configure your monitored AWS account, so that the newly | + | You can optionally configure your monitored AWS account, so that the newly |
− | added or recently dropped instances are automatically reflected on Zenoss UI | + | added or recently dropped instances are automatically reflected on Zenoss UI |
during monitoring: | during monitoring: | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
# Navigate to the ''Configuration Properties'' panel. | # Navigate to the ''Configuration Properties'' panel. | ||
− | # | + | # Enable the ''zAWSRemodelEnabled'' property (set it to ''true''). |
=== PEM file === | === PEM file === | ||
Use the following steps to specify the PEM file to region for use in auto-discovering instance guest operating systems: | Use the following steps to specify the PEM file to region for use in auto-discovering instance guest operating systems: | ||
+ | |||
# Navigate to the ''Configuration Properties'' panel. | # Navigate to the ''Configuration Properties'' panel. | ||
# Set region name and path to PEM file in the appropriate fields of ''zAWSRegionPEM'' property (see [http://wiki.zenoss.org/File:ZAWSRegionPEM_Property.png zAWSRegionPEM Propery]). | # Set region name and path to PEM file in the appropriate fields of ''zAWSRegionPEM'' property (see [http://wiki.zenoss.org/File:ZAWSRegionPEM_Property.png zAWSRegionPEM Propery]). | ||
Line 358: | Line 271: | ||
* /AWS | * /AWS | ||
* /AWS/EC2 | * /AWS/EC2 | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
;Modeler Plugins | ;Modeler Plugins | ||
* aws.EC2 | * aws.EC2 | ||
− | |||
;Datasource Types | ;Datasource Types | ||
Line 394: | Line 293: | ||
* SQSQueue (in /AWS/EC2) | * SQSQueue (in /AWS/EC2) | ||
* EC2ReservedInstance (in /AWS/EC2) | * EC2ReservedInstance (in /AWS/EC2) | ||
+ | |||
* VPNGateway (in /AWS/EC2) | * VPNGateway (in /AWS/EC2) | ||
Line 426: | Line 326: | ||
|zenpython | |zenpython | ||
|} | |} | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== Upgrade == | == Upgrade == | ||
− | The AWS Zenpack of versions 2.0.0 / 2.1.0 can be upgraded. To upgrade the ZenPack, install the | + | The AWS Zenpack of versions 2.0.0 / 2.1.0 can be upgraded. To upgrade the ZenPack, install the |
− | latest version over the existing one. There is no action for the user to migrate the data. | + | latest version over the existing one. There is no action for the user to migrate the data. |
The performance data and events of old ZenPack are retained as per the retain policy settings. | The performance data and events of old ZenPack are retained as per the retain policy settings. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== Changes == | == Changes == | ||
− | ;2. | + | ;2.2.0 |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
* Add support for SQS Messages, S3 Buckets, Reserved Instances, Elastic IPs, Images, VPN Gateways, Snapshots. | * Add support for SQS Messages, S3 Buckets, Reserved Instances, Elastic IPs, Images, VPN Gateways, Snapshots. | ||
* Discover instances via Layer 3 when specific Tags are present on the instance. | * Discover instances via Layer 3 when specific Tags are present on the instance. | ||
Line 570: | Line 351: | ||
* Add support for regions, zones, VPCs, subnets and volumes. | * Add support for regions, zones, VPCs, subnets and volumes. | ||
* Add support for custom CloudWatch metrics. | * Add support for custom CloudWatch metrics. | ||
− | |||
{{ZenPackFooter}} | {{ZenPackFooter}} |
Revision as of 15:25, 1 May 2014
- Organization
- Zenoss, Inc.
- License
- GNU General Public License, Version 2, or later
- ZenPack name
- ZenPacks.zenoss.AWS
- Link to more docs
- View Documentation
- Git sources (for cloning)
- Link
Amazon Web Services ZenPack
Warning
The ZenPack Catalog has moved to its new home at https://www.zenoss.com/product/zenpacks as of January 17, 2017. The following information may be out of date, and this page will eventually be removed.
Support
This is an Open Source ZenPack developed by Zenoss, Inc. Enterprise support for this ZenPack is available to commercial customers with an active subscription.
Releases
- Version 2.2.0- Download
- Released on 2014/05/01
- Requires PythonCollector ZenPack
- Compatible with Zenoss Core 4.2.x, Zenoss Resource Manager 4.2.x
- Version 2.1.0- Download
- Released on 2013/11/19
- Requires PythonCollector ZenPack
- Compatible with Zenoss Core 4.2.x, Zenoss Resource Manager 4.2.x
- Version 2.0.0- Download
- Released on 2013/03/25
- Requires PythonCollector ZenPack
- Compatible with Zenoss Core 4.2.x, Zenoss Resource Manager 4.2.x
Background
This ZenPack provides support for monitoring Amazon Web Services (AWS). Monitoring for the following EC2, VPC and S3 entities is provided through a combination of the AWS EC2 and CloudWatch APIs.
Note: This ZenPack supersedes the older ZenAWS (ZenPacks.zenoss.ZenAWS) ZenPack that was installed by default on versions of Zenoss prior to 4.2.4. Please remove ZenAWS before installing this ZenPack. This will remove the /EC2 device class and the EC2Manager device within. After installing this ZenPack, you will be able to add a new EC2 Account with much greater functionality.
Contents
Gallery
Features
The features added by this ZenPack can be summarized as follows. They are each detailed further below.
- Discovery of EC2, VPC and S3 entities.
- Monitoring of CloudWatch metrics.
- Monitoring of Region, S3Bucket and Subnet components.
- Event management and monitoring.
- Optional auto-discovery and monitoring of instance guest operating systems.
- Optional service impact with addition of Zenoss Service Dynamics product.
Discovery
The following entities will be automatically discovered through an account name, access key and secret key you provide. The attributes, tags and collections will be updated on Zenoss' normal remodeling interval which defaults to every 12 hours.
- Regions
- Attributes: ID
- Collections: VPCs, Subnets, Zones, Instances, Volumes, Images, Snapshots, Gateways, Reservations, Elastic IPs
- Zones
- Attributes: ID, Region, State
- Collections: Instances, Volumes, Subnets
- VPCs
- Attributes: ID, Region, CIDR Block, State
- Tags: Name, Collector
- Collections: Subnets, Instances
- Subnets
- Attributes: ID, Region, VPC, Zone, State, CIDR Block, Available IP Address Count, Zone Default, Auto-Public IP
- Tags: Name
- Collections: Instances
- Instances
- Attributes: ID, Region, VPC, Zone, Image, Subnet, State, Instance ID, Tag, Instance Type, Instance Type Details, Platform, Public DNS Name, Private IP Address, Public IP, Launch Time, Guest Device
- Tags: Name
- Collections: Volumes
- Other: Guest Device (if monitored by Zenoss)
- Volumes
- Attributes: ID, Region, Zone, Instance, Type, Created Time, Size, IOPS, Status, Attach Data Status, Attach Data Device
- Tags: Name
- Elastic IPs
- Attributes: ID, Region, Public IP, Private IP, Instance ID, Domain, Network interface ID, Network interface owner ID
- Tags: Name
- SQS Queues
- Attributes: ID, Region
- Tags: Name
- S3 Buckets
- Attributes: ID, Creation date
- Tags: Name
- Snapshots
- Attributes: ID, Region, Volume, Volume size in Bytes, Progress, Started, Description
- Tags: Name
- VPN Gateways
- Attributes: ID, Region, Gateway type, State
- Tags: Name
- Images
- Attributes: ID, Region, Status, Location, Owner ID, Architecture, Image type, Kernel ID, Ramdisk ID, Description, Block device mapping, Root device type, Root device name, Virtualization type, Hypervisor
- Tags: Name
Monitoring
The following metrics will be collected every 5 minutes by default. Any other CloudWatch metrics can also be collected by adding them to the appropriate monitoring template. The Average statistic is collected, and the graphed value is per second for anything that resembles a rate.
- Regions
- Metrics: CPUUtilization, DiskReadOps, DiskWriteOps, DiskReadBytes, DiskWriteBytes, NetworkIn, NetworkOut
- Instances
- Metrics: CPUUtilization, DiskReadOps, DiskWriteOps, DiskReadBytes, DiskWriteBytes, NetworkIn, NetworkOut, StatusCheckFailed_Instance, StatusCheckFailed_System
- Volumes
- Metrics: VolumeReadBytes, VolumeWriteBytes, VolumeReadOps, VolumeWriteOps, VolumeTotalReadTime, VolumeTotalWriteTime, VolumeIdleTime, VolumeQueueLength
- Provisioned IOPS Metrics: VolumeThroughputPercentage, VolumeReadWriteOps
The Amazon CloudWatch datasource type also allows for the collection of any other CloudWatch metric.
Besides CloudWatch metrics, the following metrics will also be collected every 5 minutes by default.
- Subnets
- Metrics: Available IP Adresses count
- S3 Buckets
- Metrics: Keys count, Total Size
Soft Limits Monitoring
The following resource counts subject to the soft-limits will be collected every 5 minutes and when any of these metrics approaches a soft limit threshold, a Zenoss event will be triggered.
- Regions
- Soft Limit Metrics: Elastic IPs count, Instances count, Subnets count, VPC Security Groups count, VPC Security Groups Rules max, Volumes count
The thresholds are set to the default limit values. If you changed this limit for your account, you should manually change the Max threshold value using the following steps:
- Navigate to Monitoring Templates (Advanced panel).
- Click EC2Region and find RegionsSoftLimits among Data Sources.
- On the Thresholds panel choose the resources count to be changed.
- Double click on the resources count and change the value in the Maximum Value field.
Guest Device Discovery
You can optionally configure each monitored AWS account to attempt to discover and monitor the guest Linux or Windows operating systems running within each EC2 instance, when specific Tags are present. This requires that your Zenoss system has the network and server access it needs to monitor the guest operating system. VPC and non-VPC modes are supported.
The guest operating system devices' life-cycle are managed along with the instance. For example, the guest operating system device is set to a decommissioned production state when the EC2 instance is stopped, and the guest operating system device is deleted when the EC2 instance is destroyed.
Service Impact
When combined with the Zenoss Service Dynamics product, this ZenPack adds built-in service impact capability for services running on AWS. The following service impact relationships are automatically added. These will be included in any services that contain one or more of the explicitly mentioned entities.
- Service Impact Relationships
- Account access failure impacts all regions.
- Region failure affects all VPCs and zones in affected region.
- VPC failure affects all related subnets.
- Zone failure affects all related subnets, instances and volumes.
- Subnet failure affects all instances on affected subnet.
- Volume failure affects any attached instance.
- Instance failure affects the guest operating system device.
- SQSQueue, VPNGateway, or EC2ElasticIP failure affects any related region.
- S3Bucket failure affects related account.
Usage
Adding AWS Accounts
Use the following steps to start monitoring EC2 using the Zenoss web interface.
- Navigate to the Infrastructure page.
- Choose Add EC2 Account from the add device button.
- Enter your AWS account name, access key and secret key.
- Optionally choose a collector other than the default localhost.
- Click Add.
Alternatively you can use zenbatchload to add accounts from the command line. To do this, you must create a file with contents similar to the following. Replace all values in angle brackets with your values minus the brackets. Multiple accounts can be added under the same /Device/AWS/EC2 section.
/Devices/AWS/EC2 loader='ec2account', loader_arg_keys=['accountname', 'accesskey', 'secretkey', 'collector'] <accountname> accountname='<accountname>', accesskey='<accesskey>', secretkey='<secretkey>', collector='<collector>'
You can then load the account(s) with the following command.
$ zenbatchload <filename>
Configuring Guest Device Discovery
Use the following steps to configure instance guest device discovery. Guest device discovery must be configured individually for each EC2 account.
- Navigate to one of the EC2 accounts.
- Click the edit link beside Device Class for Discovered Linux Instances
- Choose the device class for Linux and/or Windows instances.
- Navigate to the Configuration Properties panel and in the zAWSDiscover property specify the instances' tags and values (e.g. tag:value;).
- Verify that appropriate SSH, SNMP or Windows credentials are configured for the chosen device class(es).
- Remodel the EC2 account by choosing Model Device from its menu.
If your instances are VPC instances, and are in a different VPC than the Zenoss server that's monitoring the EC2 account, you must add a Collector tag to containing VPC with the value set to the name of the Zenoss collector to which discovered guest devices should be assigned.
Configuring Instances Remodeling
You can optionally configure your monitored AWS account, so that the newly added or recently dropped instances are automatically reflected on Zenoss UI during monitoring:
- Navigate to the Configuration Properties panel.
- Enable the zAWSRemodelEnabled property (set it to true).
PEM file
Use the following steps to specify the PEM file to region for use in auto-discovering instance guest operating systems:
- Navigate to the Configuration Properties panel.
- Set region name and path to PEM file in the appropriate fields of zAWSRegionPEM property (see zAWSRegionPEM Propery).
Installed Items
Installing this ZenPack will add the following items to your Zenoss system.
- Device Classes
- /AWS
- /AWS/EC2
- Modeler Plugins
- aws.EC2
- Datasource Types
- Amazon CloudWatch
- AWSDataSource
- Monitoring Templates
- EC2Region (in /AWS/EC2)
- EC2Instance (in /AWS/EC2)
- EC2Instance-Detailed (in /AWS/EC2)
- EC2Volume (in /AWS/EC2)
- EC2Volume-IOPS (in /AWS/EC2)
- EC2Image (in /AWS/EC2)
- EC2VPC (in /AWS/EC2)
- EC2VPCSubnet (in /AWS/EC2)
- EC2Snapshot (in /AWS/EC2)
- EC2Zone (in /AWS/EC2)
- S3Bucket (in /AWS/EC2)
- SQSQueue (in /AWS/EC2)
- EC2ReservedInstance (in /AWS/EC2)
- VPNGateway (in /AWS/EC2)
- Device Types
- EC2Account (in /AWS/EC2)
- Component Types
- EC2Region (on EC2Account)
- EC2VPC (on EC2Region)
- EC2VPCSubnet (on EC2Region)
- EC2Zone (on EC2Region)
- EC2Instance (on EC2Region)
- EC2Volume (on EC2Region)
- EC2Image (on EC2Region)
- EC2Snapshot (on EC2Region)
- SQSQueue (on EC2Region)
- VPNGateway (on EC2Region)
- EC2ReservedInstance (on EC2Region)
- S3Bucket (on EC2Account)
- Elastic IP (on EC2Region)
Required Daemons
Type | Name |
---|---|
Modeler | zenmodeler |
Performance Collector | zenpython |
Upgrade
The AWS Zenpack of versions 2.0.0 / 2.1.0 can be upgraded. To upgrade the ZenPack, install the latest version over the existing one. There is no action for the user to migrate the data. The performance data and events of old ZenPack are retained as per the retain policy settings.
Changes
- 2.2.0
- Add support for SQS Messages, S3 Buckets, Reserved Instances, Elastic IPs, Images, VPN Gateways, Snapshots.
- Discover instances via Layer 3 when specific Tags are present on the instance.
- Add ability for user to upload PEM file to region for use in auto-discovering instance guest operating systems.
- Add ability for user to enable reflecting new instances on Zenoss UI during monitoring.
- Support multiple IP addresses per instance and add instance type details.
- Monitor AWS Soft Limits and VPC Subnet available IP address count.
- Update component statuses during monitoring.
- 2.1.0
- Support CloudWatch metrics with multiple indexes.
- Add "Amazon Email Host" notification type for SES notifications.
- 2.0.0
- Add support for regions, zones, VPCs, subnets and volumes.
- Add support for custom CloudWatch metrics.
Installation
Normal Installation (packaged egg)
- Download the appropriate egg file for the version of Zenoss you are running.
- Ensure you are logged in as the zenoss user:
$ sudo su - zenoss
- Install the ZenPack:
$ zenpack --install ZenPacks.zenoss.AWS-*.egg
- Restart these services:
$ zenoss restart
Developer Mode Installation
In order to do a development mode installation you will want to clone the existing git repository, and then use the --link flag with the zenpack command:
- Ensure you are logged in as the zenoss user:
$ sudo su - zenoss
- Start by cloning the upstream repository:
$ git clone git://github.com/zenoss/ZenPacks.zenoss.AWS.git
- Next, perform the installation:
$ zenpack --link --install ZenPacks.zenoss.AWS
- Finally, restart these serivices:
$ zenoss restart
Discuss
New: Don't forget to add yourself to the Zenoss User Map!