管理函数异步调用配置 - 函数计算

什么是异步调用

函数触发分为异步调用和同步调用。通过InvokeFunction接口来调用函数时，您可以指定调用方式。除此之外，针对设定了以下触发器的场景，您的函数将被异步调用：

• 定时触发器（双向集成）
• OSS事件触发器（双向集成）
• MNS主题触发器（双向集成）
• IoT触发器（单向集成）

当函数的异步调用被触发后，函数计算会将触发事件放入内部队列中，并返回请求ID，而具体的调用情况及函数执行状态将不会返回。如果您希望获得异步调用的结果，则可以通过配置异步调用目标来实现。

异步调用流程示意图如下所示。

异步调用的配置项

异步调用配置包含以下两部分：

• 异步调用目标：用于配置获得异步调用的结果的目标云服务，映射到数据结构中的destinationConfig。
• 异步调用策略：用于配置异步调用的消息最大存活时长和重试策略，分别映射到数据结构中的maxAsyncEventAgeInSeconds和maxAsyncRetryAttempts。

异步调用目标

异步调用目标的配置说明如下：

• 异步调用目标的事件内容

  {
      "timestamp": "2020-08-20T12:00:00.000Z",
      "requestContext": {
          "requestId": "xxx",
          "functionArn": "acs:fc:::services/{serviceName}/functions/{functionName}",
          "condition": "FunctionResourceExhausted", 
          "approximateInvokeCount": 3
      },
      "requestPayload": "",
      "responseContext": {
          "statusCode": 200,
          "functionError": ""
      },
      "responsePayload": ""
  }

  参数	说明
  timestamp	调用时间戳。
  requestContext	请求上下文。
  requestContext.requestId	异步调用的请求ID。
  requestContext.functionArn	异步执行的函数ARN。
  requestContext.condition	调用错误码。
  requestContext.approximateInvokeCount	异步调用的执行次数。当该值大于1时，说明函数计算对您的函数进行了重试。
  requestPayload	请求函数的原始负载。
  responseContext	返回上下文。
  responseContext.statusCode	调用函数的返回码（系统）。当该返回码不为200时，说明出现了系统错误。
  responseContext.functionError	调用错误信息。
  responsePayload	执行函数返回的原始负载。

  需注意的是，事件总线EventBridge作为函数异步调用目标时，事件内容会多一些参数，这些参数的更多信息，请参见事件概述。具体示例如下：

  {
      "datacontenttype": "application/json",
      "aliyunaccountid": "143xxxx",
      "data": {
          "requestContext": {
              "condition": "",
              "approximateInvokeCount": 1,
              "requestId": "0fcb7f0c-xxxx",
              "functionArn": "acs:fc:::services/xxxx.LATEST/functions/xxxx"
          },
          "requestPayload": "",
          "responsePayload": "",
          "responseContext": {
              "functionError": "",
              "statusCode": 200
          },
          "timestamp": 12345
      },
      "subject": "acs:fc:::services/xxxx.LATEST/functions/xxxx",
      "source": "acs:fc",
      "type": "fc:AsyncInvoke:succeeded",
      "aliyunpublishtime": "2021-01-03T09:44:31.233Asia/Shanghai",
      "specversion": "1.0",
      "aliyuneventbusname": "xxxxxxx",
      "id": "ecc4865xxxxxx",
      "time": "2021-01-03T01:44:31Z",
      "aliyunregionid": "cn-shanghai-vpc",
      "aliyunpublishaddr": "199.99.xxx.xxx"
  }

• 负载限制

  支持的异步调用目标云服务负载的最大限制如下：

  • MNS队列或主题模型：64 KB
  • 函数计算：128 KB
  • 事件总线EventBridge：64 KB
  • 消息队列RocketMQ版：4 MB
  说明 调用目标云服务的默认数据，即除了requestPayload和responsePayload以外的数据大小在1 KB以内。请确保您异步调用入参、函数返回和默认数据大小之和不要超过负载的最大值。
• 避免循环调用

  当您在配置异步执行目标时，请务必保证不要出现循环调用的情况。例如，您为函数A配置了成功调用时的异步目标为函数B，为函数B配置了成功调用时的异步目标为函数A。当您异步触发函数A并且执行成功后，则可能出现A——>B——>A......循环调用的情况。

异步调用策略

在一些场景下，如果您的调用负载较高，可能出现消息积压的现象，您可以通过修改以下异步调用配置来忽略存在时间过长的消息：

• 消息最大存活时长

  异步调用配置中的maxAsyncEventAgeInSeconds用于配置消息最大存活时长，取值范围[1,2592000]，单位：秒。该时长从触发异步调用时开始计算，到该消息出队准备进行处理为止。如果这段时间长于maxAsyncEventAgeInSeconds的配置值，该条消息将被丢弃。未被消费的消息将计入云监控异步消息超时丢弃指标。指标详情，请参见下文中的查看函数异步调用指标（云监控）。

• 错误重试次数

  函数计算允许通过异步调用配置中的maxAsyncRetryAttempts参数配置重试次数，取值范围[0,8]。函数计算在默认情况下，对异步触发失败的消息进行3次重试，您可以根据业务需求减少或增加对异步调用的重试。

异步调用配置的数据结构

异步调用配置的数据结构如下。

{
  "destinationConfig": {
        "onSuccess": {
          "destination": "acs:fc:{region}:{account}:services/{service_name}.{Qualifier}/functions/{function_name}}",
        },
        "onFailure": {
          "destination": "acs:mns:{region}:{account}:/queues/{queue_name}/messages"
        }
  }
  "maxAsyncEventAgeInSeconds": 100,
  "maxAsyncRetryAttempts": 1
}

配置方式

针对任一异步调用的配置方式，都需确保函数的服务角色具备相应目标服务的权限。

更多信息，请参见权限简介。

使用控制台配置

1. 登录函数计算控制台。
2. 在顶部菜单栏，选择地域。
3. 在左侧导航栏中，单击服务及函数。在服务列表区域，单击目标服务。
4. 在函数列表页签，单击目标函数名称。
   
5. 单击异步配置页签。
6. 在异步配置页签，完成以下参数配置。
   

   参数	示例	说明
   异步策略配置
   最大重试次数	1	异步调用失败后的最大重试次数，默认值为3。取值范围[0，8]。
   消息最大有效期	1	消息最大存活时长，取值范围[1，2592000]。单位：秒。
   Destination配置条件：成功时
   目标类型	fc	异步调用的目标服务，此选项将影响目标配置。可选值如下： fc：函数计算 mns/queues：消息服务MNS的队列模型。 mns/topics：消息队列MNS的主题模型。 eventbridge：事件总线EventBridge。 mq：消息队列RocketMQ版
   服务	fnf-demo	函数计算的服务。 说明 如果目标类型是fc，则需配置此参数，否则无需填写。
   版本/别名	2	函数计算服务的版本或别名。 说明 如果目标类型是fc，则需配置此参数，否则无需填写。
   函数	Operation	函数名称。 说明 如果目标类型是fc，则需配置此参数，否则无需填写。
   队列名	MyQueue	消息服务MNS的队列名。 说明 如果目标类型是mns/queues，则需配置此参数，否则无需填写。
   主题名	MyTopic	消息服务MNS的主题名。 说明 如果目标类型是mns/topics，则需配置此参数，否则无需填写。
   目标	acs:fc:cn-hangzhou:188077086902****:services/fnf-demo.2/functions/Operation	目标服务的ARN。
   Destination配置条件：失败时 请参照异步调用成功时的参数说明填写相关参数。

7. 单击保存配置。
   页面弹出保存成功提示信息。

其他相关操作

• 如需修改已保存的异步调用配置，您可直接在异步配置页签，按需修改相应参数，然后再单击保存配置。
  注意 该修改为增量更新，如果您需要清除某项设置，请先删除该配置后重新创建异步配置。
• 如需删除已保存的异步调用配置，您可直接在异步配置页签，单击删除配置。
• 如需查看异步调用相关监控指标，请参见下文中的查看函数异步调用指标（云监控）。

使用SDK配置

更多信息，请参见SDK列表。

使用API配置

FunctionAsyncInvokeConfig API支持配置某个服务（可包含具体版本或别名）下的某个函数的异步调用配置。

查看函数异步调用指标（云监控）

当您的服务角色没有目标服务的调用权限、返回消息过大或目标服务异常时可能会导致异步目标调用失败。您可以通过云监控的相关指标来了解详情。

1. 登录函数计算控制台。
2. 在顶部菜单栏，选择地域。
3. 在左侧导航栏单击服务及函数，在服务列表区域，单击目标服务。
4. 在函数列表页签，单击目标函数名称。
   
5. 单击函数指标页签。
6. 在函数指标页签，按需选择时间范围，则可查看相关指标。
   
   您所查看到的指标示例图如下，与异步调用相关的指标在方框中。

   异步调用的监控指标说明如下：

   • 错误率：函数计算尝试将异步调用事件发送到目标服务的总次数，以及由于服务端、客户端和函数问题而导致的错误率。权限错误、资源误配或超过大小限制都可能会导致错误率指标出现。
   • 异步调用目标发送指标：函数计算将异步调用事件成功发送到目标服务和发送失败的次数。
   • 异步消息超时丢弃：配置maxAsyncEventAgeInSeconds后，消息超出生命周期而被忽略的个数。