Bagaimana Step Functions mengaitkan eksekusi dengan versi atau alias

Step Functions mengaitkan eksekusi dengan versi atau alias berdasarkan Amazon Resource Name (ARN) yang Anda gunakan untuk menjalankan tindakan. StartExecutionAPI Step Functions melakukan tindakan ini pada waktu mulai eksekusi.

Anda dapat memulai eksekusi mesin negara menggunakan yang memenuhi syarat atau tidak memenuhi syaratARN.

• Memenuhi syarat ARN - Mengacu pada mesin negara ARN berakhiran dengan nomor versi atau nama alias.

  ARNContoh yang memenuhi syarat berikut mengacu pada 3 versi mesin negara bernamamyStateMachine.

  arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:3

  ARNContoh yang memenuhi syarat berikut mengacu pada alias bernama PROD mesin negara bernamamyStateMachine.

  arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:PROD

• Tidak memenuhi syarat ARN - Mengacu pada mesin negara ARN tanpa nomor versi atau akhiran nama alias.

  arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine

Misalnya, jika kualifikasi Anda ARN mengacu pada versi3, Step Functions mengaitkan eksekusi dengan versi ini. Itu tidak mengaitkan eksekusi dengan alias apa pun yang mengarah ke versi3.

Jika kualifikasi Anda ARN mengacu pada alias, Step Functions mengaitkan eksekusi dengan alias tersebut dan versi yang ditunjuk alias tersebut. Eksekusi hanya dapat dikaitkan dengan satu alias.

catatan

Jika Anda memulai eksekusi dengan yang tidak memenuhi syaratARN, Step Functions tidak mengaitkan eksekusi tersebut dengan versi meskipun versi tersebut menggunakan mesin revision status yang sama. Misalnya, jika versi 3 menggunakan revisi terbaru, tetapi Anda memulai eksekusi dengan yang tidak memenuhi syaratARN, Step Functions tidak mengaitkan eksekusi tersebut dengan versi 3.

Melihat eksekusi dimulai dengan versi atau alias

Step Functions menyediakan cara-cara berikut di mana Anda dapat melihat eksekusi yang dimulai dengan versi atau alias:

Menggunakan API tindakan

Anda dapat melihat semua eksekusi yang terkait dengan versi atau alias dengan memanggil dan tindakan. DescribeExecutionListExecutionsAPI APITindakan ini mengembalikan ARN versi atau alias yang digunakan untuk memulai eksekusi. Tindakan ini juga mengembalikan detail lainnya termasuk ARN status dan eksekusi.

Anda juga dapat memberikan alias ARN atau versi mesin status ARN untuk mencantumkan eksekusi yang terkait dengan alias atau versi tertentu.

Contoh respon ListExecutionsAPItindakan berikut menunjukkan ARN alias yang digunakan untuk memulai eksekusi mesin negara bernama myFirstExecution.

Bagian italicized teks dalam cuplikan kode berikut mewakili informasi khusus sumber daya.

{
    "executions": [
        {
            "executionArn": "arn:aws:states:us-east-1:123456789012:execution:myStateMachine:myFirstExecution",
            "stateMachineArn": "arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine",
            "stateMachineAliasArn": "arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:PROD",
            "name": "myFirstExecution",
            "status": "SUCCEEDED",
            "startDate": "2023-04-20T23:07:09.477000+00:00",
            "stopDate": "2023-04-20T23:07:09.732000+00:00"
        }
    ]
}

Menggunakan konsol Step Functions

Anda juga dapat melihat eksekusi yang dimulai oleh versi atau alias dari konsol Step Functions. Prosedur berikut menunjukkan bagaimana Anda dapat melihat eksekusi yang dimulai dengan versi tertentu:

1. Buka konsol Step Functions, lalu pilih mesin status yang sudah ada yang telah Anda publikasikan versinya atau buat alias. Contoh ini menunjukkan cara melihat eksekusi yang dimulai dengan versi mesin status tertentu.

2. Pilih tab Versi, lalu pilih versi dari daftar Versi.

   Tip

   Filter berdasarkan properti atau kotak nilai untuk mencari versi tertentu.

3. Pada halaman Detail versi, Anda dapat melihat daftar semua eksekusi mesin status yang sedang berlangsung dan sebelumnya yang dimulai dengan versi yang dipilih.

Gambar berikut menunjukkan halaman konsol Detail Versi. Halaman ini mencantumkan eksekusi yang dimulai oleh versi 4 dari mesin negara bernamaMathAddDemo. Daftar ini juga menampilkan eksekusi yang dimulai oleh alias bernamaPROD. Alias ini mengarahkan lalu lintas eksekusi ke versi 4.

Menggunakan CloudWatch metrik

Untuk setiap eksekusi mesin status yang Anda mulai denganQualified ARN, Step Functions memancarkan metrik tambahan dengan nama dan nilai yang sama dengan metrik yang dipancarkan saat ini. Metrik tambahan ini berisi dimensi untuk masing-masing pengenal versi dan nama alias yang Anda gunakan untuk memulai eksekusi. Dengan metrik ini, Anda dapat memantau eksekusi mesin status pada tingkat versi dan menentukan kapan skenario rollback mungkin diperlukan. Anda juga dapat membuat CloudWatch alarm Amazon berdasarkan metrik ini.

Step Functions memancarkan metrik berikut untuk eksekusi yang Anda mulai dengan alias atau versi:

• ExecutionTime

• ExecutionsAborted

• ExecutionsFailed

• ExecutionsStarted

• ExecutionsSucceeded

• ExecutionsTimedOut

Jika Anda memulai eksekusi dengan versiARN, Step Functions menerbitkan metrik dengan StateMachineArn dan metrik kedua dengan StateMachineArn dan Version dimensi.

Jika Anda memulai eksekusi dengan aliasARN, Step Functions memancarkan metrik berikut:

• Dua metrik untuk versi ARN dan tidak memenuhi syarat.

• Sebuah metrik dengan StateMachineArn dan Alias dimensi.