采集器「华为云-WAF」配置手册¶

阅读本文前，请先阅读：

云集成

Tip

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

1. 配置结构¶

本采集器配置结构如下：

配置一（推荐）

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

Tip

采集器会自动获取地域下的所有 IAM 项目，再根据 IAM 项目获取资源

配置二（旧版兼容）

字段	类型	是否必须	说明
`region_projects`	dict	必须	所需采集数据的「地域 - 项目 ID」列表
`region_projects[#]`	str:list	必须	键值对中： Key 代表地域（如：`'cn-north-4'`） Value 代表该地域下所需采集的项目 ID 列表总表见附录

2. 配置示例¶

指定地域¶

采集cn-north-4地域对应项目的 WAF 实例数据

collector_configs = {
    'regions': ['cn-north-4']
}

3. 数据上报格式¶

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

上报的数据示例如下：

{
  "measurement": "huaweicloud_waf",
  "tags": {
    "RegionId"             : "cn-north-4",
    "project_id"           : "15c6ce1c12daxxxxxxx",
    "enterprise_project_id": "0",
    "name"                 : "3ddxxx-axxx-48xx-a9xx-28fxxxxxxx",
    "instance_id"          : "3ddxxx-axxx-48xx-a9xx-28fxxxxxxx",
    "instance_name"        : "vpc-default",
    "hostid"               : "d0a4bc2f74e340xxxxx",
    "hostname"             : "www.xxx.com"
  },
  "fields": {
    "description"          : "aaaa",
    "paid_type"            : "prePaid",
    "proxy"                : "false",
    "policyid"             : "bb2124fabe6f42fxxxxx",
    "protect_status"       : "1",
    "access_status"        : "0",
    "web_tag"              : "iii",
    "message"              : "{实例 JSON 数据}"
  }
}

部分字段说明如下，具体可看附录接口返回参数

字段	类型	说明
`web_tag`	string	网站名称，对应 WAF 控制台域名详情中的网站名称
`protect_status`	string	域名防护状态： -1：bypass，该域名的请求直接到达其后端服务器，不再经过 WAF 0：暂停防护，WAF 只转发该域名的请求，不做攻击检测 1：开启防护，WAF 根据您配置的策略进行攻击检测
`access_status`	string	域名接入状态，0 表示未接入，1 表示已接入

Note

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

Tip

tags.name 值为实例 ID，作为唯一标识

Tip

fields.message 为 JSON 序列化后字符串

X. 附录¶

请参考华为云官方文档：