更新时间:2025-08-26 GMT+08:00
分享

开启CCI 2.0事件上报功能

CCI 2.0使用LTS服务为用户采集事件,并允许用户在LTS侧配置告警,及时感知负载异常状态。

在使用CCI 2.0过程中,会针对各种资源产生事件,包含Deployment、Service、HPA、Network、Pod等几种资源。

约束与限制

CCI 2.0当前仅支持在西南-贵阳一、华北-北京四、华东-上海一局点使用事件上报功能。

事件格式

CCI 2.0产生的事件格式遵从cloudevent格式标准,事件内容以json类型存储,示例及各字段解释如下:

{
    "data": {
        "metadata": {
            "name": "service-test-event",
            "namespace": "test",
            "uid": "1******3-2**1-4**a-9**8-2******0",
            "resourceVersion": "61788694",
            "creationTimestamp": "2024-11-30T07: 55: 40Z",
            "annotations": {
                "tenant.cci.io/tenant-id": "a81*******24"
            }
        },
        "involvedObject": {
            "kind": "Service",
            "namespace": "test",
            "name": "service-test",
            "uid": "f******3-d**b-4**e-a**c-9f******e3",
            "apiVersion": "cci/v2",
            "resourceVersion": "7669479"
        },
        "reason": "EnsuringLoadBalancer",
        "message": "Ensuring load balancer",
        "source": {
            "component": "service-controller"
        },
        "firstTimestamp": "2024-11-30T07: 52: 45Z",
        "lastTimestamp": "2024-12-03T02: 30: 02Z",
        "count": 4,
        "type": "Normal",
        "eventTime": null,
        "reportingComponent": "",
        "reportingInstance": ""
    }, 
    "deprecatedeventreason": "EnsuringLoadBalancer", 
    "eventclass": "Normal", 
    "datacontenttype": "application/json", 
    "time": "2024-04-05T17:31:00Z", 
    "id": "b*****9-5737-4**1-8**a-3*******bc", 
    "specversion": "1.0",
    "source": "cci:a8*********48b24:service:test:service-test:f******3-d**b-4**e-a**c-4******3",
    "type": "cloudservice.cci.service.publish.processing" 
}
表1 字段列表

字段

字段类型

描述

type

string

标识资源对象当前操作状态,格式为cloudservice.cci.${资源类型}.${资源操作}.${操作结果}.${附加信息},其中附加信息片段仅存在于复杂场景

source

string

标识资源对象上下文,格式为cci:${projectid}:${资源类型}:${命名空间}:${资源名称}:${资源唯一id}

specversion

string

cloudevent版本标准,当前为1.0

id

string

事件对象的唯一标识,uuid随机生成

time

Timestamp

事件发生时间

eventclass

string

事件级别,仅包含Normal和Warning两类

deprecatedeventreason

string

触发事件的reason字段,复用k8s event reason(https://kubernetes.io/zh-cn/docs/reference/kubernetes-api/cluster-resources/event-v1/)字段内容,逐步弃用

datacontenttype

string

“data”字段存储类型,当前为application/json格式

data

k8s event object

event详细内容,可按照“datacontenttype”字段定义的存储类型解析

开启CCI 2.0事件上报功能

CCI 2.0采用按需开放的形式开启事件上报功能,需要用户主动调用CCI 2.0 API进行开启,功能默认关闭。

  • 新客户使用该API前需要先在CCI服务授权委托。
  • LTS创建日志组日志流免费,并每月赠送每个账号一定量存储额度,超过部分将会产生费用详情请参见计费说明。您可在LTS服务“配置中心”,通过“超额继续采集日志”开关控制日志超额采集情况,详情请参见设置LTS日志采集配额和使用量预警。开启后表示当日超过免费赠送的额度时,继续采集日志,超出的部分将按需收费。如果您关闭了此开关,当日志超过每月免费赠送的额度时,将暂停采集日志,会导致后续CCI服务上报的事件不可见。
表2 API URI

API URI

描述

GET /v1/observabilityconfiguration

查询当前可观测性配置

PUT /v1/observabilityconfiguration

修改可观测性配置

功能开启后,CCI 2.0服务会在LTS服务侧创建一组日志组日志流,日志组命名格式为cci-event-${projectid},日志组命名格式为event-${projectid},存储时间默认为1天,请勿删除。

如需修改存储时间,您可前往云日志控制台,在“日志管理”页面日志组列表中选择相关日志组,在右侧操作列单击“修改”LTS侧日志组日志流中进行配置。

图1 修改日志组

您可在“日志管理”页面日志组列表中单击相关日志组,在日志流中查看CCI 2.0产生的各种资源对象事件。

相关文档