本文介绍容器服务作为事件源发布到事件总线EventBridge的事件类型。

注意事项

容器服务事件源来自以下两部分:

  • ARMS
    • 您需要在K8s集群中安装ARMS(ack-arms-prometheus)。更多信息,请参见开启阿里云Prometheus监控
    • 这类事件没有分类,所有事件统一为cs:k8s:K8s-event-via-arms。
  • NPD
    • 您需要在K8s集群安装NPD(ack-node-problem-detector)。更多信息,请参见接入NPD
    • 这类事件按资源类型分类,例如PodRelatedEvent表示所有Pod相关的事件。

事件类型

容器服务支持发布到事件总线EventBridge的事件类型如下所示。

事件类型 type参数值
阿里云平台对资源执行的操作事件 cs:ActionTrail:AliyunServiceEvent
API调用 cs:ActionTrail:ApiCall
控制台的操作事件 cs:ActionTrail:ConsoleOperation
ConfigMap相关的K8s事件 cs:k8s:ConfigMapRelatedEvent
CronJob相关的K8s事件 cs:k8s:CronJobRelatedEvent
DaemonSet相关的K8s事件 cs:k8s:DaemonSetRelatedEvent
Deployment相关的K8s事件 cs:k8s:DeploymentRelatedEvent
Ingress相关的K8s事件 cs:k8s:IngressRelatedEvent
Job相关的K8s事件 cs:k8s:JobRelatedEvent
通过ARMS采集的K8s事件 cs:k8s:k8s-event-via-arms
Namespace相关的K8s事件 cs:k8s:NamespaceRelatedEvent
Node相关的K8s事件 cs:k8s:NodeRelatedEvent
PersistentVolumeClaim相关的K8s事件 cs:k8s:PersistentVolumeClaimRelatedEvent
PersistentVolume相关的K8s事件 cs:k8s:PersistentVolumeRelatedEvent
Pod相关的K8s事件 cs:k8s:PodRelatedEvent
ReplicaSet相关的K8s事件 cs:k8s:ReplicaSetRelatedEvent
ReplicationController相关的K8s事件 cs:k8s:ReplicationControllerRelatedEvent
StatefulSet相关的K8s事件 cs:k8s:StatefulSetRelatedEvent

CloudEvents规范中定义的参数解释,请参见事件概述

注意 上述事件类型列表只包含高频事件类型,并没有列举所有的K8s事件类型。您可以通过自定义规则来匹配上述列表中没有的事件,也可以通过过滤所有的事件类型来获得所有的事件类型。

容器服务事件type命名规范为cs:k8s:{资源类型名称}RelatedEvent,例如Pod相关的K8s事件的type参数值为cs:k8s:PodRelatedEvent。

通过ARMS采集的K8s事件

通过应用实时监控服务ARMS采集的K8s事件,事件总线EventBridge接收到的示例事件如下所示。

{
    "id":"4cf9678d-dfec-4d6e-9fd1-a9a2d205****",
    "source":"acs.cs",
    "time":"2020-11-19T21:04:41+08:00",
    "data":{
        "reason":"FailedCreatePodSandBox",
        "involvedObject":{
            "uid":"e0a7e4b6-5331-487f-bb0a-e69647a9****",
            "apiVersion":"v1",
            "kind":"Pod",
            "resourceVersion":"40326010",
            "namespace":"kube-system",
            "name":"alicloud-application-controller-798784bf49-v88hc"
        },
        "count":1,
        "source":{
            "component":"kubelet",
            "host":"cn-hangzhou.192.168.XX.XX"
        },
        "message":"Failed to create pod sandbox",
        "type":"Warning",
        "firstTimestamp":"2020-11-19T21:04:41Z",
        "lastTimestamp":"2020-11-19T21:04:41Z"
    },
    "specversion":"1.0",
    "datacontenttype":"application/json",
    "type":"cs:k8s:K8s-event-via-arms",
    "aliyunaccountid":"123456789098****",
    "aliyuneventbusname":"default",
    "aliyunpublishtime":"2020-11-19T21:04:42.179PRC",
    "aliyunregionid":"cn-hangzhou",
    "aliyunpublishaddr":"172.25.XX.XX"
}

data字段包含的参数解释如下表所示。

参数 类型 示例值 描述
reason String FailedCreatePodSandBox K8s上报事件的原因。
involvedObject Struct 上报事件涉及的对象。
uid String e0a7e4b6-5331-487f-bb0a-e69647a9**** 资源的唯一ID。
apiVersion String v1 API版本。
kind String Pod 资源类型。
resourceVersion String 40326010 资源版本。
namespace String kube-system 资源所在的命名空间。
name String alicloud-application-controller-798784bf49-v88hc 资源名称。
count Integer 1 事件发生的总次数。
source Struct 发现这个事件的资源。
component String kubelet source资源类型。
host String cn-hangzhou.192.168.XX.XX source资源的唯一标识。
message String Failed to create pod sandbox 事件的摘要。
type String Warning 事件等级。
取值说明如下:
  • Warning
  • Normal
firstTimestamp Timestamp 2020-11-19T21:04:41Z 事件第一次发生的时间。
lastTimestamp Timestamp 2020-11-19T21:04:41Z 事件最近一次发生的时间。

Pod相关的K8s事件

Pod相关的K8s事件,事件总线EventBridge接收到的示例事件如下所示。

{
    "datacontenttype":"application/json",
    "aliyunaccountid":"123456789098****",
    "data":{
        "reason":"BackOff",
        "metadata":{
            "uid":"0a2d6413-ea4a-414b-a813-aa9b6a17****",
            "resourceVersion":"1163710",
            "creationTimestamp":"2021-01-08T07:11:52Z",
            "name":"oom-test",
            "namespace":"default"
        },
        "involvedObject":{
            "uid":"3438fea9-1e54-4f71-aec5-6e874136****",
            "apiVersion":"v1",
            "kind":"Pod",
            "resourceVersion":"425592514",
            "name":"oom-test-85b",
            "namespace":"default"
        },
        "reportingInstance":"",
        "count":197,
        "source":{
            "component":"kubelet",
            "host":"cn-hangzhou.172.16.XX.XX"
        },
        "message":"Back-off restarting failed container",
        "type":"Warning",
        "reportingComponent":"",
        "firstTimestamp":"2021-01-08T07:11:52Z",
        "lastTimestamp":"2021-01-08T07:56:41Z"
    },
    "subject":"acs:cs:cn-hangzhou:123456789098****:abc/apis/v1/namespaces/default/pods/oom-test-85b",
    "source":"acs.cs",
    "type":"cs:k8s:PodRelatedEvent",
    "aliyunpublishtime":"2021-01-18T09:43:58.785Z",
    "specversion":"1.0",
    "aliyuneventbusname":"default",
    "id":"af182bae-16b8-4327-bb3a-a972de72****",
    "time":"2021-01-08T15:57:00+08:00",
    "aliyunregionid":"cn-hangzhou",
    "aliyunpublishaddr":"172.25.XX.XX"
}

data字段包含的参数解释如下表所示。

参数 类型 示例值 描述
reason String BackOff Pod相关的K8s事件产生的原因。
metadata Struct 事件的元数据。
uid String 0a2d6413-ea4a-414b-a813-aa9b6a17**** 每个事件在K8s集群中的唯一ID。
resourceVersion Integer 1163710 事件的版本。每次事件修改后会递增。
creationTimestamp Timestamp 2021-01-08T07:11:52Z 事件第一次创建的时间戳。
name String oom-test 事件的名称。
namespace String default 事件归属的命名空间。
involvedObject Struct 事件涉及的对象。
uid String 3438fea9-1e54-4f71-aec5-6e874136**** 资源的唯一ID。
apiVersion String v1 API版本。
kind String Pod 资源类型。
resourceVersion String 40326010 资源版本。
namespace String default 资源所在的命名空间。
name String oom-test-85b6c9494b-hpllq 资源名称。
reportingInstance String 发起事件的实例。
count Integer 197 事件发生的总次数。
source Struct 发现这个事件的资源。
component String kubelet source资源类型。
host String cn-hangzhou.172.16.XX.XX source资源的唯一标识。
message String Back-off restarting failed container 事件的摘要。
type String Warning 事件等级。
取值说明如下:
  • Warning
  • Normal
reportingComponent String 发起事件的组件。
firstTimestamp Timestamp 2021-01-08T07:11:52Z 事件第一次发生的时间。
lastTimestamp Timestamp 2021-01-08T07:56:41Z 事件最近一次发生的时间。