故障排除 Session Manager

可以使用以下信息来帮助解决 AWS Systems Manager Session Manager 问题。

文档处理意外失败：文档工作线程超时

问题：启动与 Linux 主机的会话时，Systems Manager 返回以下错误：

document process failed unexpectedly: document worker timed out, 
check [ssm-document-worker]/[ssm-session-worker] log for crash reason

如果您配置了SSM Agent 日志记录（如 查看 SSM Agent 日志 中所述），则可以在调试日志中查看更多详细信息。对于此问题，Session Manager 显示以下日志条目：

failed to create channel: too many open files

此错误通常表示运行的 Session Manager 工作线程进程过多，底层操作系统达到了极限。您有两个选项来解决此问题。

解决方案 A：提高操作系统文件通知限制

您可以在单独的 Linux 主机上运行以下命令来提高限制。该命令使用 Systems Manager Run Command。指定值会将 max_user_instances 增加到 8192。此值远高于默认值 128，但它不会占用主机资源：

aws ssm send-command --document-name AWS-RunShellScript \
--instance-id i-02573cafcfEXAMPLE  --parameters \
"commands=sudo sysctl fs.inotify.max_user_instances=8192"

解决方案 B：减少 Session Manager 在目标主机中使用的文件通知

在单独的 Linux 主机上运行以下命令，以列出目标主机上运行的会话：

aws ssm describe-sessions --state Active --filters key=Target,value=i-02573cafcfEXAMPLE

查看命令输出，以确定不再需要的会话。您可以在单独的 Linux 主机上运行以下命令来终止这些会话：

aws ssm terminate-session —session-id session ID

或者，一旦远程服务器上不再运行会话，您可以通过在单独的 Linux 主机上运行以下命令来释放更多资源。此命令将终止远程主机上运行的所有 Session Manager 进程，从而终止与远程主机的所有会话。在运行此命令之前，请确认没有要保留的正在进行的会话：

aws ssm send-command --document-name AWS-RunShellScript \
            --instance-id i-02573cafcfEXAMPLE --parameters \
'{"commands":["sudo kill $(ps aux | grep ssm-session-worker | grep -v grep | awk '"'"'{print $2}'"'"')"]}'

Session Manager 无法从 Amazon EC2 控制台连接

问题：创建新实例后，Amazon Elastic Compute Cloud（Amazon EC2）控制台中的会话管理器选项卡不提供连接选项。

解决方案 A：创建实例配置文件：如果您尚未执行此操作（按照 EC2 控制台中会话管理器选项卡上的信息的说明），使用 Quick Setup 创建 AWS Identity and Access Management（IAM）实例配置文件。Quick Setup 是 AWS Systems Manager 的一个功能。

Session Manager 需要 IAM 实例配置文件才能连接到实例。您可以使用 Quick Setup 创建主机管理配置，以创建实例配置文件并将其分配给实例。主机管理配置创建具有所需权限的实例配置文件并将其分配给实例。主机管理配置还可以启用其他 Systems Manager 功能，并创建用于运行这些功能的 IAM 角色。使用 Quick Setup 或主机管理配置启用的功能不会产生任何费用。打开 Quick Setup 并创建主机管理配置。

如果在创建主机管理配置后仍然无法连接，或者收到错误（包括关于 SSM Agent 的错误），请参阅以下解决方案之一：

解决方案 B：没有错误，但仍然无法连接

如果您创建了主机管理配置，等待了几分钟才尝试连接，但仍然无法连接，则可能需要手动将主机管理配置应用于实例。使用以下过程更新 Quick Setup 主机管理配置并将更改应用于实例。

等待几分钟，让 EC2 刷新会话管理器选项卡。如果仍然无法连接或收到错误，请查看该问题的其余解决方案。

解决方案 C：关于缺失 SSM Agent 的错误

如果您无法使用 Quick Setup 创建主机管理配置，或者收到有关未安装 SSM Agent 的错误，则可能需要在实例上手动安装 SSM Agent。SSM Agent 是 Amazon 软件，它允许 Systems Manager 通过使用 Session Manager 连接到实例。SSM Agent 默认安装在大多数亚马逊机器映像（AMI）上。如果您的实例是从非标准 AMI 或较旧的 AMI 创建的，则可能需要手动安装代理。有关安装 SSM Agent 的过程，请参阅以下与您的实例操作系统相对应的主题。

有关 SSM Agent 的问题，请参阅 故障排除 SSM Agent。

没有启动会话的权限

问题：您尝试启动会话，但系统提示您没有必要的权限。

SSM Agent 不在线

问题：您在 Amazon EC2 实例 Session Manager 选项卡上看到一条消息，表明：SSM Agent 不在线。SSM Agent 不能够连接到 Systems Manager 端点以将其自身注册到服务中。

解决方案：SSM Agent 是在 Amazon EC2 实例上运行的 Amazon 软件，从而 Session Manager 可以与其建立连接。如果您看到此错误，则 SSM Agent 不能够建立与 Systems Manager 端点的连接。问题的根源可能是防火墙限制、路由问题或互联网连接不足。要解决此问题，请调查网络连接问题。

没有更改会话首选项的权限

问题：您尝试更新组织的全局会话首选项，但系统提示您没有必要的权限。

托管式节点不可用或未为 Session Manager 配置托管式节点

问题 1：您要在 Start a session（启动会话）控制台页面上启动一个会话，但托管式节点不在列表中。

问题 2：Start a session（开启会话）控制台页面上的列表中显示了要连接的托管式节点，但页面报告“The instance you selected isn't configured to use Session Manager”（您选择的实例未配置为使用 ）。

未找到 Session Manager 插件

要使用 AWS CLI 运行会话命令，还必须在本地计算机上安装 Session Manager 插件。有关更多信息，请参阅 为 AWS CLI 安装 Session Manager 插件。

Session Manager 插件未自动添加到命令行路径（Windows）

在 Windows 上安装 Session Manager 插件时，session-manager-plugin 可执行文件应自动添加到操作系统的 PATH 环境变量中。如果在运行检查是否正确安装了 Session Manager 插件的命令后命令失败 (aws ssm start-session --target instance-id)，则需要使用以下过程进行手动设置。

Session Manager 插件变得没有响应

如果您的本地计算机上安装了防病毒软件，在端口转发会话期间，可能会停止转发流量。在某些情况下，防病毒软件会干扰 Session Manager 插件，从而导致进程死锁。要解决此问题，请在防病毒软件中设置允许 Session Manager 插件或将其排除在外。有关 Session Manager 插件的默认安装路径的信息，请参阅 为 AWS CLI 安装 Session Manager 插件。

TargetNotConnected

问题：您尝试启动会话，但系统返回错误消息：“An error occurred (TargetNotConnected) when calling the StartSession operation: InstanceID isn't connected.”（调用 StartSession 操作时发生错误 (TargetNotConnected)：InstanceID 未连接。）

启动会话后显示空白屏幕

问题：在您启动会话后，Session Manager 显示空白屏幕。

托管式节点在长时间运行会话期间变得没有响应

问题：在长时间运行会话期间，托管式节点变得没有响应或崩溃。

解决方案：减少 Session Manager 的 SSM Agent 日志保留时间。

调用 StartSession 操作时出现错误（InvalidDocument）

问题：使用 AWS CLI 启动会话时，您会收到以下错误。

An error occurred (InvalidDocument) when calling the StartSession operation: Document type: 'Command' is not supported. Only type: 'Session' is supported for Session Manager.

解决方案：您为 --document-name 参数指定的 SSM 文档不是会话文档。请按照以下过程在 AWS Management Console 中查看会话文档列表。