版本类型操作系统要求附属物配置用量本地日志文件更改日志

本地调试控制台

本地调试控制台组件 (aws.greengrass.LocalDebugConsole) 提供了一个本地控制面板，其中显示有关您的Amazon IoT Greengrass核心设备及其组件。您可以使用此仪表板调试核心设备和管理本地组件。

重要

我们建议您只在开发环境中使用此组件，而不要在生产环境中使用。通过此组件，您可以访问在生产环境中通常不需要的信息和操作。遵循最低特权原则，只在您需要的核心设备上部署此组件。

主题

版本
类型
操作系统
要求
附属物
配置
用量
本地日志文件
更改日志

版本

此组件具有以下版本：

2.2.x
2.1.x
2.0.x

类型

这个组件是一个插件组件 (aws.greengrass.plugin)。这些区域有：Greengrass在与核心相同的Java 虚拟机 (JVM) 中运行此组件。当您在核心设备上更改此组件的版本时，nucleus 会重新启动。

该组件使用与Greengrass 核相同的日志文件。有关更多信息，请参阅显示器Amazon IoT Greengrass圆木。

有关更多信息，请参阅组件类型。

操作系统

此组件可以安装在运行以下操作系统的核心设备上：

Linux
Windows

要求

此组件具有以下要求：

您可以使用用户名和密码来登录控制面板。用户名，即debug，，是为你提供的。您必须使用Amazon IoT GreengrassCLI 创建临时密码，用于在核心设备上使用仪表板对您进行身份验证。您必须能够使用Amazon IoT Greengrass使用本地调试控制台的 CLI。有关更多信息，请参阅。Greengrass CLI 要求. 有关如何生成密码和登录的更多信息，请参阅本地调试控制台组件用法.

附属物

部署组件时，Amazon IoT Greengrass还部署了其依赖项的兼容版本。这意味着您必须满足组件及其所有依赖项的要求才能成功部署该组件。本部分列出了的依赖项发布版本以及定义每个依赖项的组件版本的语义版本约束。您也可以在组件的每个版本中查看组件的依赖项Amazon IoT Greengrass控制台. 在组件详细信息页面上，查找依赖项list.

2.2.5

下表列出了此组件 2.2.5 版的依赖关系。

依赖关系	兼容的版本版本	依赖关系类型
Greengrass	>=2.1.0	硬性
Greengrass	>=2.1.0	硬性

2.2.4

下表列出了此组件版本 2.2.2.4 的依赖项。

依赖关系	兼容的版本版本	依赖关系类型
Greengrass	>=2.1.0	硬性
Greengrass	>=2.1.0	硬性

2.2.3

下表列出了此组件 2.2.3 版的依赖关系。

依赖关系	兼容的版本版本	依赖关系类型
Greengrass	>=2.1.0	硬性
Greengrass	>=2.1.0	硬性

2.2.2

下表列出了此组件版本 2.2.2.2 的依赖项。

依赖关系	兼容的版本版本	依赖关系类型
Greengrass	>=2.1.0	硬性
Greengrass	>=2.1.0	硬性

2.2.1

下表列出了此组件 2.2.1 版的依赖关系。

依赖关系	兼容的版本版本	依赖关系类型
Greengrass	>=2.1.0	硬性
Greengrass	>=2.1.0	硬性

2.2.0

下表列出了此组件版本 2.2.2.2.0 的依赖项。

依赖关系	兼容的版本版本	依赖关系类型
Greengrass	>=2.1.0	硬性
Greengrass	>=2.1.0	硬性

2.1.0

下表列出了此组件版本 2.1.0 的依赖项。

依赖关系	兼容的版本版本	依赖关系类型
Greengrass	>=2.1.0	硬性
Greengrass	>=2.1.0	硬性

2.0.x

下表列出了此组件 2.0.x 版的依赖关系。

依赖关系	兼容的版本版本	依赖关系类型
Greengrass	>=2.0.3	软性
Greengrass	>=2.0.3	软性

有关组件依赖项的更多信息，请参阅组件配方参考.

配置

此组件提供以下配置参数，您可以在部署组件时对其进行自定义。

v2.1.x - v2.2.x

httpsEnabled

（可选）您可以为本地调试控制台启用 HTTPS 通信。如果您启用 HTTTPS 通信，则本地调试控制台将创建自签名证书。Web 浏览器会针对使用自签名证书的 Web 站点显示安全警告，因此您必须手动验证证书。然后，你可以绕过警告。有关更多信息，请参阅用量。

默认值：true

port

（可选）提供本地调试控制台的端口。

默认值：1441

websocketPort

（可选）用于本地调试控制台的 websocket 端口。

默认值：1442

bindHostname

（可选）用于本地调试控制台的主机名。

如果您运行Amazon IoT GreengrassDocker 容器中的核心软件，，将该参数设置为0.0.0.0，这样你就可以在 Docker 容器之外打开本地调试控制台。

默认值：localhost

例如：配置合并更新

以下示例配置指定在非默认端口上打开本地调试控制台并禁用 HTTPS。


{
  "httpsEnabled": false,
  "port": "10441",
  "websocketPort": "10442"
}

v2.0.x

port

（可选）提供本地调试控制台的端口。

默认值：1441

websocketPort

（可选）用于本地调试控制台的 websocket 端口。

默认值：1442

bindHostname

（可选）用于本地调试控制台的主机名。

如果您运行Amazon IoT GreengrassDocker 容器中的核心软件，，将该参数设置为0.0.0.0，这样你就可以在 Docker 容器之外打开本地调试控制台。

默认值：localhost

例如：配置合并更新

以下示例配置指定在非默认端口上打开本地调试控制台。


{
  "port": "10441",
  "websocketPort": "10442"
}

用量

要使用本地调试控制台，请从 Greengrass CLI 创建一个会话。创建会话时，Greengrass CLI 会提供用户名和临时密码，您可以使用这些用户名和临时密码登录到本地调试控制台。

按照以下说明在核心设备或开发计算机上打开本地调试控制台。

v2.1.x - v2.2.x

在版本 2.1.0 及更高版本中，本地调试控制台默认使用 HTTPTPS。启用 HTTPS 后，本地调试控制台将创建自签名证书来确保连接。由于此自签名证书，当您打开本地调试控制台时，Web 浏览器会显示安全警告。使用 Greengrass CLI 创建会话时，输出包含证书的指纹，因此您可以验证证书是否合法以及连接是否安全。

您可以禁用 HTTPS。有关更多信息，请参阅。本地调试控制台配置.

打开本地调试控制台

（可选）要在开发计算机上查看本地调试控制台，可以通过 SSH 转发控制台的端口。但您必须先启用AllowTcpForwarding选项位于核心设备的 SSH 配置文件中。默认情况下，此选项处于启用状态。在开发计算机上运行以下命令，查看控制面板localhost:1441在开发计算机上。
```
ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address
```
注意
您可以更改默认端口1441和1442. 有关更多信息，请参阅。本地调试控制台配置.
创建会话以使用本地调试控制台。创建会话时，会生成用于进行身份验证的密码。本地调试控制台需要密码才能提高安全性，因为您可以使用此组件在核心设备上查看重要信息并执行操作。如果您在组件配置中启用 HTTPS，本地调试控制台还会创建一个证书来保护连接。默认情况下，HTTPTPS 已启用。

使用Amazon IoT GreengrassCLI 来创建会话。此命令会生成一个 43 个字符的随机密码，该密码将在 8 小时后过期。Replace/greengrass/v2要么C:\greengrass\v2还有通往Amazon IoT Greengrass V2根文件夹。
Linux or UnixWindows
Linux or Unix
```
sudo /greengrass/v2/bin/greengrass-cli get-debug-password
```
Windows
```
C:\greengrass\v2\bin\greengrass-cli get-debug-password
```
如果您已将本地调试控制台配置为使用 HTTPS，则命令输出与以下示例类似。打开本地调试控制台时，您可以使用证书指纹来验证连接是否安全。
```
Username: debug
Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE
Password expires at: 2021-04-01T17:01:43.921999931-07:00
The local debug console is configured to use TLS security. The certificate is self-signed so you will need to bypass your web browser's security warnings to open the console.
Before you bypass the security warning, verify that the certificate fingerprint matches the following fingerprints.
SHA-256: 15 0B 2C E2 54 8B 22 DE 08 46 54 8A B1 2B 25 DE FB 02 7D 01 4E 4A 56 67 96 DA A6 CC B1 D2 C4 1B
SHA-1: BC 3E 16 04 D3 80 70 DA E0 47 25 F9 90 FA D6 02 80 3E B5 C1
```
调试视图组件创建一个持续 8 小时的会话。之后，您必须生成新的密码才能再次查看本地调试控制台。
打开并登录控制面板。在 Greengrass 核心设备或开发计算机上查看仪表板（如果您通过 SSH 转发端口）。请执行下列操作之一：
- 如果您在本地调试控制台中启用了 HTTPS（默认设置），请执行以下操作：
  1. 打开https://localhost:1441在核心设备上；如果您通过 SSH 转发端口，则在开发计算机上。
    
    您的浏览器可能会显示有关安全证书无效的安全警告。
  2. 如果您的浏览器显示安全警告，请验证证书是否合法并绕过安全警告。执行以下操作：
    1. 找到证书的 SHA-256 或 SHA-1 指纹，并验证它是否与 SHA-256 或 SHA-1 指纹匹配get-debug-password命令先前已打印。您的浏览器可能会提供一个或两个指纹。请查阅浏览器的文档以查看证书及其指纹。在某些浏览器中，证书指纹称为指纹。
      
      注意
      否则，请转到步骤 2创建新的会话。如果证书指纹仍然不匹配，则说明您的连接可能不安全。
    2. 如果证书指纹匹配，请绕过浏览器的安全警告，打开本地调试控制台。请查阅浏览器的文档以绕过浏览器安全警告。
  3. 使用用户名和密码登录网站get-debug-password命令早些时候打印。
    
    本地调试控制台将打开。
  4. 如果本地调试控制台显示错误，指出它无法连接到 WebSocket 由于 TLS 握手失败，您必须绕过自签名安全警告 WebSocket URL.
    
    执行以下操作：
    1. 打开https://localhost:1442在打开本地调试控制台的同一个浏览器中。
    2. 验证证书并绕过安全警告。
      
      绕过警告后，您的浏览器可能会显示 HTTP 404 页面。
    3. 打开https://localhost:1441。
      
      本地调试控制台显示有关核心设备的信息。
- 如果您在本地调试控制台中禁用 HTTPTPS，请执行以下操作：
  1. 打开http://localhost:1441在核心设备上，或者如果您通过 SSH 转发端口，请在开发计算机上将其打开。
  2. 使用用户名和密码登录网站get-debug-password命令先前已打印。
    
    本地调试控制台将打开。

v2.0.x

打开本地调试控制台

（可选）要在开发计算机上查看本地调试控制台，可以通过 SSH 转发控制台的端口。但您必须先启用AllowTcpForwarding选项位于核心设备的 SSH 配置文件中。默认情况下，此选项处于启用状态。在开发计算机上运行以下命令，查看控制面板localhost:1441在开发计算机上。
```
ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address
```
注意
您可以更改默认端口1441和1442. 有关更多信息，请参阅。本地调试控制台配置.
创建会话以使用本地调试控制台。创建会话时，会生成用于进行身份验证的密码。本地调试控制台需要密码才能提高安全性，因为您可以使用此组件在核心设备上查看重要信息并执行操作。

使用Amazon IoT GreengrassCLI。此命令会生成一个 43 个字符的随机密码，该密码将在 8 小时后过期。Replace/greengrass/v2要么C:\greengrass\v2还有通往Amazon IoT Greengrass V2根文件夹。
Linux or UnixWindows
Linux or Unix
```
sudo /greengrass/v2/bin/greengrass-cli get-debug-password
```
Windows
```
C:\greengrass\v2\bin\greengrass-cli get-debug-password
```
命令输出类似于以下示例。
```
Username: debug
Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE
Password will expire at: 2021-04-01T17:01:43.921999931-07:00
```
debug view 组件创建的会话持续 4 小时，然后您必须生成新密码才能再次查看本地调试控制台。
打开http://localhost:1441在核心设备上，或者如果您通过 SSH 转发端口，请在开发计算机上将其打开。
使用用户名和密码登录网站get-debug-password命令先前已打印。

本地调试控制台将打开。

本地日志文件

此组件使用的日志文件与Greengrass组件。

查看此组件的日志

在核心设备上运行以下命令以实时查看该组件的日志文件。Replace/greengrass/v2要么C:\greengrass\v2还有通往Amazon IoT Greengrass根文件夹。
Linux
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
Windows (PowerShell)
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```

更改日志

下表介绍了组件各个版本的更改。

Version	更改
2.2.5	版本已更新为Greengrass 核心版本 2.7.0。
2.2.4	版本已更新为Greengrass 核心版本 2.6.0。
2.2.3	错误修复和改进修复了在组件无法解密持有 SSL 私钥的密钥库时阻止启动的问题。版本已更新为Greengrass 核心版本 2.5.0。
2.2.2	版本已更新为Greengrass 核心版本 2.4.0。
2.2.1	版本已更新为Greengrass 核心版本 2.3.0。
2.2.0	版本已更新为Greengrass 核心版本 2.2.2.2.0。
2.1.0	新功能使用 HTTPS 保护与本地调试控制台的连接。默认情况下，HTTPTPS 已启用。错误修复和改进您可以在配置编辑器中关闭闪存栏消息。
2.0.3	初始版本。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

传统订阅 Router

日志管理器