As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Usando o cache de execução
Por padrão, as execuções não usam um cache de execução. Para usar um cache para a execução, você especifica o cache de execução e o comportamento do cache de execução ao iniciar a execução.
Após a conclusão da execução, você pode usar o console, os CloudWatch registros ou as operações da API para rastrear os acessos ao cache ou solucionar problemas de cache. Para obter mais detalhes, consulte Rastreando informações de cache de chamadas e Solução de problemas de cache de chamadas.
Se uma ou mais tarefas em uma execução gerarem saídas não determinísticas, é altamente recomendável que você não use o cache de chamadas para a execução ou desative essas tarefas específicas do armazenamento em cache. Para obter mais informações, consulte Modelo de responsabilidade compartilhada.
nota
Você fornece uma função de serviço do IAM ao iniciar uma execução. Para usar o cache de chamadas, a função de serviço precisa de permissão para acessar a localização do cache de execução do Amazon S3. Para obter mais informações, consulte Funções de serviço para AWS HealthOmics.
Você pode usar a CLI do Kiro para analisar e gerenciar seus dados de cache de execução. Para obter mais informações, consulte Exemplos de solicitações para a CLI do Kiro e o tutorial de IA generativa da HealthOmics Agentic
Tópicos
Configurando uma execução com cache de execução usando o console
No console, você configura o cache de execução para uma execução ao iniciar a execução.
-
Abra o console do HealthOmics
. Se necessário, abra o painel de navegação esquerdo (≡). Selecione Execuções.
-
Na página Execuções, escolha a execução para começar.
-
Escolha Iniciar execução e conclua as etapas 1 e 2 de Iniciar execução conforme descrito emIniciando uma execução usando o console.
-
Na etapa 3 de Iniciar execução, escolha Selecionar um cache de execução existente.
-
Selecione o cache na lista suspensa Executar ID do cache.
-
Para substituir o comportamento padrão do cache de execução, escolha o comportamento do cache para a execução. Para obter mais informações, consulte Comportamento do cache de execução.
-
Continue com a etapa 4 de Iniciar execução.
Configurando uma execução com cache de execução usando a CLI
Para iniciar uma execução que usa um cache de execução, adicione o parâmetro cache-id ao comando da CLI start-run. Opcionalmente, use o cache-behavior parâmetro para substituir o comportamento padrão que você configurou para o cache de execução. O exemplo a seguir mostra somente os campos de cache do comando:
aws omics start-run \ ... --cache-id "xxxxxx" \ --cache-behavior CACHE_ALWAYS
Se a operação for bem-sucedida, você receberá uma resposta sem campos de dados.
Casos de erro para executar caches
Para os cenários a seguir, HealthOmics talvez não armazene em cache as saídas da tarefa, mesmo para uma execução com o comportamento de cache definido como Cache always.
-
Se a execução encontrar um erro antes que a primeira tarefa seja concluída com êxito, não há saídas de cache para exportar.
-
Se o processo de exportação falhar, HealthOmics não salva as saídas da tarefa no local do cache do Amazon S3.
-
Se a execução falhar devido a um filesystem out of space erro, o cache de chamadas não salvará nenhuma saída da tarefa.
-
Se a execução tiver um tempo limite de execução, o cache de chamadas não salvará nenhuma saída de tarefa, mesmo que você tenha configurado a execução para usar o cache em caso de falha.
Armazenamento em cache em execuções canceladas
Quando você cancela um fluxo de trabalho em execução que usa um cache de execução, HealthOmics exporta entradas de cache para tarefas concluídas com êxito antes do cancelamento. Essas entradas de cache seguem o mesmo comportamento de correspondência e reutilização das entradas de cache de execuções concluídas. HealthOmics não exporta saídas em nível de fluxo de trabalho para execuções canceladas.
Esse comportamento se aplica aos comportamentos de cache sempre e Cache em caso de falha e é compatível com todos os mecanismos de fluxo de trabalho (WDL, CWL e Nextflow).
Rastreando informações de cache de chamadas
Você pode acompanhar eventos de cache de chamadas (como executar ocorrências de cache) usando o console, a CLI ou os registros. CloudWatch
Tópicos
Rastreie os acessos ao cache usando o console
Na página de detalhes da execução de uma execução, a tabela Executar tarefas exibe as informações de ocorrência do Cache para cada tarefa. A tabela também inclui um link para a entrada de cache associada. Use o procedimento a seguir para visualizar as informações de ocorrência do cache para uma execução.
-
Abra o console do HealthOmics
. Se necessário, abra o painel de navegação esquerdo (≡). Selecione Execuções.
-
Na página Execuções, escolha a execução a ser inspecionada.
Na página de detalhes da execução, escolha a guia Executar tarefas para exibir a tabela de tarefas.
Se uma tarefa tiver um cache hit, a coluna Cache hit conterá um link para o local de execução da entrada do cache no Amazon S3.
Escolha o link para inspecionar a entrada do cache de execução.
Rastreie o cache de chamadas usando a CLI
Use o comando da CLI get-run para confirmar se a execução usou um cache de chamadas.
aws omics get-run --id 1234567
Na resposta, se o cacheId campo estiver definido, a execução usa esse cache.
Use o comando da CLI list-run-tasks para recuperar o local dos dados do cache para cada tarefa em cache na execução.
aws omics list-run-tasks --id 1234567
Na resposta, se o campo CacheHit de uma tarefa for verdadeiro, o campo Cache3URI fornecerá a localização dos dados do cache para essa tarefa.
Você também pode usar o comando da CLI get-run-task para recuperar o local dos dados do cache para uma tarefa específica:
aws omics get-run-task --id 1234567 --task-id <task_id>
Rastreie o armazenamento em cache de chamadas usando registros CloudWatch
HealthOmics cria registros de atividades de cache no grupo de /aws/omics/WorkflowLog CloudWatch registros. <cache_id><cache_uuid>Há um fluxo de log para cada cache de execução: runCache//.
Para execuções que usam o cache de chamadas, HealthOmics gera entradas de CloudWatch registros para esses eventos:
criando uma entrada de cache (CACHE_ENTRY_CREATED)
correspondendo a uma entrada de cache (CACHE_HIT)
falha em corresponder a uma entrada de cache (CACHE_MISS)
Para obter mais informações sobre esses registros, consulteLogin CloudWatch.
Use a seguinte consulta do CloudWatch Insights no grupo de /aws/omics/WorkflowLog registros para retornar o número de acessos ao cache por execução desse cache:
filter @logStream like 'runCache/<CACHE_ID>/' fields @timestamp, @message filter logMessage like 'CACHE_HIT' parse "run: *," as run stats count(*) as cacheHits by run
Use a consulta a seguir para retornar o número de entradas de cache criadas por cada execução:
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
