Function Compute:Tujuan untuk pemanggilan asinkron

Cara kerja

Diagram berikut menunjukkan cara kerja tujuan.

Kasus penggunaan

• Simpan event yang dibuang untuk diproses lebih lanjut

  Jika pemanggilan asinkron gagal setelah semua percobaan ulang sesuai kebijakan Anda, Function Compute akan membuang event tersebut. Dengan mengonfigurasi tujuan untuk kegagalan, Anda dapat membuat Function Compute secara otomatis mengirimkan konteks pemanggilan yang gagal ke layanan pesan, seperti ApsaraMQ for RocketMQ, untuk analisis atau pemrosesan lebih lanjut. Anda juga dapat menetapkan fungsi lain sebagai tujuan. Function Compute secara otomatis mengirimkan konteks permintaan yang gagal ke fungsi tersebut untuk menjalankan logika penanganan kesalahan kustom Anda.

• Berikan notifikasi kepada layanan downstream mengenai hasil pemanggilan

  Jika Anda telah mengonfigurasi tujuan untuk pemanggilan yang berhasil, sistem Function Compute secara otomatis mengirimkan konteks permintaan yang berhasil ke tujuan setelah permintaan dieksekusi. Misalnya, jika Anda menggunakan Function Compute untuk secara otomatis mengekstrak file ZIP yang diunggah ke OSS dan ingin menerima notifikasi saat proses selesai, Anda dapat mengonfigurasi tujuan untuk pemanggilan asinkron fungsi tersebut.

Layanan yang didukung sebagai tujuan untuk pemanggilan asinkron

Tinjau detail konfigurasi berikut untuk tujuan:

• Konten event untuk tujuan

  Kode berikut merupakan contoh event yang dikirim saat tujuannya adalah Simple Message Queue (formerly MNS), Function Compute, atau ApsaraMQ for RocketMQ.

  {
    "timestamp": 1660120276975,
    "requestContext": {
      "requestId": "xxx",
      "functionArn": "acs:fc:::services/{serviceName}/functions/{functionName}",
         "condition": "FunctionResourceExhausted", 
          "approximateInvokeCount": 3
    },
    "requestPayload": "",
    "responseContext": {
      "statusCode": 200,
      "functionError": ""
    },
    "responsePayload": ""
  }

  Tabel 1. Deskripsi parameter

  Parameter	Deskripsi
  timestamp	Timestamp pemanggilan.
  requestContext	Konteks permintaan.
  requestContext.requestId	ID permintaan untuk pemanggilan asinkron.
  requestContext.functionArn	ARN fungsi yang dieksekusi secara asinkron.
  requestContext.condition	Kode kesalahan pemanggilan.
  requestContext.approximateInvokeCount	Jumlah eksekusi pemanggilan asinkron. Jika nilai ini lebih besar dari 1, artinya Function Compute telah melakukan retry terhadap fungsi Anda.
  requestPayload	Muatan asli permintaan fungsi.
  responseContext	Kembali ke konteks.
  responseContext.statusCode	Kode respons sistem untuk pemanggilan fungsi. Jika kode respons ini bukan 200, artinya terjadi kesalahan sistem.
  responseContext.functionError	Informasi kesalahan pemanggilan.
  responsePayload	Muatan asli yang dikembalikan oleh eksekusi fungsi.

  Contoh berikut menunjukkan event ketika EventBridge menjadi target untuk pemanggilan asinkron. Untuk informasi selengkapnya, lihat Ikhtisar event.

  {
      "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": 1660120276975
      },
      "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"
  }

• Batas muatan

  Batas muatan maksimum untuk layanan tujuan dalam pemanggilan asinkron adalah sebagai berikut:

  • Simple Message Queue (formerly MNS): 64 KB

  • Function Compute: 128 KB

  • EventBridge: 64 KB

  • ApsaraMQ for RocketMQ: 4 MB

• Hindari pemanggilan melingkar

  Saat Anda mengonfigurasi tujuan eksekusi asinkron, hindari membuat pemanggilan melingkar. Misalnya, Anda mengonfigurasi Function B sebagai tujuan untuk pemanggilan sukses Function A, dan Function A sebagai tujuan untuk pemanggilan sukses Function B. Jika Anda memanggil Function A secara asinkron dan eksekusinya berhasil, maka Function B akan dipicu. Function B kemudian memicu Function A lagi, sehingga terbentuk loop.

Konfigurasikan tujuan untuk pemanggilan asinkron

1. Masuk ke Konsol Function Compute. Di panel navigasi sebelah kiri, klik Services & Functions.

2. Di bilah navigasi atas, pilih wilayah. Pada halaman Services, klik layanan yang diinginkan.

3. Pada halaman Functions, klik nama fungsi tujuan. Lalu, pada halaman detail fungsi, klik tab Asynchronous Configurations.

4. Pada tab Asynchronous Configurations, konfigurasikan parameter sesuai kebutuhan.

   • Konfigurasikan Tujuan untuk Pemanggilan Berhasil

     1. Pada bagian Destination for Successful Invocation, klik Modify.

     2. Pada panel Modify Destination for Successful Invocation, atur Invoke Other Services upon Success ke Enable. Lalu, konfigurasikan layanan cloud tujuan tempat hasil dikirim setelah permintaan berhasil dieksekusi. Tabel berikut menjelaskan parameter-parameter tersebut:

        Parameter	Deskripsi
        Destination Service	Function Compute. Jika Anda mengatur Destination Service ke Function Compute, konfigurasikan parameter berikut: Service Name: Tentukan nama layanan tujuan. Version or Alias: Tentukan alias atau versi layanan. Function Name: Tentukan nama fungsi tujuan. Catatan Anda hanya dapat menetapkan fungsi event Function Compute sebagai tujuan. Anda tidak dapat menetapkan fungsi HTTP sebagai tujuan.
        	Simple Message Queue (formerly MNS). Jika Anda mengatur Destination Service ke Simple Message Queue (formerly MNS), konfigurasikan parameter berikut: Destination Type: Pilih jenis tujuan sesuai kebutuhan. Nilai yang valid: Queue: Topic: Queue: Nama antrian Simple Message Queue (formerly MNS). Parameter ini wajib diisi jika Anda mengatur Destination Type ke Queue. Topic: Nama topik Simple Message Queue (formerly MNS). Parameter ini wajib diisi jika Anda mengatur Destination Type ke Topic.
        	ApsaraMQ for RocketMQ. Jika Anda mengatur Destination Service ke ApsaraMQ for RocketMQ, konfigurasikan parameter berikut: Instances: Pilih instans tujuan. Topic: Pilih topik tujuan.
        	EventBridge. Jika Anda mengatur Destination Service ke EventBridge, tentukan Custom Event Bus.

     3. Klik OK.

   • Konfigurasikan Tujuan untuk Pemanggilan Gagal

     1. Pada bagian Destination for Failed Invocation, klik Modify.

     2. Pada panel Modify Destination for Failed Invocation, atur Invoke Other Services upon Failure ke Enable. Lalu, konfigurasikan layanan cloud tujuan tempat hasil dikirim setelah permintaan gagal.

        Untuk informasi mengenai parameter konfigurasi tujuan untuk pemanggilan gagal, lihat Konfigurasikan Tujuan untuk Pemanggilan Berhasil.

     3. Klik OK.

   Setelah fungsi dipicu, Anda dapat membaca konten berikut dari layanan tujuan yang dikonfigurasi saat eksekusi fungsi berhasil atau gagal:

   {
       "timestamp": 1660120276975,
       "requestContext": {
           "requestId": "xxx",
           "functionArn": "acs:fc:::services/{serviceName}/functions/{functionName}",
           "condition": "FunctionResourceExhausted",
           "approximateInvokeCount": 3
       },
       "requestPayload": "",
       "responseContext": {
           "statusCode": 200,
           "functionError": ""
       },
       "responsePayload": ""
   }

Penanganan kegagalan callback

Callback ke Destination Service dapat gagal jika peran layanan tidak memiliki izin akses atau jika Destination Service tidak tersedia. Function Compute menyediakan metrik dan log terkait untuk membantu Anda menangani kegagalan tersebut. Tabel berikut menjelaskan kesalahan umum dan perilaku sistem.

Metrik callback hasil

Jika callback ke Destination Service gagal, Function Compute mencatat metrik terkait dan menampilkannya di konsol. Masuk ke Function Compute console. Di panel navigasi sebelah kiri, pilih Advanced Features > Monitoring. Lalu, pada daftar Service Name, klik nama layanan tujuan untuk melihat metriknya. Tabel berikut menjelaskan metrik untuk fitur tujuan.

Untuk informasi selengkapnya mengenai metrik pemantauan, lihat Metrik pemantauan.

Informasi tambahan