CMDB 中的业务标签
当我们希望将 CMDB 中的业务标签信息与观测信号进行关联时，可以使用 DeepFlow 的 domain-additional-resources 声明式 API。该 API 的详细使用说明请参考额外的云资源标签章节，本章节主要介绍如何利用其中的 cloud_tags 资源同步 CMDB 中的业务标签。
通过该 API，我们可以实现如下的效果：
- 将云服务器的业务、应用、服务、负责人等标签注入至 DeepFlow 的所有观测信号中
- 将 K8s 命名空间的业务、应用等标签注入至 DeepFlow 的所有观测信号中
# 1. API 中的字段定义
CloudTag 结构体定义如下：
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| resource_type | 字符串 | 是 | 可选：chost 和 pod_ns（pod namespace） |
| resource_name | 字符串 | 是 | 资源名，从 vm.name 或 pod_namespace.name 中获取 |
| domain_uuid | 字符串 | 是 | 云平台 UUID，从 vm.domain 或 pod_namespace.domain 中获取 |
| tags | Tag 结构体数组 | 是 | 需要打标签的信息 |
其中，Tag 结构体的定义如下：
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| key | 字符串 | 是 | 限制 255 字符，不支持空格、冒号、反引号、反斜杠、单引号 |
| value | 字符串 | 是 | 限制 255 字符，不支持空格、冒号、反引号、反斜杠 |
# 2. 调用示例
具体的调用方法请参考额外的云资源标签章节，本章节主要介绍其中的 cloud_tags 部分。
# 2.1 通过 HTTP API 调用
curl -XPUT -H "Content-Type:application/json" \
${deepflow_server_node_ip}:${port}/v1/domain-additional-resources/ \
-d@additional_resource.json
1
2
3
2
3
{
// 注意：本 API 为声明式 API，请注意携带 API 中的其他资源信息（若有）
// "azs": [],
// "vpcs": [],
// ...
"cloud_tags": [
{
"resource_type": "xxxx",
"resource_name": "xxxx",
"domain_uuid": "xxxx",
"tags": [
{
"key": "xxxx",
"value": "xxxx"
}
]
}
],
// ...
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# 2.2 通过 deepflow-ctl 命令调用
## 注意：本 API 为声明式 API，请注意携带 API 中的其他资源信息（若有）
#azs: []
#vpcs: []
#...
cloud_tags:
- resource_type: xxxx # required. options: chost, pod_ns
resource_name: xxxx # required. (If there is a duplicate name, one will be chosen at random.)
domain_uuid: xxxx # required
subdomain_uuid: # optional. (Fill in this value if you need to set cloud tags for subdomain)
tags: # required
- key: xxxx # required. (Limited to 255 characters and does not support spaces, colon, back quotes, backslash, single quotes.)
value: xxxx # required. (Limited to 255 characters and does not support spaces, colon, back quotes, backslash.)
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13