文档

日志服务事件通知概述

重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

通过创建事件通知规则,消息服务MNS可以将日志服务指定资源上产生的事件以消息的方式主动推送到指定的接收端。本文介绍日志服务 SLS(Simple Log Service)事件通知的前提条件和背景信息。

前提条件

  • 已创建日志服务Project和Logstore。具体操作,请参见创建项目Project创建Logstore

    您的消息服务操作日志只能被推送到相同地域下的日志服务Project中。

  • 已授权消息服务使用AliyunMNSLoggingRole角色导出日志。
    单击云资源访问授权,根据提示完成授权。
    警告 请勿取消授权或删除RAM角色,否则将导致MNS日志无法正常推送到日志服务。

背景信息

如下图所示,如果您创建了事件通知规则,当您在请求相关操作时,消息服务MNS将Simple Log Service指定资源上产生的事件以消息的方式推送到接收端。

image

在请求Simple Log Service进行相关操作时,事件通知通过在返回的Response中增加Header来描述触发事件通知的结果,不会影响原定接口的返回值。如果没有匹配事件通知的规则,则不会增加Header;如果匹配到了,不管事件通知是否触发成功,都会增加这个Header。Header格式如下:

  • key:x-log-process-status

  • value:经过Base64编码,解码后为:

    {
        "code":"Success",  //此次触发事件通知的结果。如果成功,返回Success,否则为Fail。Success表示Log Service将消息发送到了主题中,并不代表主题将消息推送到了Endpoint。
        "message":"NotificationSucceed",   //此次操作的详细描述。如果失败,此处会说明失败的原因。
        "type":"EventNotification",   //操作类型。事件通知的操作类型统一为EventNotification。
        "version":"1.0"
    }

示例如下:

x-log-process-status: 'ewogICAgImNvZGUiOiAiU3VjY2VzcyIsCiAgICAibWVzc2FnZSI6ICJOb3RpZmljYXRpb25TdWNjZWVkIiwKICAgICJ0eXBlIjogIkV2ZW50Tm90aWZpY2F0aW9'

  • 本页导读 (1)
文档反馈