采集器「火山引擎-CDN」配置手册

阅读本文前，请先阅读：

观测云集成 / 基本操作

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

内容分发网络 CDN 采集器不需要配置地域参数

配置过滤器（可选项）

本采集器脚本支持用户自定义过滤器，让用户通过对象属性筛选出目标资源。过滤器函数返回值为 True｜False

True：目标资源需要被采集。
False：目标资源不需要被采集

支持筛选的对象属性：

属性	描述
CacheShared	表示该加速域名在共享缓存配置中的角色 target_host：表示存在一个共享缓存配置 cache_shared_on：表示存在一个共享缓存配置 ""：该参数值为空，表示该加速域名不存在于任何共享缓存配置中。
CacheSharedTargetHost	如果CacheShared 是 cache_shared_on，表示与该加速域名共享缓存的目标域名。如果CacheShared 是 target_host 或者是空值（""），该参数值是空（""）
Cname	域名的 CNAME 地址，在添加域名时自动分配
Domain	加速域名
HTTPS	表示该加速域名是否启用了 HTTPS 功能。
IPv6	表示该加速域名是否支持 IPv6 地址的访问
ServiceRegion	域名加速区域，目前仅支持中国内地地区加速
Status	表示域名是否被锁定。该参数有以下取值： on：表示该域名已被锁定。 off：表示该域名未被锁定。
ServiceType	指定一种域名业务类型进行查询： web：网页/小文件加速； download：大文件下载加速； video：音视频点播加速。

Python
# 示例：开启过滤器，根据对象的 InstanceId 和 name 属性过滤，配置格式如下：
def filter_instance(instance):
    '''
    采集 instance_id 为 xxxxx 或者 instance_name 为 xxxxx 的实例
    '''
    # return True
    instance_id = instance['Domain']
    status = instance['Status']
    if instance_id in ['xxxxx'] or status in ['xxxxx']:
        return True
    return False


###### Do not modify the following contents #####
from guance_integration__runner import Runner
import guance_volcengine_cdn__main as main


@DFF.API('Volcengine-CDN Collection', timeout=3600, fixed_crontab='*/15 * * * *')
def run():
    Runner(main.DataCollector(account, filters=[filter_instance])).run()

1. 数据上报格式

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

上报的数据示例如下：

JSON
{
  "measurement": "volcengine_cdn",
  "tags": {
    "CacheShared": "",
    "CacheSharedTargetHost": "",
    "Cname": "test-aaa.volcgslb.com",
    "Domain": "test.cn",
    "HTTPS": "False",
    "IPv6": "False",
    "IsConflictDomain": "False",
    "OriginProtocol": "http",
    "Project": "default",
    "ServiceRegion": "chinese_mainland",
    "ServiceType": "web",
    "Status": "online",
    "name": "test.cn"
  },
  "fields": {
    "CreateTime": 1712543155,
    "BackupOrigin": "[表示该加速域名的备源站列表]",
    "DomainLock": "{表示该加速域名的锁定状态}",
    "PrimaryOrigin": "[指定一个主源站对加速域名进行筛选]",
    "ResourceTags": "[域名标签组明细]",
    "UpdateTime": 1712543155,
    "message": "{实例 JSON 数据}"
  }
}

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

tags.name 值为实例 ID，作为唯一标识，fields.message、fields.BackupOrigin、fields.DomainLock、fields.PrimaryOrigin、fields.ResourceTags 均为 JSON 序列化后字符串

X. 附录

请参考火山引擎官方文档：

内容分发网络接口地址