Visualizar rastreamentos do X-Ray no Step Functions

Para criar uma função (console)

1. Faça login no AWS Management Console e abra o IAM console em https://console.aws.amazon.com/iam/.

2. No painel de navegação do IAM console, escolha Funções. Então, escolha Criar perfil.

3. Selecione o AWS Digite a função de serviço e, em seguida, escolha Lambda.

4. Escolha o caso de uso do Lambda. Casos de uso são definidos pelo serviço para incluir a política de confiança exigida pelo serviço. Então, escolha Próximo: Permissões.

5. Selecione uma ou mais políticas de permissões a serem anexadas à função (por exemplo, AWSLambdaBasicExecutionRole). Consulte AWS Lambda Modelo de permissões.

   Selecione a caixa ao lado da política que atribui as permissões que você deseja que a função tenha e, em seguida, escolha Próximo: Revisar.

6. Insira um Role name.

7. (Opcional) Em Descrição da função, edite a descrição para a nova função vinculada ao serviço.

8. Reveja a função e escolha Criar função.

1. Abra o console do Lambda e clique em Criar função.

2. Na seção Criar função, selecione Criar do zero.

3. Na seção Informações básicas, configure a função do Lambda:

   1. Em Function name (Nome da função), insira TestFunction1.

   2. Em Runtime, selecione Node.js 18.x.

   3. Em Role (Função), selecione Choose an existing role (Escolher uma função existente).

   4. Em Função existente, selecione a função do Lambda que você criou anteriormente.

      nota

      Se a IAM função que você criou não aparecer na lista, talvez ela ainda precise de alguns minutos para ser propagada para o Lambda.

   5. Escolha a opção Criar função.

      Quando sua função Lambda for criada, anote seu Amazon Resource Name (ARN) no canto superior direito da página. Por exemplo:

      arn:aws:lambda:us-east-1:123456789012:function:TestFunction1

4. Copie o código a seguir para a função Lambda na seção Código da função do TestFunction1página.

   function getRandomSeconds(max) {
       return Math.floor(Math.random() * Math.floor(max)) * 1000;
   }
   function sleep(ms) {
       return new Promise(resolve => setTimeout(resolve, ms));
   }
   export const handler = async (event) => {
       if(getRandomSeconds(4) === 0) {
           throw new Error("Something went wrong!");
       }   
       let wait_time = getRandomSeconds(5);
       await sleep(wait_time);
       return { 'response': true }
   };

   Esse código cria falhas programadas aleatoriamente que serão usadas para gerar exemplos de erros na máquina de estado que podem ser visualizados e analisados usando rastreamentos do X-Ray.

5. Escolha Salvar.

1. Repita a Etapa 2 para criar mais duas funções do Lambda. Em Nome da função da primeira função, insira TestFunction2. Em Nome da função da segunda função, insira TestFunction3.

2. No console do Lambda, verifique se agora são exibidas três funções do Lambda, TestFunction1, TestFunction2 e TestFunction3.

1. Abra o console do Step Functions e clique em Criar máquina de estado.

   Importante

   Certifique-se de que sua máquina de estado esteja sob a mesma AWS conta e região como as funções Lambda que você criou anteriormente nas etapas 2 e 3.

2. Na caixa de diálogo Escolher um modelo, selecione Em branco.

3. Escolha Selecionar para abrir o Workflow Studio emModo de design.

4. Neste tutorial, você escreverá a definição Amazon States Language (ASL) da sua máquina de estado noEditor de código. Para isso, clique em Código.

5. Remova o código clichê existente e cole o código a seguir. Na definição do estado da tarefa, lembre-se de substituir o exemplo ARNs pelas funções ARNs do Lambda que você criou.

   {
     "StartAt": "CallTestFunction1",
     "States": {
       "CallTestFunction1": {
         "Type": "Task",
         "Resource": "arn:aws:lambda:us-east-1:123456789012:function:test-function1",
         "Catch": [
           {
             "ErrorEquals": [
               "States.TaskFailed"
             ],
             "Next": "AfterTaskFailed"
           }
         ],
         "Next": "CallTestFunction2"
       },
       "CallTestFunction2": {
         "Type": "Task",
         "Resource": "arn:aws:lambda:us-east-1:123456789012:function:test-function2",
         "Catch": [
           {
             "ErrorEquals": [
               "States.TaskFailed"
             ],
             "Next": "AfterTaskFailed"
           }
         ],
         "Next": "CallTestFunction3"
       },
       "CallTestFunction3": {
         "Type": "Task",
         "Resource": "arn:aws:lambda:us-east-1:123456789012:function:test-function3",
         "TimeoutSeconds": 5,
         "Catch": [
           {
             "ErrorEquals": [
               "States.Timeout"
             ],
             "Next": "AfterTimeout"
           },
           {
             "ErrorEquals": [
               "States.TaskFailed"
             ],
             "Next": "AfterTaskFailed"
           }
         ],
         "Next": "Succeed"
       },
       "Succeed": {
         "Type": "Succeed"
       },
       "AfterTimeout": {
         "Type": "Fail"
       },
       "AfterTaskFailed": {
         "Type": "Fail"
       }
     }
   }
   

   Essa é uma descrição da máquina de estado usando a Amazon States Language. Ela define três estados Task chamados CallTestFunction1, CallTestFunction2 e CallTestFunction3. Cada uma chama uma das três funções do Lambda. Para obter mais informações, consulte Estrutura da máquina de estado.

6. Especifique um nome para a máquina de estado. Para fazer isso, escolha o ícone de edição ao lado do nome padrão da máquina de estado de MyStateMachine. Em seguida, em Configuração da máquina de estado, insira um nome na caixa Nome da máquina de estado.

   Para este tutorial, insira o nome TraceFunctions.

7. (Opcional) Em Configuração da máquina de estado, especifique outras configurações do fluxo de trabalho, como o tipo de máquina de estado e a função de execução.

   Para este tutorial, em Configurações adicionais, selecione Ativar rastreamento do X-Ray. Mantenha todas as outras seleções padrão nas configurações da máquina de estado.

   Se você já criou uma IAM função com as permissões corretas para sua máquina de estado e deseja usá-la, em Permissões, selecione Escolher uma função existente e selecione uma função na lista. Ou selecione Inserir uma função ARN e, em seguida, forneça uma ARN para essa IAM função.

8. Na caixa de diálogo Confirmar criação do perfil, selecione Confirmar para continuar.

   Você também pode escolher Exibir configurações do perfil para voltar às Configurações da máquina de estado.

   nota

   Se você excluir a IAM função criada pelo Step Functions, o Step Functions não poderá recriá-la posteriormente. Da mesma forma, se você modificar a função (por exemplo, removendo Step Functions dos principais na IAM política), o Step Functions não poderá restaurar suas configurações originais posteriormente.

1. Sobre o TraceFunctionspágina, escolha Iniciar execução.

   A página New execution é exibida.

2. Na caixa de diálogo Iniciar execução, faça o seguinte:

   1. (Opcional) Insira um nome de execução personalizado para substituir o padrão gerado.

      ASCIINão-nomes e registro

      Step Functions aceita nomes para máquinas de estado, execuções, atividades e rótulos que não contenham ASCII caracteres. Como esses caracteres não funcionarão com a Amazon CloudWatch, recomendamos usar somente ASCII caracteres para que você possa acompanhar as métricas CloudWatch.

   2. Selecione Iniciar execução.

   3. O console do Step Functions direciona você para uma página em que o título é o ID da execução. Essa página é conhecida como página de Detalhes da execução. Nesta página, você pode revisar os resultados da execução à medida que a execução avança ou após a conclusão.

      Para revisar os resultados da execução, escolha estados individuais na Exibição em gráfico e, em seguida, escolha as guias individuais no painel Detalhes da etapa para visualizar os detalhes de cada estado, incluindo entrada, saída e definição, respectivamente. Para obter detalhes sobre as informações de execução que você pode visualizar na página Detalhes da execução, consulte Visão geral dos detalhes da execução.

      Execute várias execuções (pelo menos três).

3. Depois que as execuções terminarem, acesse o link do mapa de rastreamento do X-Ray. Você pode visualizar o rastreamento enquanto a execução ainda está em andamento, porém, é interessante ver primeiro os resultados da execução antes de visualizar o mapa de rastreamento do X-Ray.

4. Visualize o mapa de serviço para identificar onde estão ocorrendo erros, conexões com alta latência ou rastreamentos de solicitações com erros. Neste exemplo, você pode ver quanto tráfego cada função está recebendo. A TestFunction2 foi chamada com mais frequência do que a TestFunction3 e a TestFunction1 foi chamada duas vezes mais do que TestFunction2.

   O mapa de serviço indica a integridade de cada nó atribuindo cores a ele com base no índice de chamadas bem-sucedidas em relação a erros e falhas:

   • Verde para chamadas bem-sucedidas

   • Vermelho para falhas do servidor (erros da série 500)

   • Amarelo para erros de clientes (erros da série 400)

   • Roxo para erros de controle de utilização (429, muitas solicitações)

   

   Você também pode escolher um nó de serviço para visualizar as solicitações desse nó ou uma borda entre dois nós para visualizar as solicitações que percorreram essa conexão.

5. Veja o mapa de rastreamento do X-Ray para ver o que aconteceu em cada execução. A visualização da linha do tempo exibe uma hierarquia de segmentos e subsegmentos. A primeira entrada na lista é o segmento, que representa todos os dados registrados pelo serviço para uma única solicitação. Os subsegmentos estão abaixo do segmento. Este exemplo mostra os subsegmentos registrados pelas funções do Lambda.

   

   Para obter mais informações sobre como entender os rastreamentos do X-Ray e usar o X-Ray com o Step Functions, consulte o O Trace Step Functions solicita dados em AWS X-Ray