Entities, lookup information, and metrics for AWS API ETL
This topic provides information about the entity relationship, lookup details, and mapping between the AWS metrics and the TrueSight Capacity Optimization metrics.
You can also collect additional metrics by using this ETL. For more information, see Collecting additional AWS metrics.
Entity list
The AWS API ETL collects the following types of entities:
- Cloud
- Auto Scale Group
- Virtual Machine
- EBS Volume
- Business Service
Entity relationship
The following table explains the relationship between the AWS entities.
Parent entity | Child entity | Relationship type | Description |
|---|---|---|---|
Cloud - AWS (cl:aws) | Virtual Machine - AWS (gm:aws) | CL_CONTAINS_GM | |
Cloud - AWS (cl:aws) | Auto Scale Group - AWS (asg:aws) | CL_CONTAINS_ASG | |
Virtual Machine - AWS (gm:aws) | Storage Volume - AWS (volume:aws) | GM_USES_VOLUME | |
Cloud - AWS (cl:aws) | Storage Volume - AWS (volume:aws) | CL_CONTAINS_VOLUME | The ETL will import volumes when one of these conditions is true:
|
Auto Scale Group - AWS (asg:aws) | Virtual Machine - AWS (gm:aws) | ASG_CONTAINS_GM | The relationship is true only for the Autoscale Group with a manual scaling policy. |
| Business service | Virtual Machine – AWS | BS_CONTAINS_GM | |
| Business service | Auto Scale Group - AWS | BS_CONTAINS_ASG |
Lookup information
The following table explains the lookup fields for AWS entities that you can use to quickly find the required entity.
Entity type | Lookup fields | |
|---|---|---|
Strong | Weak | |
Storage Volume - AWS | AWS_ID | Not applicable |
Virtual Machine - AWS | AWS_ID | Not applicable |
Cloud - AWS | AWS_NAME | Not applicable |
Auto Scale Group - AWS | AWS_ARN | Not applicable |
| Business Service (svc) | APPLICATION_NAME | Not applicable |
Metric mapping
The following table explains the mapping between the AWS metrics and the TrueSight Capacity Optimization metrics.
Volume metrics
| TrueSight Capacity Optimization metric | Amazon Web Services metric | Formula |
|---|---|---|
ST_VOLUME_TRANSFER_READ_BYTE_RATE | VolumeReadBytes | Sum[VolumeReadBytes]/duration |
ST_VOLUME_TRANSFER_WRITE_BYTE_RATE | VolumeWriteBytes | Sum[VolumeWriteBytes]/duration |
ST_VOLUME_TRANSFER_BYTE_RATE | Derived | (Sum[VolumeReadBytes] + Sum[VolumeWriteBytes])/duration |
ST_VOLUME_IO_READ_RATE | VolumeReadOps | Sum[VolumeReadOps]/duration |
ST_VOLUME_IO_WRITE_RATE | VolumeWriteOps | Sum[VolumeWriteOps]/duration |
ST_VOLUME_IO_RATE | Derived | (Sum[VolumeReadOps] + Sum[VolumeWriteOps])/duration |
ST_VOLUME_READ_TIME | VolumeTotalReadTime | Average(VolumeTotalReadTime) |
ST_VOLUME_WRITE_TIME | VolumeTotalWriteTime | Average(VolumeTotalWriteTime) |
ST_VOLUME_QUEUE_LENGTH | VolumeQueueLength | Average[VolumeQueueLength] |
ST_VOLUME_IDLE_PCT | VolumeIdleTime | Sum[VolumeIdleTime]/duration |
Instance and Autoscale metrics
| TrueSight Capacity Optimization metric | Amazon Web Services metric | Formula |
|---|---|---|
CPU_UTIL | CPUUtilization | Average[CPUUtilization]/100 |
NET_IN_BYTE_RATE | NetworkIn | Sum[NetworkIn]/duration |
NET_OUT_BYTE_RATE | NetworkOut | Sum[NetworkOut]/duration |
NET_BYTE_RATE | Derived | (Sum[NetworkOut] +Sum[NetworkIn])/duration |
DISK_READ_RATE | DiskReadBytes | Sum[DiskReadBytes]/duration |
DISK_WRITE_RATE | DiskWriteBytes | Sum[DiskWriteBytes]/duration |
DISK_TRANSFER_RATE | Derived | (Sum[DiskReadBytes] +Sum[DiskWriteBytes])/duration |
DISK_IO_READ_RATE | DiskReadOps | Sum[DiskReadOps]/duration |
DISK_IO_WRITE_RATE | DiskWriteOps | Sum[DiskWriteOps]/duration |
DISK_IO_RATE | Derived | (Sum[DiskReadOps] +Sum[DiskWriteOps])/duration |
GM_ON_NUM | GroupInServiceInstances | Maximum[GroupInServiceInstances] |
Comments
Log in or register to comment.