View a markdown version of this page

Mengelola logging untuk alur kerja - AWS Transfer Family

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

Mengelola logging untuk alur kerja

CloudWatch menyediakan audit dan pencatatan konsolidasi untuk kemajuan dan hasil alur kerja. Selain itu, AWS Transfer Family menyediakan beberapa metrik untuk alur kerja. Anda dapat melihat metrik berapa banyak alur kerja eksekusi dimulai, berhasil diselesaikan, dan gagal pada menit sebelumnya. Semua met CloudWatch rik untuk Transfer Family dijelaskan diMenggunakan CloudWatch metrik untuk server Transfer Family.

AWS Transfer Family menyediakan dua cara untuk mengirimkan log eksekusi alur kerja terkelola ke Amazon CloudWatch:

  • Grup log yang Anda tentukan (tujuan log terstruktur) — Anda menentukan grup CloudWatch log log sebagai tujuan log terstruktur untuk alur kerja, dan Transfer Family mengirimkan log eksekusi alur kerja ke grup log tersebut untuk Anda. Opsi ini tidak memerlukan peran logging. Untuk menggunakannya, berikan Amazon Resource Name (ARN) dari grup log di StructuredLogDestinations parameter saat Anda membuat alur kerja (lihat StructuredLogDestinations di Refer AWS Transfer Family ensi API). Grup log harus sama Akun AWS dan Wilayah AWS seperti alur kerja.

    Untuk mengonfigurasi tujuan log terstruktur, kebijakan IAM untuk prinsipal yang membuat alur kerja harus berisi izin berikut:

    • logs:CreateLogDelivery

    • logs:DeleteLogDelivery

    • logs:DescribeLogGroups

    • logs:DescribeResourcePolicies

    • logs:GetLogDelivery

    • logs:ListLogDeliveries

    • logs:PutResourcePolicy

    • logs:UpdateLogDelivery

  • Peran pencatatan — Anda melampirkan peran pencatatan IAM ke server tempat alur kerja dilampirkan. Transfer Family mengambil peran untuk menulis log eksekusi alur kerja ke grup log bernama/aws/transfer/server-id. Lihat perinciannya di Konfigur CloudWatch asikan peran logging.

Kedua mekanisme menulis konten log eksekusi alur kerja yang sama dalam format JSON yang sama. Perbedaannya hanya di mana log dikirimkan: ke grup log yang Anda tentukan, atau ke grup /aws/transfer/server-id log di server melalui peran logging.

Lihat CloudWatch log Amazon untuk alur kerja

  1. Buka CloudWatch konsol Amazon di https://console.aws.amazon.com/cloudwatch/.

  2. Di panel navigasi kiri, pilih Log, lalu pilih Grup log.

  3. Pada halaman Grup log, pada bilah navigasi, pilih Wilayah yang benar untuk AWS Transfer Family server Anda.

  4. Pilih grup log yang berisi log alur kerja Anda.

    • Jika alur kerja menggunakan tujuan log terstruktur, pilih grup log yang ARN-nya Anda tentukan dalam StructuredLogDestinations parameter alur kerja.

    • Jika alur kerja menggunakan peran logging di server, pilih grup log yang sesuai dengan server Anda. Misalnya, jika ID server Anda adalahs-1234567890abcdef0, grup log Anda adalah/aws/transfer/s-1234567890abcdef0.

  5. Pada halaman detail grup log, aliran log terbaru ditampilkan. Nama aliran log untuk alur kerja tergantung pada mekanisme pencatatan mana yang digunakan alur kerja:

    • Untuk tujuan log terstruktur, aliran log alur kerja diberi namaworkflowID/executionID. Contoh:

      w-abcdef01234567890/021345abcdef6789

    • Untuk peran logging, grup log server berisi dua aliran log untuk pengguna yang Anda jelajahi: satu untuk setiap sesi Secure Shell (SSH) File Transfer Protocol (SFTP), dan satu untuk alur kerja yang sedang dijalankan. Format untuk aliran log alur kerja adalahusername.workflowID.uniqueStreamSuffix.

    Misalnya, jika pengguna Andamary-major, Anda memiliki aliran log berikut:

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

    Pengidentifikasi alfanumerik 16 digit yang tercantum dalam contoh ini adalah fiktif. Nilai yang Anda lihat di Amazon CloudWatch berbeda.

Halaman peristiwa Log untuk aliran log alur kerja berisi detail untuk eksekusi alur kerja. Jika alur kerja menggunakan peran logging, mary-major-usa-east.1234567890abcdef0 aliran menampilkan detail untuk setiap sesi pengguna, dan mary.w-abcdef01234567890.021345abcdef6789 aliran berisi detail untuk alur kerja. Jika alur kerja menggunakan tujuan log terstruktur, w-abcdef01234567890/021345abcdef6789 aliran berisi detail alur kerja.

Berikut ini adalah contoh aliran log untukmary.w-abcdef01234567890.021345abcdef6789, berdasarkan alur kerja (w-abcdef01234567890) yang berisi langkah salin. 

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