• AWS Systems Manager CloudWatch 대시보드는 2026년 4월 30일 이후에는 더 이상 사용할 수 없습니다. 고객은 Amazon CloudWatch 콘솔을 계속 사용하여 현재와 마찬가지로 Amazon CloudWatch 대시보드를 보고, 생성하고, 관리할 수 있습니다. 자세한 내용은 [Amazon CloudWatch 대시보드 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)를 참조하세요.

# 디스크에 세션 로깅 구성
<a name="session-manager-logging-disk"></a>

CloudWatch 또는 Amazon S3에 Session Manager 로깅을 활성화하면 세션 중에 실행되는 모든 명령(및 해당 명령의 결과 출력)이 대상 인스턴스의 디스크에 있는 임시 파일에 로깅됩니다. 임시 파일의 이름은 `ipcTempFile.log`입니다.

`ipcTempFile.log`는 SSM Agent 구성 파일의 `SessionLogsDestination` 파라미터에 의해 제어됩니다. 이 파라미터는 다음 값 중 하나를 수락합니다.
+ **디스크**: 이 파라미터를 지정하고 CloudWatch 또는 Amazon S3에 대한 세션 로깅이 **활성화된 경우 SSM Agent는 `ipcTempFile.log` 임시 로그 파일을 생성하고 세션 명령을 로깅하고 디스크에 출력합니다. Session Manager는 로깅 구성에 따라 세션 중 또는 세션 후에 해당 로그를 CloudWatch 또는 S3에 업로드합니다. 그런 다음 로그는 SSM Agent `SessionLogsRetentionDurationHours` 구성 파라미터에 지정된 기간에 따라 삭제됩니다.

  이 파라미터를 지정하고 CloudWatch 및 Amazon S3에 대한 세션 로깅을 *비활성화*하더라도 SSM Agent는 명령 기록 및 출력은 `ipcTempFile.log` 파일에 계속 로깅됩니다. 파일은 구성 SSM Agent `SessionLogsRetentionDurationHours` 파라미터에 지정된 기간에 따라 삭제됩니다.
+ **없음**: 이 파라미터를 지정하고 CloudWatch 또는 Amazon S3에 대한 세션 로깅이 *활성화*된 경우 디스크에 대한 로깅은 `disk` 파라미터를 지정한 것과 동일하게 작동합니다. SSM Agent는 CloudWatch 또는 Amazon S3에 대한 세션 로깅이 활성화된 경우 임시 파일을 필요로 합니다.

  이 파라미터를 지정하고 CloudWatch 또는 Amazon S3에 대한 세션 로깅이 *비활성화*된 경우 SSM Agent는 `ipcTempFile.log` 파일을 생성하지 않습니다.

다음 절차에 따라 세션이 시작되는 경우 디스크에 대해 `ipcTempFile.log` 임시 로그 파일 생성을 활성화 또는 비활성화할 수 있습니다.

**디스크에 대한 Session Manager 임시 로그 파일 생성을 활성화 또는 비활성화하려면**

1. 인스턴스에 SSM Agent를 설치하거나 버전 3.2.2086 이상으로 업그레이드합니다. 에이전트 버전 번호를 확인하는 방법에 대한 자세한 내용은 [SSM Agent 버전 번호 확인](ssm-agent-get-version.md) 섹션을 참조하세요. 에이전트를 수동으로 설치하는 방법에 대한 자세한 내용은 다음 섹션에서 운영 체제의 절차를 참조하세요.
   + [Linux용 EC2 인스턴스에 수동으로 SSM Agent 설치 및 제거](manually-install-ssm-agent-linux.md)
   + [SSM Agent용 EC2 인스턴스에 수동으로 macOS 설치 및 제거](manually-install-ssm-agent-macos.md)
   + [SSM Agent용 EC2 인스턴스에 수동으로 Windows Server 설치 및 제거](manually-install-ssm-agent-windows.md)

1. 인스턴스에 연결하고 다음 위치에서 `amazon-ssm-agent.json` 파일을 찾습니다.
   + **Linux**: /etc/amazon/ssm/
   + **macOS**: /opt/aws/ssm/
   + **Windows Server**: C:\$1Program Files\$1Amazon\$1SSM

   `amazon-ssm-agent.json` 파일이 없는 경우 `amazon-ssm-agent.json.template`의 콘텐츠를 동일한 디렉터리에 있는 새 파일에 복사합니다. 새 파일의 이름을 `amazon-ssm-agent.json`으로 바꿉니다.

1. `SessionLogsDestination` 파라미터에 대해 `none` 또는 `disk`를 지정합니다. 변경 내용을 저장합니다.

1. SSM Agent를 [다시 시작](https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-agent-status-and-restart.html)합니다.

`SessionLogsDestination` 파라미터에 `disk`를 지정한 경우 새 세션을 시작한 후 다음 위치에서 `ipcTempFile.log`를 찾아 SSM Agent가 임시 로그 파일을 생성하는지 확인할 수 있습니다.
+ **Linux**: /var/lib/amazon/ssm/*target ID*/session/orchestration/*session ID*/Standard\$1Stream/ipcTempFile.log
+ **macOS**: /opt/aws/ssm/data/*target ID*/session/orchestration/*session ID*/Standard\$1Stream/ipcTempFile.log
+ **Windows Server**: C:\$1ProgramData\$1Amazon\$1SSM\$1InstanceData\$1*target ID*\$1session\$1orchestration\$1*session ID*\$1Standard\$1Stream\$1ipcTempFile.log

**참고**  
기본적으로 임시 로그 파일은 14일 동안 인스턴스에 저장됩니다.

여러 인스턴스에서 `SessionLogsDestination` 파라미터를 업데이트하려면 새 구성을 지정하는 SSM 문서를 생성하는 것이 좋습니다. 그런 다음 Systems Manager Run Command를 사용하여 인스턴스에 변경 사항을 구현할 수 있습니다. 자세한 내용은 [자체 AWS Systems Manager 문서 작성(블로그)](https://aws.amazon.com/blogs/mt/writing-your-own-aws-systems-manager-documents/) 및 [관리형 노드에서 명령 실행](running-commands.md) 섹션을 참조하세요.