采集器「AWS-DocumentDB」配置手册¶

阅读本文前，请先阅读：

云集成

Tip

使用本采集器前，必须安装「集成 Core 核心包」及其配套的第三方依赖包

1. 配置结构¶

本采集器配置结构如下：

字段	类型	是否必须	说明
`regions`	list	必须	所需采集的地域列表
`regions[#]`	str	必须	地域 ID。如：`'cn-north-1'` 总表见附录

2. 配置示例¶

采集宁夏、北京地域的实例数据

collector_configs = {
    'regions': [ 'cn-northwest-1', 'cn-north-1' ]
}

3. 数据上报格式¶

数据正常同步后，可以在观测云的「基础设施-资源目录」中查看数据。

上报的数据示例如下：

{
  "measurement": "aws_documentdb",
  "tags": {
    "AvailabilityZone"          : "cn-north-1a",
    "CACertificateIdentifier"   : "rds-ca-2019",
    "DBClusterIdentifier"       : "docdb-2023-06",
    "DBInstanceArn"             : "arn:aws-cn:rds:cn-north-1:",
    "DBInstanceClass"           : "db.t3.medium",
    "DBInstanceIdentifier"      : "docdb-2023-07",
    "DBInstanceStatus"          : "available",
    "DbiResourceId"             : "db-CKJQ",
    "Engine"                    : "docdb",
    "EngineVersion"             : "3.6.0",
    "KmsKeyId"                  : "arn:aws-cn:kms:cn-north-1:",
    "cloud_provider"            : "aws",
    "name"                      : "docdb-2023-07"
  },
  "fields": {
    "DBSubnetGroup"        : "{}",
    "Endpoint"             : "{\"Address\": \".docdb.cn-north-1.amazonaws.com.cn\", \"HostedZoneId\": \"Z010911BG9\", \"Port\": 27017}",
    "InstanceCreateTime"   : "2023-07-28T05:45:10.004000Z",
    "PendingModifiedValues": "{}",
    "PubliclyAccessible"   : "False",
    "StatusInfos"          : "{}",
    "VpcSecurityGroups"    : "[{\"Status\": \"active\", \"VpcSecurityGroupId\": \"sg-08895f59\"}]",
    "message"              : "{实例 JSON 信息}"
  }
}

Note

tags、fields 中的字段可能会随后续更新有所变动

4. IAM 策略权限¶

Note

如果用户使用带入 IAM 角色的方式采集资源，需要开启一定的操作权限

该采集器需要如下操作权限：

rds:DescribeDBInstances

注意事项¶

触发任务抛错情况以及解决方法¶

AWS client.do_api Error Message: no identity-based policy allows the rds:DescribeDBInstances action

原因：权限配置问题或者依赖包版本问题。

解决方法：

首先判断是否赋予权限 rds:DescribeDBInstances 如果确定已经赋予权限, 请检查依赖包 boto3 版本是否大于等于 1.28.78，如不满足，升级依赖包可解决问题。

X. 附录¶

请参考 AWS 官方文档：