기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Transfer Family의 CloudWatch 로그 구조
이 주제에서는 JSON 구조화된 로그 항목과 레거시 로그 항목 모두에 대해 Transfer Family 로그에 채워진 필드를 설명합니다.
**Topics**
+ [Transfer Family에 대한 JSON 구조화된 로그](#json-log-entries)
+ [Transfer Family에 대한 레거시 로그](#legacy-log-entries)
## Transfer Family에 대한 JSON 구조화된 로그
다음 표에는 Transfer Family SFTP/FTP/FTPS 작업의 로그 항목 필드에 대한 세부 정보가 새 JSON 구조화 로그 형식으로 나와 있습니다.
| 필드 | 설명 | 입력 예 |
| --- |--- |--- |
| activity-type | The action by the user | 사용 가능한 활동 유형은 `AUTH_FAILURE`, , `CONNECTED`, `DISCONNECTED`, `ERROR`, , `EXIT_REASON`, `CLOSE`, `DELETE`, `CREATE_SYMLINK``MKDIR`, `OPEN`, `PARTIAL_CLOSE`, `RENAME`, `RMDIR`, `SETSTAT`, 입니다`TLS_RESUME_FAILURE`. |
| bytes-in | Number of bytes uploaded by the user | 29238420042 |
| bytes-out | Number of bytes downloaded by the user | 23094032490328 |
| ciphers | Specifies the SSH cipher negotiated for the connection (available ciphers are listed in [암호화 알고리즘](security-policies.md#cryptographic-algorithms)) | aes256-gcm@openssh.com |
| client | The user's client software | SSH-2.0-OpenSSH\_7.4 |
| home-dir | The directory that the end user lands on when they connect to the endpoint if their home directory type is PATH: if they have a logical home directory, this value is always / | /user-home-bucket/test |
| kex | Specifies the negotiated SSH key exchange (KEX) for the connection (available KEX are listed in [암호화 알고리즘](security-policies.md#cryptographic-algorithms)) | diffie-hellman-group14-sha256 |
| message | Provides more information related to the error | {{<문자열>}} |
| method | The authentication method | publickey |
| mode | Specifies how a client opens a file | CREATE \| TRUNCATE \| WRITE |
| operation | The client operation on a file | OPEN \| CLOSE |
| path | Actual file path affected | /amzn-s3-demo-bucket/test-file-1.pdf |
| ssh-public-key | The public key body for the user that is connecting | AAAAC3NzaC1lZDI1NTE5AAAAIA9OY0qV6XYVHaaOiWAcj2spDJVbgjrqDPY4pxd6GnHl |
| ssh-public-key-fingerprint | 사용자 키를 나열할 때 서비스 관리 사용자를 위한 콘솔에 표시된 퍼블릭 키 지문입니다. 콘솔에서 지문은 패딩 문자(있는 경우): 끝에 0\~3개의 등호(=)로 표시됩니다. 로그 항목에서이 패딩은 출력에서 제거됩니다. | SHA256:BY3gNMHwTfjd4n2VuT4pTyLOk82zWZj4KEYEu7y4r/0 |
| ssh-public-key-type | Type of public key: Transfer Family supports RSA-, ECDSA-, and ED25519-formatted keys | ssh-ed25519 |
| resource-arn | A system-assigned, unique identifier for a specific resource (for example, a server) | arn:aws:transfer:ap-northeast-1:12346789012:server/s-1234567890akeu2js2 |
| role | The IAM role of the user | arn:aws:iam::0293883675:role/testuser-role |
| session-id | A system-assigned, unique identifier for a single session | 9ca9a0e1cec6ad9d |
| source-ip | Client IP address | 18.323.0.129 |
| user | The end user's username | myname192 |
| user-policy | The permissions specified for the end user: this field is populated if the user's policy is a session policy. | The JSON code for the session policy that is being used |
## Transfer Family에 대한 레거시 로그
다음 표에는 다양한 Transfer Family 작업에 대한 로그 항목에 대한 세부 정보가 나와 있습니다.
**참고**
이러한 항목은 새 JSON 구조화된 로그 형식이 아닙니다.
다음 표에는 새로운 JSON 구조화된 로그 형식의 다양한 Transfer Family 작업에 대한 로그 항목에 대한 세부 정보가 포함되어 있습니다.
| 작업 | Amazon CloudWatch Logs 내의 해당 로그 |
| --- | --- |
| 인증 실패 횟수 | ERRORS AUTH\_FAILURE Method=publickey User=lhr Message="RSA SHA256:Lfz3R2nmLY4raK\+b7Rb1rSvUIbAE\+a\+Hxg0c7l1JIZ0" SourceIP=3.8.172.211 |
| 복사/태그 지정/삭제/복호화 워크플로 | {"type":"StepStarted","details":{"input":{"fileLocation":{"backingStore":"EFS","filesystemId":"fs-12345678","path":"/lhr/regex.py"}},"stepType":"TAG","stepName":"successful\_tag\_step"},"workflowId":"w-1111aaaa2222bbbb3","executionId":"81234abcd-1234-efgh-5678-ijklmnopqr90","transferDetails":{"serverId":"s-1234abcd5678efghi","username":"lhr","sessionId":"1234567890abcdef0"}} |
| 맞춤 단계 워크플로 | {"type":"CustomStepInvoked","details":{"output":{"token":"MzM4Mjg5YWUtYTEzMy00YjIzLWI3OGMtYzU4OGI2ZjQyMzE5"},"stepType":"CUSTOM","stepName":"efs-s3\_copy\_2"},"workflowId":"w-9283e49d33297c3f7","executionId":"1234abcd-1234-efgh-5678-ijklmnopqr90","transferDetails":{"serverId":"s-zzzz1111aaaa22223","username":"lhr","sessionId":"1234567890abcdef0"}} |
| 삭제 | lhr.33a8fb495ffb383b DELETE Path=/bucket/user/123.jpg |
| 다운로드 | lhr.33a8fb495ffb383b OPEN Path=/bucket/user/123.jpg Mode=READ
llhr.33a8fb495ffb383b CLOSE Path=/bucket/user/123.jpg BytesOut=3618546 |
| 로그인/로그아웃 | user.914984e553bcddb6 CONNECTED SourceIP=1.22.111.222 User=lhr HomeDir=LOGICAL Client=SSH-2.0-OpenSSH\_7.4 Role=arn:aws::iam::123456789012:role/sftp-s3-access
user.914984e553bcddb6 DISCONNECTED |
| 명칭 바꾸기 | lhr.33a8fb495ffb383b RENAME Path=/bucket/user/lambo.png NewPath=/bucket/user/ferrari.png |
| 샘플 워크플로 오류 로그 | {"type":"StepErrored","details":{"errorType":"BAD\_REQUEST","errorMessage":"Cannot tag Efs file","stepType":"TAG","stepName":"successful\_tag\_step"},"workflowId":"w-1234abcd5678efghi","executionId":"81234abcd-1234-efgh-5678-ijklmnopqr90","transferDetails":{"serverId":"s-1234abcd5678efghi","username":"lhr","sessionId":"1234567890abcdef0"}} |
| Symlinks | lhr.eb49cf7b8651e6d5 CREATE\_SYMLINK LinkPath=/fs-12345678/lhr/pqr.jpg TargetPath=abc.jpg |
| 업로드 | lhr.33a8fb495ffb383b OPEN Path=/bucket/user/123.jpg Mode=CREATE\|TRUNCATE\|WRITE
lhr.33a8fb495ffb383b CLOSE Path=/bucket/user/123.jpg BytesIn=3618546 |
| 워크플로 | {"type":"ExecutionStarted","details":{"input":{"initialFileLocation":{"backingStore":"EFS","filesystemId":"fs-12345678","path":"/lhr/regex.py"}}},"workflowId":"w-1111aaaa2222bbbb3","executionId":"1234abcd-1234-efgh-5678-ijklmnopqr90","transferDetails":{"serverId":"s-zzzz1111aaaa22223","username":"lhr","sessionId":"1234567890abcdef0"}}
{"type":"StepStarted","details":{"input":{"fileLocation":{"backingStore":"EFS","filesystemId":"fs-12345678","path":"/lhr/regex.py"}},"stepType":"CUSTOM","stepName":"efs-s3\_copy\_2"},"workflowId":"w-9283e49d33297c3f7","executionId":"1234abcd-1234-efgh-5678-ijklmnopqr90","transferDetails":{"serverId":"s-18ca49dce5d842e0b","username":"lhr","sessionId":"1234567890abcdef0"}} |