Bagaimana Step Functions mengaitkan eksekusi dengan versi atau alias - AWS Step Functions
Melihat eksekusi dimulai dengan versi atau alias

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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 API. StartExecution Step Functions melakukan tindakan ini pada waktu mulai eksekusi.

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

  • ARN yang memenuhi syarat - Mengacu pada ARN mesin negara yang diakhiran dengan nomor versi atau nama alias.

    Contoh ARN yang memenuhi syarat berikut mengacu pada 3 versi mesin negara bernama. myStateMachine

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

    Contoh ARN yang memenuhi syarat berikut mengacu pada alias bernama mesin PROD negara bernama. myStateMachine

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

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

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

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

Jika ARN Anda yang memenuhi syarat 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 ARN yang tidak memenuhi syarat, Step Functions tidak mengaitkan eksekusi tersebut dengan versi meskipun versi tersebut menggunakan mesin status yang sama. revision Misalnya, jika versi 3 menggunakan revisi terbaru, tetapi Anda memulai eksekusi dengan ARN yang tidak memenuhi syarat, 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 tindakan API

Anda dapat melihat semua eksekusi yang terkait dengan versi atau alias dengan menjalankan tindakan API DescribeExecutiondan ListExecutions. Tindakan API ini mengembalikan ARN versi atau alias yang digunakan untuk memulai eksekusi. Tindakan ini juga mengembalikan detail lainnya termasuk status dan ARN eksekusi.

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

Contoh respons tindakan ListExecutionsAPI berikut menunjukkan ARN alias yang digunakan untuk memulai eksekusi mesin status bernama. myFirstExecution

italicizedTeks 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.

Tangkapan layar ilustratif dari halaman konsol detail versi mesin negara.

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 versi ARN, Step Functions menerbitkan metrik dengan dan metrik kedua dengan StateMachineArn StateMachineArn dan dimensi. Version

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

  • Dua metrik untuk ARN dan versi yang tidak memenuhi syarat.

  • Sebuah metrik dengan StateMachineArn dan Alias dimensi.