# 开启CCI 2.0事件上报功能
CCI 2.0使用LTS服务为用户采集事件，并允许用户在LTS侧配置告警，及时感知负载异常状态。
在使用CCI 2.0过程中，会针对各种资源产生事件，包含Deployment、Service、HPA、Network、Pod等几种资源。
![](https://support.huaweicloud.com/usermanual-cci2/zh-cn_image_0000002141011865.png "点击放大")
#### 约束与限制
CCI 2.0当前仅支持在西南-贵阳一、华北-北京四、华东-上海一局点使用事件上报功能。
#### 事件格式
CCI 2.0产生的事件格式遵从[cloudevent](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md)格式标准，事件内容以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 2.0 接口参考》帮助文档。
![](https://support.huaweicloud.com/usermanual-cci2/public_sys-resources/notice_3.0-zh-cn.png)
- 新客户使用该API前需要先在CCI服务授权委托。
- LTS创建日志组日志流免费，并每月赠送每个账号一定量存储额度，超过部分将会产生费用详情请参见[计费说明](https://www.huaweicloud.com/pricing/calculator.html#/lts)。您可在LTS服务"配置中心"，通过"超额继续采集日志"开关控制日志超额采集情况，详情请参见[设置LTS日志采集配额和使用量预警](https://support.huaweicloud.com/usermanual-lts/lts_0904.html)。开启后表示当日超过免费赠送的额度时，继续采集日志，超出的部分将按需收费。如果您关闭了此开关，当日志超过每月免费赠送的额度时，将暂停采集日志，会导致后续CCI服务上报的事件不可见。
 
表2API URI 
| API URI                            | 描述         |
|:---|:---|
| GET /v1/observabilityconfiguration | 查询当前可观测性配置 |
| PUT /v1/observabilityconfiguration | 修改可观测性配置   |
   
功能开启后，CCI 2.0服务会在LTS服务侧创建一组日志组日志流，日志组命名格式为cci-event-${projectid}，日志组命名格式为event-${projectid}，存储时间默认为1天，请勿删除。
示例如下：
```
{
  "event": {
    "enable": true
  }
}
```
表3参数解释 
| 参数     | 参数类型 | 参数解释                                                                                                                                                                                                                            |
|:---|:---|:---|
| enable | bool | 表示是否开启事件上报功能。 - true：开启事件上报功能  - false：关闭事件上报功能   |
   
如需修改存储时间，您可前往[LTS控制台](https://console.huaweicloud.com/lts/#/cts/manager/groups)，在"日志管理"页面日志组列表中选择相关日志组，在右侧操作列单击"修改"LTS侧日志组日志流中进行配置。
图1修改日志组   
![](https://support.huaweicloud.com/usermanual-cci2/zh-cn_image_0000002140961409.png "点击放大")
您可在"日志管理"页面日志组列表中单击相关日志组，在日志流中查看CCI 2.0产生的各种资源对象事件。