View a markdown version of this page

Administrar el registro de los flujos de trabajo - AWS Transfer Family

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Administrar el registro de los flujos de trabajo

CloudWatch proporciona auditorías y registros consolidados del progreso y los resultados del flujo de trabajo. Además, AWS Transfer Family proporciona varias métricas para los flujos de trabajo. Puede ver las métricas de la cantidad de flujos de trabajo que se iniciaron, se completaron correctamente y se produjeron errores en el minuto anterior. Todas las CloudWatch métricas de Transfer Family se describen enUso de CloudWatch métricas para los servidores de Transfer Family.

AWS Transfer Family proporciona dos formas de entregar los registros de ejecución de flujos de trabajo gestionados a Amazon CloudWatch:

  • Un grupo de registros que usted especifique (destino de registro estructurado): usted especifica un grupo de CloudWatch registros como destino de registros estructurado para el flujo de trabajo y Transfer Family le entrega los registros de ejecución del flujo de trabajo a ese grupo de registros. Esta opción no requiere una función de registro. Para usarla, introduce el nombre de recurso de Amazon (ARN) de un grupo de registros en el StructuredLogDestinations parámetro al crear el flujo de trabajo (consulta StructuredLogDestinations la referencia de la AWS Transfer Family API). El grupo de registros debe estar en el mismo lugar que Cuenta de AWS el flujo Región de AWS de trabajo.

    Para configurar un destino de registro estructurado, la política de IAM del principal que crea el flujo de trabajo debe contener los siguientes permisos:

    • logs:CreateLogDelivery

    • logs:DeleteLogDelivery

    • logs:DescribeLogGroups

    • logs:DescribeResourcePolicies

    • logs:GetLogDelivery

    • logs:ListLogDeliveries

    • logs:PutResourcePolicy

    • logs:UpdateLogDelivery

  • Una función de registro: se asocia una función de registro de IAM al servidor al que está conectado el flujo de trabajo. Transfer Family asume la función de escribir los registros de ejecución del flujo de trabajo en un grupo de registros denominado/aws/transfer/server-id. Para obtener más información, consulte Configure la función de CloudWatch registro.

Ambos mecanismos escriben el mismo contenido del registro de ejecución del flujo de trabajo en el mismo formato JSON. La diferencia radica únicamente en el lugar en el que se entregan los registros: al grupo de registros que especifiques o al grupo de /aws/transfer/server-id registros del servidor mediante la función de registro.

Consulta los CloudWatch registros de Amazon para ver los flujos de trabajo

  1. Abre la CloudWatch consola de Amazon en https://console.aws.amazon.com/cloudwatch/.

  2. En el panel de navegación izquierdo, seleccione Registros y, a continuación, Grupos de registros.

  3. En la página de grupos de registro, en la barra de navegación, elige la región correcta para tu AWS Transfer Family servidor.

  4. Elija el grupo de registros que contiene los registros de su flujo de trabajo.

    • Si el flujo de trabajo usa un destino de registro estructurado, elija el grupo de registros cuyo ARN especificó en el StructuredLogDestinations parámetro del flujo de trabajo.

    • Si el flujo de trabajo usa una función de registro en el servidor, elija el grupo de registros que corresponda a su servidor. Por ejemplo, si su ID del servidor es s-1234567890abcdef0, su grupo de registros es /aws/transfer/s-1234567890abcdef0.

  5. En la página de detalles del grupo de registros, se muestran los flujos de registro más recientes. El nombre del flujo de registro del flujo de trabajo depende del mecanismo de registro que utilice el flujo de trabajo:

    • En el caso de un destino de registro estructurado, se denomina al flujo de registro del flujo de trabajoworkflowID/executionID. Por ejemplo:

      w-abcdef01234567890/021345abcdef6789

    • Para una función de registro, el grupo de registros del servidor contiene dos flujos de registro para el usuario que está explorando: uno para cada sesión del protocolo de transferencia de archivos (SFTP) de Secure Shell (SSH) y otro para el flujo de trabajo que se está ejecutando. El formato del flujo de registro del flujo de trabajo es. username.workflowID.uniqueStreamSuffix

    Por ejemplo, si su usuario es mary-major, tendrá los flujos de registro siguientes:

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

    Los identificadores alfanuméricos de 16 dígitos que se muestran en este ejemplo son ficticios. Los valores que ves en Amazon CloudWatch son diferentes.

La página de registro de eventos de un flujo de registro de flujo de trabajo contiene los detalles de la ejecución del flujo de trabajo. Si el flujo de trabajo usa una función de registro, la mary-major-usa-east.1234567890abcdef0 transmisión muestra los detalles de cada sesión de usuario y la mary.w-abcdef01234567890.021345abcdef6789 transmisión contiene los detalles del flujo de trabajo. Si el flujo de trabajo usa un destino de registro estructurado, la w-abcdef01234567890/021345abcdef6789 transmisión contiene los detalles del flujo de trabajo.

El siguiente es un ejemplo de flujo de registro para mary.w-abcdef01234567890.021345abcdef6789, basado en un flujo de trabajo (w-abcdef01234567890) que contiene un paso de copiado. 

{
    "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"
    }
}