View a markdown version of this page

Gerenciando o registro de fluxos de trabalho - AWS Transfer Family

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

Gerenciando o registro de fluxos de trabalho

CloudWatch fornece auditoria e registro consolidados do progresso e dos resultados do fluxo de trabalho. Além disso, AWS Transfer Family fornece várias métricas para fluxos de trabalho. Você pode visualizar métricas de quantas execuções de fluxos de trabalho foram iniciadas, concluídas com êxito e falharam no minuto anterior. Todas as CloudWatch métricas da Transfer Family estão descritas emUsando CloudWatch métricas para servidores da família Transfer.

AWS Transfer Family fornece duas maneiras de entregar registros gerenciados de execução de fluxo de trabalho para a Amazon CloudWatch:

  • Um grupo de registros que você especifica (destino de registro estruturado) — Você especifica um grupo de CloudWatch registros como um destino de registro estruturado para o fluxo de trabalho, e a Transfer Family entrega os registros de execução do fluxo de trabalho para esse grupo de registros para você. Essa opção não exige uma função de registro. Para usá-lo, forneça o nome de recurso da Amazon (ARN) de um grupo de logs no StructuredLogDestinations parâmetro ao criar o fluxo de trabalho (consulte StructuredLogDestinations na Referência da AWS Transfer Family API). O grupo de registros deve estar no mesmo Conta da AWS e Região da AWS do fluxo de trabalho.

    Para configurar um destino de registro estruturado, a política do IAM para o principal que cria o fluxo de trabalho deve conter as seguintes permissões:

    • logs:CreateLogDelivery

    • logs:DeleteLogDelivery

    • logs:DescribeLogGroups

    • logs:DescribeResourcePolicies

    • logs:GetLogDelivery

    • logs:ListLogDeliveries

    • logs:PutResourcePolicy

    • logs:UpdateLogDelivery

  • Uma função de registro — Você anexa uma função de registro do IAM ao servidor ao qual o fluxo de trabalho está vinculado. A Transfer Family assume a função de gravar os registros de execução do fluxo de trabalho em um grupo de registros chamado/aws/transfer/server-id. Para obter detalhes, consulte Configurar a função de CloudWatch registro.

Ambos os mecanismos gravam o mesmo conteúdo do log de execução do fluxo de trabalho no mesmo formato JSON. A diferença é somente onde os registros são entregues: para o grupo de registros que você especificar ou para o grupo de /aws/transfer/server-id registros no servidor por meio da função de registro.

Visualize CloudWatch os registros da Amazon para fluxos de trabalho

  1. Abra o CloudWatch console da Amazon em https://console.aws.amazon.com/cloudwatch/.

  2. No painel de navegação à esquerda, escolha Logs e, em seguida, escolha Grupos de logs.

  3. Na página Grupos de registros, na barra de navegação, escolha a região correta para seu AWS Transfer Family servidor.

  4. Escolha o grupo de registros que contém seus registros de fluxo de trabalho.

    • Se o fluxo de trabalho usar um destino de registro estruturado, escolha o grupo de registros cujo ARN você especificou no StructuredLogDestinations parâmetro do fluxo de trabalho.

    • Se o fluxo de trabalho usar uma função de registro no servidor, escolha o grupo de registros que corresponde ao seu servidor. Por exemplo, se o ID do seu servidor for s-1234567890abcdef0, seu grupo de logs será /aws/transfer/s-1234567890abcdef0.

  5. Na página de detalhes do grupo de registros, os fluxos de log mais recentes são exibidos. O nome do fluxo de log para o fluxo de trabalho depende de qual mecanismo de registro o fluxo de trabalho usa:

    • Para um destino de registro estruturado, o fluxo de registros do fluxo de trabalho é nomeadoworkflowID/executionID. Por exemplo:

      w-abcdef01234567890/021345abcdef6789

    • Para uma função de registro, o grupo de log do servidor contém dois fluxos de log para o usuário que você está explorando: um para cada sessão do Secure Shell (SSH) File Transfer Protocol (SFTP) e um para o fluxo de trabalho que está sendo executado. O formato do fluxo de log do fluxo de trabalho éusername.workflowID.uniqueStreamSuffix.

    Por exemplo, se o seu usuário é mary-major, você terá os seguintes fluxos de logs:

    mary-major-east.1234567890abcdef0
mary.w-abcdef01234567890.021345abcdef6789
    nota

    Os identificadores alfanuméricos de 16 dígitos listados neste exemplo são fictícios. Os valores que você vê na Amazon CloudWatch são diferentes.

A página Registrar eventos de um fluxo de log de fluxo de trabalho contém os detalhes da execução do fluxo de trabalho. Se o fluxo de trabalho usar uma função de registro, o mary-major-usa-east.1234567890abcdef0 fluxo exibirá os detalhes de cada sessão do usuário e conterá os detalhes do fluxo de trabalho. mary.w-abcdef01234567890.021345abcdef6789 Se o fluxo de trabalho usar um destino de registro estruturado, o w-abcdef01234567890/021345abcdef6789 fluxo conterá os detalhes do fluxo de trabalho.

Veja a seguir um exemplo de fluxo de logs para o mary.w-abcdef01234567890.021345abcdef6789, com base em um fluxo de trabalho (w-abcdef01234567890) que contém uma etapa de cópia. 

{
    "type": "ExecutionStarted",
    "details": {
        "input": {
            "initialFileLocation": {
                "bucket": "amzn-s3-demo-bucket",
                "key": "mary/workflowSteps2.json",
                "versionId": "version-id",
                "etag": "etag-id"
            }
        }
    },
    "workflowId":"w-abcdef01234567890",
    "executionId":"execution-id",
    "transferDetails": {
        "serverId":"s-server-id",
        "username":"mary",
        "sessionId":"session-id"
    }
},
{
    "type":"StepStarted",
    "details": {
        "input": {
            "fileLocation": {
                "backingStore":"S3",
                "bucket":"amzn-s3-demo-bucket",
                "key":"mary/workflowSteps2.json",
                "versionId":"version-id",
                "etag":"etag-id"
            }
        },
        "stepType":"COPY",
        "stepName":"copyToShared"
    },
    "workflowId":"w-abcdef01234567890",
    "executionId":"execution-id",
    "transferDetails": {
        "serverId":"s-server-id",
        "username":"mary",
        "sessionId":"session-id"
    }
},
{
    "type":"StepCompleted",
    "details":{
        "output":{},
        "stepType":"COPY",
        "stepName":"copyToShared"
    },
    "workflowId":"w-abcdef01234567890",
    "executionId":"execution-id",
    "transferDetails":{
        "serverId":"server-id",
        "username":"mary",
        "sessionId":"session-id"
    }
},
{
    "type":"ExecutionCompleted",
    "details": {},
    "workflowId":"w-abcdef01234567890",
    "executionId":"execution-id",
    "transferDetails":{
        "serverId":"s-server-id",
        "username":"mary",
        "sessionId":"session-id"
    }
}