Menggunakan cache run - AWS HealthOmics
Mengkonfigurasi run dengan run cache menggunakan konsolMengkonfigurasi run dengan run cache menggunakan CLIKasus kesalahan untuk menjalankan cacheMelacak informasi caching panggilan

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

Menggunakan cache run

Secara default, run tidak menggunakan cache run. Untuk menggunakan cache untuk menjalankan, Anda menentukan cache run dan perilaku run cache saat Anda memulai proses.

Setelah proses selesai, Anda dapat menggunakan konsol, CloudWatch Log, atau operasi API untuk melacak klik cache atau memecahkan masalah cache. Untuk detailnya, lihat Melacak informasi caching panggilan dan Memecahkan masalah caching panggilan.

Jika satu atau beberapa tugas dalam proses menghasilkan output non-deterministik, kami sangat menyarankan agar Anda tidak menggunakan caching panggilan untuk menjalankan, atau Anda memilih keluar dari tugas khusus ini dari caching. Untuk informasi selengkapnya, lihat Model tanggung jawab bersama.

catatan

Anda memberikan peran layanan IAM saat memulai proses. Untuk menggunakan caching panggilan, peran layanan memerlukan izin untuk mengakses lokasi Amazon S3 run cache. Untuk informasi selengkapnya, lihat Peran layanan untuk AWS HealthOmics.

Mengkonfigurasi run dengan run cache menggunakan konsol

Dari konsol, Anda mengonfigurasi cache run untuk dijalankan saat Anda memulai proses.

  1. Buka konsol HealthOmics .

  2. Di panel navigasi kiri, pilih Runs.

  3. Pada halaman Runs, pilih run untuk memulai.

  4. Pilih Mulai jalankan dan selesaikan langkah 1 dan 2 dari Mulai jalankan seperti yang dijelaskan dalamMemulai lari menggunakan konsol.

  5. Pada langkah 3 dari Mulai jalankan, pilih Pilih cache run yang ada.

  6. Pilih cache dari daftar drop-down Jalankan ID cache.

  7. Untuk mengganti perilaku cache run default, pilih perilaku Cache untuk dijalankan. Untuk informasi selengkapnya, lihat Jalankan perilaku cache.

  8. Lanjutkan ke langkah 4 dari Mulai jalankan.

Mengkonfigurasi run dengan run cache menggunakan CLI

Untuk memulai proses yang menggunakan cache run, tambahkan parameter cache-id ke perintah CLI start-run. Secara opsional, gunakan cache-behavior parameter untuk mengganti perilaku default yang Anda konfigurasikan untuk menjalankan cache. Contoh berikut hanya menunjukkan bidang cache untuk perintah:

aws omics start-run \
        ...  
      --cache-id "xxxxxx"    \
      --cache-behavior  CACHE_ALWAYS

Jika operasi berhasil, Anda menerima respons tanpa bidang data.

Kasus kesalahan untuk menjalankan cache

Untuk skenario berikut, HealthOmics mungkin tidak cache output tugas, bahkan untuk menjalankan dengan perilaku cache diatur ke Cache selalu.

  • Jika proses mengalami kesalahan sebelum tugas pertama berhasil diselesaikan, tidak ada output cache untuk diekspor.

  • Jika proses ekspor gagal, HealthOmics tidak menyimpan output tugas ke lokasi cache Amazon S3.

  • Jika proses gagal karena filesystem out of space kesalahan, caching panggilan tidak menyimpan output tugas apa pun.

  • Jika Anda membatalkan proses, caching panggilan tidak menyimpan output tugas apa pun.

  • Jika proses mengalami batas waktu berjalan, caching panggilan tidak menyimpan output tugas apa pun, bahkan jika Anda mengonfigurasi proses untuk menggunakan cache saat gagal.

Melacak informasi caching panggilan

Anda dapat melacak peristiwa caching panggilan (seperti menjalankan cache hits) menggunakan konsol, CLI, CloudWatch atau Log.

Lacak klik cache menggunakan konsol

Di halaman run details untuk menjalankan, tabel Jalankan tugas menampilkan informasi klik Cache untuk setiap tugas. Tabel ini juga menyertakan tautan ke entri cache terkait. Gunakan prosedur berikut untuk melihat informasi cache hit untuk menjalankan.

  1. Buka konsol HealthOmics .

  2. Di panel navigasi kiri, pilih Runs.

  3. Pada halaman Runs, pilih run untuk diperiksa.

  4. Pada halaman run details, pilih tab Jalankan tugas untuk menampilkan tabel tugas.

  5. Jika tugas memiliki cache hit, kolom Cache hit berisi link ke lokasi entri cache run di Amazon S3.

  6. Pilih tautan untuk memeriksa entri run cache.

Lacak caching panggilan menggunakan CLI

Gunakan perintah CLI get-run untuk mengonfirmasi apakah run menggunakan cache panggilan.

 aws omics get-run --id 1234567

Sebagai tanggapan, jika cacheId bidang disetel, run menggunakan cache itu.

Gunakan perintah list-run-tasksCLI untuk mengambil lokasi data cache untuk setiap tugas yang di-cache dalam proses.

 aws omics list-run-tasks --id 1234567

Sebagai tanggapan, jika bidang cacheHit untuk tugas benar, bidang caches3URI menyediakan lokasi data cache untuk tugas itu.

Anda juga dapat menggunakan perintah get-run-taskCLI untuk mengambil lokasi data cache untuk tugas tertentu:

 aws omics get-run-task --id 1234567 --task-id <task_id>

Lacak caching panggilan menggunakan CloudWatch Log

HealthOmics membuat log aktivitas cache di grup /aws/omics/WorkflowLog CloudWatch log. <cache_id><cache_uuid>Ada aliran log untuk setiap cache run: Runcache//.

Untuk menjalankan yang menggunakan caching panggilan, buat HealthOmics entri CloudWatch Log untuk peristiwa ini:

  • membuat entri cache (CACHE_ENTRY_CREATED)

  • mencocokkan entri cache (CACHE_HIT)

  • gagal mencocokkan entri cache (CACHE_MISS)

Untuk informasi selengkapnya tentang log ini, lihatLog masuk CloudWatch .

Gunakan kueri CloudWatch Insights berikut pada grup /aws/omics/WorkflowLog log untuk menampilkan jumlah klik cache per run untuk cache ini:

filter @logStream like 'runCache/<CACHE_ID>/'
 fields @timestamp, @message
 filter logMessage like 'CACHE_HIT'
 parse "run: *," as run
 stats count(*) as cacheHits by run

Gunakan kueri berikut untuk mengembalikan jumlah entri cache yang dibuat oleh setiap proses:

filter @logStream like 'runCache/<CACHE_ID>/'
 fields @timestamp, @message
 filter logMessage like 'CACHE_ENTRY_CREATED'
 parse "run: *," as run
 stats count(*) as cacheEntries by run